最終更新日: 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本体のドキュメント・インストール手順 |