Elastic Compute Service:Terraform リファレンス

Terraform の基本機能

Terraform は、IT インフラストラクチャの自動オーケストレーションをサポートするツールです。 Terraform を使用すると、コードを使用して IT リソースを管理および保守できます。 詳細については、「Terraform とは」をご参照ください。

• Terraform は、使いやすい CLI を提供します。この CLI を使用すると、Alibaba Cloud またはサードパーティクラウドに構成ファイルをデプロイし、構成ファイルのバージョンを管理できます。 Terraform を使用すると、構成ファイルでクラウドトポロジを構築するために必要なインフラストラクチャリソースを定義できます。 リソースには、仮想マシン（VM）、ストレージアカウント、ネットワークインターフェースなどが含まれます。

• Terraform は、Alibaba Cloud プロバイダーと統合して、新しいインフラストラクチャをサポートできます。 テンプレートを使用して Alibaba Cloud プロバイダーを構成し、Alibaba Cloud 上でクラウドインフラストラクチャを定義、プレビュー、およびデプロイできます。

• Terraform を使用して、複数の Alibaba Cloud サービスのリソースを作成、変更、および削除できます。

Alibaba Cloud サービスと Terraform の統合方法については、Alibaba Cloud プロバイダー を参照してください。

Terraform のインストール

terraform

echo $PATH

mv ~/Downloads/terraform /usr/local/bin/

git clone https://github.com/hashicorp/terraform.git

cd terraform

go install

echo $PATH

mv ~/Downloads/terraform /usr/local/bin/

brew tap hashicorp/tap

brew install hashicorp/tap/terraform

brew update

brew upgrade hashicorp/tap/terraform

yum install -y dnf-plugin-releasever-adapter
yum-config-manager --add-repo https://rpm.releases.hashicorp.com/RHEL/hashicorp.repo
yum install terraform

choco install terraform

Terraform の認証

特定の環境変数にアクセス認証情報を保存し、その環境変数を使用して Terraform を認証できます。 Terraform コマンドを実行する際に、構成テンプレートでアクセス認証情報が明示的に宣言されていない場合、Terraform は環境変数からアクセス認証情報を取得できます。 オペレーティングシステムに基づいて環境変数を構成します。

# Access Key Id
$ export ALICLOUD_ACCESS_KEY="<Your AccessKey ID>" // アクセスキー ID
# Access Key Secret
$ export ALICLOUD_SECRET_KEY="<Your AccessKey secret>" // アクセスキーシークレット
# If you use an STS token, set the ALICLOUD_SECURITY_TOKEN environment variable to the STS token.
$ export ALICLOUD_SECURITY_TOKEN="<Your STS token>" // STS トークンを使用する場合は、ALICLOUD_SECURITY_TOKEN 環境変数を STS トークンに設定します。

環境変数を構成した後、アクセス認証情報を明示的に宣言する必要はありません。または、構成テンプレートのプロバイダーコードブロックでリージョン ID のみ宣言できます。

provider "alicloud" {
  region = "cn-hangzhou"
}

ALICLOUD_REGION 環境変数を使用してリージョン ID を指定することもできます。 リージョン ID が宣言されておらず、 ALICLOUD_REGION 環境変数が構成されていない場合は、リージョンパラメーターの値として cn-beijing が使用されます。

サポートされているリソース

Terraform を使用して ECS リソースを作成および管理する

このセクションでは、Terraform を使用して ECS インスタンスを作成する方法について説明します。

