Cloud Firewall:Terraform を使用してアドレス帳を作成する

始める前に

• Alibaba Cloud アカウントは、アカウント内のリソースに対するすべての権限を持っています。 Alibaba Cloud アカウントが漏洩した場合、リソースは大きなリスクにさらされます。Resource Access Management (RAM) ユーザーを使用し、RAM ユーザーの AccessKey ペアを作成することをお勧めします。詳細については、「RAM ユーザーを作成する」および「AccessKey ペアを作成する」をご参照ください。

• 次のサンプルコードは、Cloud Firewall に必要な権限を RAM ユーザーに付与するポリシーを提供します。詳細については、「RAM ユーザーに権限を付与する」をご参照ください。

  {
      "Version": "1",
      "Statement": [
          {
              "Effect": "Allow",
              "Action": [
                  "yundun-cloudfirewall:*",
                  "yundun-ndr:*"
              ],
              "Resource": "*"
          }
      ]
  }

• Terraform 環境を準備します。Terraform を使用するには、次のいずれかの方法を使用できます。

  Terraform Explorer で Terraform を使用する: Alibaba Cloud は、Terraform のオンラインランタイム環境である Terraform Explorer を提供しています。 Terraform をインストールする必要なく、Terraform Explorer にログインした後に Terraform を使用できます。詳細については、「Terraform Explorer で Terraform を使用する」をご参照ください。この方法は、追加費用なしで Terraform を迅速かつ便利に使用およびデバッグしたい場合に適しています。

  Cloud Shell で Terraform を使用する: Terraform は Cloud Shell にプリインストールされており、ID 資格情報は構成されています。 Cloud Shell で Terraform コマンドを直接実行できます。詳細については、「Cloud Shell で Terraform を使用する」をご参照ください。この方法は、低コストで Terraform を迅速かつ便利に使用およびデバッグしたい場合に適しています。

  オンプレミスマシンに Terraform をインストールして構成する: この方法は、ネットワークの状態が悪い場合やカスタム開発環境を使用する場合に適しています。詳細については、「ローカル PC に Terraform をインストールして構成する」をご参照ください。

  重要

  Terraform 0.12.28 以降をインストールする必要があります。 terraform --version コマンドを実行して、Terraform のバージョンをクエリできます。

リソース

alicloud_cloud_firewall_address_book: Cloud Firewall にアドレス帳を作成します。

このセクションでは、アドレス帳を作成する方法について説明します。

1. 作業ディレクトリと、main.tf という名前の構成ファイルを作成します。 main.tf は Terraform のメインファイルであり、デプロイするリソースを定義します。

   resource "alicloud_cloud_firewall_address_book" "example" {
     # 説明。
     description      = "Created_by_terraform"
     # アドレス帳の名前。
     group_name       = "IPListExample"
     # アドレス帳のタイプ。有効な値: ip、ipv6、domain、port、および tag。
     group_type       = "ip"
     # アドレス。
     address_list     = ["192.0.X.X/32", "192.0.X.X/32"]
   }

2. 次のコマンドを実行して、Terraform を初期化します。

   terraform init

   次の情報が返された場合、Terraform は初期化されています。

   Initializing provider plugins...
   - Finding latest version of hashicorp/alicloud...
   - Installing hashicorp/alicloud v1.231.0...
   - Installed hashicorp/alicloud v1.231.0 (signed by HashiCorp)
   
   Terraform has created a lock file .terraform.lock.hcl to record the provider
   selections it made above. Include this file in your version control repository
   so that Terraform can guarantee to make the same selections by default when
   you run "terraform init" in the future.
   
   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 plan

4. 次のコマンドを実行して、VPC ファイアウォールを作成します。

   terraform apply

   実行中に、プロンプトが表示されたら yes と入力し、[Enter] キーを押します。コマンドが正常に実行されるまで待ちます。次の情報が表示された場合、操作は成功です。

   Plan: 1 to add, 0 to change, 0 to destroy.
   
   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
   
   alicloud_cloud_firewall_address_book.example: Creating...
   alicloud_cloud_firewall_address_book.example: Creation complete after 1s [id=d41518ef-0437-44e9-9dd6-86d62f3d0***]
   
   Apply complete!  Resources: 1 added, 0 changed, 0 destroyed.

5. 結果を確認します。

   terraform show コマンドを実行する

   次のコマンドを実行して、作成されたアドレス帳の詳細を表示できます。

   terraform show

   # alicloud_cloud_firewall_address_book.example:
   resource "alicloud_cloud_firewall_address_book" "example" {
       address_list     = [
           "192.0.X.X/32",
           "192.0.X.X/32",
       ]
       auto_add_tag_ecs = 0
       description      = "Created_by_terraform"
       group_name       = "IPListExample"
       group_type       = "ip"
       id               = "d41518ef-0437-44e9-9dd6-86d62f3d****"
   }

   Cloud Firewall コンソールにログインする

   Cloud Firewall コンソール にログインします。 [防御構成] > [アドレス帳] ページに移動します。 [アドレス帳] ページで、アドレス帳の名前を使用してアドレス帳を検索し、アドレス帳の詳細を表示します。

リソースの解放

Terraform を使用して作成または管理された上記のリソースが不要になった場合は、次のコマンドを実行してリソースを解放します。 terraform destroy コマンドの詳細については、「共通コマンド」をご参照ください。

terraform destroy

resource "alicloud_cloud_firewall_address_book" "example" {
  # 説明。
  description      = "Created_by_terraform"
  # アドレス帳の名前。
  group_name       = "IPListExample"
  # アドレス帳のタイプ。有効な値: ip、ipv6、domain、port、および tag。
  group_type       = "ip"
  # アドレス。
  address_list     = ["192.0.2.1/32", "192.0.2.2/32"]
}