最終更新日: 2026年3月5日

概要

Terraform ConoHa VPS Providerは、HashiCorpのインフラ構成管理ツール Terraform を使用して ConoHa VPS 上のリソースをコードで管理できるようにするプラグイン(プロバイダ)です。Infrastructure as Code(IaC)のアプローチにより、サーバーやネットワークリソースの作成・変更・削除を宣言的な設定ファイルで一元管理できます。

現在ベータ版として公開されており、サーバー、SSHキーペア、ボリューム、セキュリティグループ、セキュリティグループルールの管理に対応しています。

重要

本プロバイダは現在ベータ版です。機能や動作が予告なく変更される場合があります。本番環境での使用前には十分なテストを行ってください。

重要

本プロバイダはConoHa VPS(Ver.3.0)のみ対応しています。ConoHa VPS(Ver.2.0)では使用できません。

メモ

本プロバイダはConoHa VPS APIユーザーの認証情報を使用します。事前にコントロールパネルからAPIユーザーを作成してください。また、現在のベータ版ではデータソースは提供されていません。リソース作成に必要なパラメータは公開API(ConoHa VPS Ver.3.0)より取得してください。

仕様

主要ソフトウェア

ソフトウェア名 バージョン ライセンス 用途
Terraform ConoHa VPS Provider 0.1.0 Apache License 2.0 ConoHa VPSリソースのTerraform管理プラグイン
Terraform 1.0以上 BUSL 1.1 インフラ構成管理ツール

対応リソース

リソースタイプ 説明
サーバー VPSサーバーインスタンスの作成・管理
SSHキーペア SSHキーペアの登録・管理
ボリューム ブートストレージ・追加ストレージボリュームの管理
セキュリティグループ ファイアウォールグループの管理
セキュリティグループルール ファイアウォールルールの管理

プロバイダ情報

項目 説明
プロバイダソースアドレス registry.terraform.io/providers/gmo-internet/conohavps
必要なTerraformバージョン 1.0以上
認証方式 APIユーザー(ユーザーID・パスワード・テナントID・リージョン・IDエンドポイント)。プロバイダ設定または環境変数で指定可能
データソース 未対応(ベータ版のため)

利用手順

重要

プロバイダの利用にはConoHa VPSのAPIユーザー認証情報が必要です。コントロールパネルであらかじめAPIユーザーを作成し、ユーザーID・パスワード・テナントID・リージョン情報を手元に用意してください。

Step 1: Terraformのインストール

Terraform公式サイトからバージョン1.0以上をインストールしてください。インストール確認は以下のコマンドで行います。

# terraform version

Step 2: プロバイダの設定

Terraform設定ファイル(main.tf等)にプロバイダのソースアドレスを宣言します。

terraform {
  required_providers {
    conohavps = {
      source = "gmo-internet/conohavps"
    }
  }
}

プロバイダブロックの設定方法(引数・環境変数・デフォルト値等)については、Terraform Registry ドキュメントまたはGitHubのdocs/index.mdを参照してください。

セキュリティ重要

APIユーザーの認証情報(ユーザーID・パスワード)は設定ファイルに直接記載せず、変数や環境変数を使用してください。設定ファイルをバージョン管理する場合は .gitignore で認証情報ファイルを除外することを強く推奨します。

Step 3: 初期化

以下のコマンドでプロバイダをダウンロード・初期化します。

# terraform init

Step 4: リソースの定義

管理するリソースを設定ファイルに記述します。利用可能なリソースタイプとパラメータの詳細は、Terraform Registry ドキュメントおよびConoHa VPS API リファレンスを参照してください。

Step 5: プランの確認と適用

変更内容を事前確認してからリソースを作成・更新します。

# terraform plan
# terraform apply
サイト名 URL 説明
GitHubリポジトリ https://github.com/gmo-internet/terraform-provider-conohavps ソースコード・イシュートラッカー・CHANGELOG
Terraform Registry ドキュメント https://registry.terraform.io/providers/gmo-internet/conohavps/latest/docs リソース・認証の詳細ドキュメント
ConoHa VPS API リファレンス https://doc.conoha.jp/reference/api-vps3 APIパラメータ(フレーバー・イメージID等)の参照
APIユーザー作成ガイド https://doc.conoha.jp/reference/api-vps3/api-cp-vps3/cp-create_api_user-v3/ コントロールパネルでのAPIユーザー作成手順
Terraform 公式サイト https://developer.hashicorp.com/terraform Terraform本体のドキュメント・インストール手順