1. 作業ディレクトリと、そのディレクトリに main.tf という名前の構成ファイルを作成します。次のコードは、ECS インスタンスと、ECS インスタンスの作成に必要な VPC（Virtual Private Cloud）、セキュリティグループ、および vSwitch を作成するために使用されます。次のコードを main.tf 構成ファイルにコピーします。

   # Alibaba Cloud リージョンを表す region という名前の変数を定義します。この変数のデフォルト値は cn-beijing です。
   variable "region"{
     default = "cn-beijing"
   }
   
   # Alibaba Cloud プロバイダーを構成し、region 変数で定義されたリージョンを指定します。
   provider "alicloud"{
     region = var.region
   }
   
   # ECS インスタンスタイプを表す instance_type という名前の文字列変数を定義します。この変数のデフォルト値は ecs.e-c1m1.large です。
   variable "instance_type" {
     type    = string
     default = "ecs.e-c1m1.large"
   }
   
   # データソースを使用して、指定されたインスタンスタイプ、リソースタイプ（vSwitch など）、およびディスクカテゴリをフィルターとして構成し、ECS インスタンスを作成できるゾーンをクエリします。
   data "alicloud_zones" "default" {
     available_instance_type     = var.instance_type
     available_resource_creation = "VSwitch"
     available_disk_category     = "cloud_essd"
   }
   
   # VPC に関連付ける CIDR ブロックを表す vpc_cidr_block という名前の変数を定義します。この変数のデフォルト値は 172.16.0.0/16 です。
   variable "vpc_cidr_block" {
     default = "172.16.0.0/16"
   }
   
   # vSwitch に関連付ける CIDR ブロックを表す vsw_cidr_block という名前の変数を定義します。この変数のデフォルト値は 172.16.0.0/24 です。
   variable "vsw_cidr_block" {
     default = "172.16.0.0/24"
   }
   
   # 特定のリソース名の一意性を確保するために、10000 から 99999 までのランダムな整数を生成します。
   resource "random_integer" "default" {
     min = 10000
     max = 99999
   }
   
   # vpc-test という名前の VPC を作成し、ランダムな整数を使用して名前の一意性を確保します。
   resource "alicloud_vpc" "vpc" {
     vpc_name   = "vpc-test_${random_integer.default.result}"
     cidr_block = var.vpc_cidr_block
   }
   
   # 作成された VPC にセキュリティグループを作成し、ランダムな整数を使用してセキュリティグループ名の一意性を確保します。
   resource "alicloud_security_group" "group" {
     security_group_name = "test_${random_integer.default.result}"  # test_$ を実際の値に置き換えます。
     vpc_id              = alicloud_vpc.vpc.id
   }
   
   # 作成されたセキュリティグループ内のすべての TCP トラフィックを許可するセキュリティグループのインバウンドルールを作成します。
   resource "alicloud_security_group_rule" "allow_all_tcp" {
     type              = "ingress"
     ip_protocol       = "tcp"
     nic_type          = "intranet"  # nic_type パラメーターを 'intranet' に設定します。
     policy            = "accept"
     port_range        = "1/65535"
     priority          = 1
     security_group_id = alicloud_security_group.group.id
     cidr_ip           = "0.0.0.0/0"
   }
   
   # 指定されたゾーンと作成された VPC に vSwitch を作成し、ランダムな整数を使用して vSwitch 名の一意性を確保します。
   resource "alicloud_vswitch" "vswitch" {
     vpc_id       = alicloud_vpc.vpc.id
     cidr_block   = var.vsw_cidr_block
     zone_id      = data.alicloud_zones.default.zones[0].id
     vswitch_name = "vswitch-test-${random_integer.default.result}"
   }
   
   # ゾーン、セキュリティグループ、インスタンスタイプなどの複数のパラメーターを指定して ECS インスタンスを作成し、ランダムな整数を使用してインスタンス名の一意性を確保します。
   resource "alicloud_instance" "instance" {
     availability_zone          = data.alicloud_zones.default.zones[0].id
     security_groups            = [alicloud_security_group.group.id]
     instance_type              = var.instance_type
     system_disk_category       = "cloud_essd"
     system_disk_name           = "test_foo_system_disk_${random_integer.default.result}"
     system_disk_description    = "test_foo_system_disk_description"
     image_id                   = "aliyun_2_1903_x64_20G_alibase_20240628.vhd"
     instance_name              = "test_ecs_${random_integer.default.result}"
     vswitch_id                 = alicloud_vswitch.vswitch.id
     internet_max_bandwidth_out = 10
     password                   = "Terraform@Example" # ECS インスタンスのパスワードを構成します。Terraform@Example を実際の値に置き換えます。
   }

2. Terraform ランタイム環境を初期化するには、次のコマンドを実行します。

   terraform init

   次のコマンド出力は、Terraform が初期化されたことを示しています。

   Terraform has been successfully initialized!
   
   You may now begin working with Terraform. Try running "terraform plan" to see
   any changes that are required for your infrastructure. All Terraform commands
   should now work.
   
   If you ever set or change modules or backend configuration for Terraform,
   rerun this command to reinitialize your working directory. If you forget, other
   commands will detect it and remind you to do so if necessary.

3. コードを実行するには、次のコマンドを実行します。

   terraform apply

   コードの実行中に、プロンプトが表示されたら yes と入力し、[enter] キーを押します。実行が完了するまで待ちます。次のコマンド出力は、コードが実行されたことを示しています。

   You can apply this plan to save these new output values to the Terraform state, without changing any real infrastructure.
   
   Do you want to perform these actions?
     Terraform will perform the actions described above.
     Only 'yes' will be accepted to approve.
   
     Enter a value: yes
   
   
   Apply complete!  Resources: 6 added, 0 changed, 0 destroyed.

4. 結果を確認します。

terraform show

参考資料

• Terraform のユースケースについては、「ベストプラクティス」をご参照ください。

• 一般的な Terraform コマンドについては、「一般的なコマンド」をご参照ください。

• Terraform は ROS でマネージドサービスとして利用できます。 ROS コンソール で Terraform テンプレートをデプロイできます。詳細については、「Terraform スタックの作成」をご参照ください。