ステップ 1. Terraform CLI のインストール

Terraform CLI をインストールするには、以下のステップを実行します。

1. ローカル・マシンに terraform フォルダーを作成し、terraform フォルダーにナビゲートします。

   mkdir terraform && cd terraform
   

2. 希望する Terraform バージョンをダウンロードします。

   Terraform 用 IBM Cloud Provider プラグインのサポート対象バージョンについて詳しくは、「Terraform CLI のインストール」を参照してください。

   例えば、MacOS の場合は terraform_0.15.5_darwin_amd64.zip をダウンロードします。

3. Terraform zip ファイルを解凍し、使用している terraform ディレクトリーにファイルをコピーします。

4. PATH 環境変数にご使用の Terraform ファイルを設定します。

   export PATH=$PATH:<terraform-directory>/terraform
   

5. terraform コマンドを使用して、正常にインストールされたことを確認します。

   ./terraform
   

詳しくは、『Terraform CLI のインストール』を参照してください。

ステップ 2 IBM Cloud プロバイダー・プラグインのセットアップ

Terraform CLI のインストールが完了したら、IBM Cloud でリソースとサービスの使用を開始できるように Terraform 用の IBM Cloud Provider プラグインをセットアップする必要があります。 サポート対象のバージョンについては 、 IBM Cloud プロバイダープラグインのリリース情報をご覧ください。

IBM Cloud Provider プラグインのセットアップは、使用する Terraform CLI のバージョンによって異なります。 Terraform バージョン 0.13.x 以上を使用して Terraform 構成ファイルを実行する場合は、Terraform 用の IBM Cloud Provider プラグインのインストールは必要ありません。 詳しくは、Terraform v0.13.x 以上を参照してください。

例えば、Terraform バージョン 0.13.x 以上を使用して Terraform 構成ファイルを実行するには、以下のステップを実行します。

1. versions.tf ファイルを作成し、使用する IBM Cloud Provider プラグインのバージョンを version パラメーターで指定します。

   terraform {
       required_providers {
           ibm = {
               source = "IBM-Cloud/ibm"
               version = "<provider version>"
               }
       }
   }
   

   以下に例を示します。

   terraform {
       required_version = ">= 0.15"
       required_providers {
           ibm = {
               source = "ibm-cloud/ibm"
               version = "~>1.33.0"
           }
       }
   }
   

2. versions.tf ファイルを Git リポジトリーまたは Terraform がセットアップされたフォルダーに保管します。

Terraform on IBM Cloud モジュールを使用している場合は、すべてのモジュール・フォルダーに versions.tf ファイルを追加する必要があります。 Terraformプロバイダーブロックは プロバイダーレジストリから参照できます。 IBM Cloud Observability - Terraform Module モジュールを使用してインスタンスを構成できます。

ステップ 3。 IBM Cloud プロバイダー・プラグインの構成

セットアップを完了したら、IBM Cloud Provider プラグインを構成する必要があります。

Terraform on IBM Cloud を使用して作業を始める前に、Terraform リソースまたはデータ・ソースに必要な資格情報やパラメーターを取得し、provider 構成でそれらを指定する必要があります。 この構成は、IBM Cloud プラットフォームで認証を行うとき、および IBM Cloud のリソースとサービスを表示、作成、更新、または削除するときに IBM Cloud Provider プラグインによって使用されます。

次の表は、Terraform on IBM Cloud 構成ファイルの provider ブロックで設定できる入力パラメーターをリストしたものです。

環境変数の使用方法について詳しくは、環境変数の使用を参照してください。

同じ Terraform on IBM Cloud 構成ファイル内に複数のプロバイダー構成を追加して、異なるプロバイダー・パラメーターで IBM Cloud リソースを作成することができます。 例えば、Terraform on IBM Cloud 構成ファイル内に複数のプロバイダーを追加することで、さまざまな入力パラメーター (異なるリージョン、ゾーン、インフラストラクチャー世代、アカウントなど) を使用して IBM Cloud リソースを作成できます。 詳細は 、「複数のプロバイダインスタンス 」を参照してください。

ステップ 4: Terraform CLI を初期設定します。

次に、Terraform CLI を初期化します。 以下のコマンドを実行します。

./terraform init

Terraform has been successfully initialized! というメッセージが表示されます。

ステップ 5. 変数ファイルの作成

ハードコーディング値を含める variables.tf という変数ファイルを作成します。

以下のサンプルは、インスタンスをプロビジョンするときに使用できる変数をリストしたものです。

variable "service_type" {
  description = "Type of resource instance"
  type = string
  default = "sysdig-monitor"
}

variable "plan" {
  description = "Type of service plan."
  type = string
  default = "graduated-tier"
}

variable "default_receiver" {
  description = "Flag to select the instance to collect platform metrics"
  type = bool
  default = false
}

variable "location" {
  description = "Location where the resource is provisioned"
  type = string
  default = "us-south"
}

variable "name" {
  description = "Name of the resource instance"
  type = string
  default = "demo-monitoring-tf-instance"
}

variable "resource_group_name" {
  description = "Name of the resource group associated with the instance"
  type = string
  default = "observability-demo"
}

variable "key_name" {
  description = "Name of the resource key associated with the instance"
  type = string
  default = "demo-monitoring-tf-instance-key"
}

variable "wp_crn" {
  description = "CRN of rhe IBM Cloud Security and Compliance Center Workload Protection instance to be connected"
  type = string
  default = "crn:v1:bluemix:public:sysdig-secure:us-south:a/11111111111111111111111111111111:11111111-1111-1111-1111-111111111111"
}

有効な plan 値のリストについては、プランを参照してください。

有効なリージョンのリストについては、リージョンとエンドポイントを参照してください。

ステップ 6. Terraform 構成ファイルの作成

次に、main.tf という名前の Terraform 構成ファイルを作成します。 このファイルでは、HashiCorp 構成言語 (HCL) を使用することにより、Monitoring インスタンスを作成し、Identity and Access Management (IAM) でユーザーにアクセス・ポリシーを割り当てるための構成を追加します。 詳細については 、Terraformのドキュメントを参照してください。

以下のコードは、インスタンスをプロビジョンするための構成ファイルのサンプルです。 デフォルトのリソース・グループの ID を取得するには、ibm_resource_group データ・ソースを使用します。 リージョンは、手順 1 で作成した terraform.tfvars ファイルから取得されます。 次に、ユーザー user@ibm.com には、特定のリージョンの名前空間の IAM アクセス・ポリシーでマネージャーの役割が割り当てられます。 Monitoring インスタンスは、既存の Workload Protection インスタンスにも接続されています。

Monitoring インスタンスを既存の Workload Protection インスタンスに接続することはオプションです。

data "ibm_resource_group" "group" {
    name = var.resource_group_name
  }

  locals {
    instance_name = "${var.name}-${var.location}"
  }

  // Create a monitoring instance

  resource "ibm_resource_instance" "resource_instance" {
    name = local.instance_name
    service = var.service_type
    plan = var.plan
    location = var.location
    resource_group_id = data.ibm_resource_group.group.id
    tags = ["monitoring", "public"]
    parameters = {
      default_receiver= var.default_receiver,
      workload_protection_connected_instance = var.wp_crn
    }
  }

  // Create the resource key that is associated with the Monitoring instance

  resource "ibm_resource_key" "resourceKey" {
    name = var.key_name
    role = "Manager"
    resource_instance_id = ibm_resource_instance.instance.id
  }

  // Add a user policy for using the resource instance

  resource "ibm_iam_user_policy" "policy" {
    ibm_id = "user@ibm.com"
    roles  = ["Manager", "Viewer"]

    resources {
      service = "sysdig-monitor"
      resource_instance_id = element(split(":", ibm_resource_instance.instance.id), 7)
    }
  }

IBM Cloud リソースに Terraform を使用する方法の追加情報については、以下を参照してください。

• ibm_resource_instance
• ibm_resource_key
• ibm_iam_service_policy

手順 7. リソースのプロビジョン

以下のステップを実行します。

1. Terraform CLI を初期設定します。

   ./terraform init
   

2. Terraform 実行プランを作成します。 Terraform 実行プランとは、アカウントに Monitoring インスタンス、リソース・キー、および IAM アクセス・ポリシーを作成するために実行する必要のあるすべてのアクションをまとめたものです。

   ./terraform plan
   

3. リソースを作成します。

   ./terraform apply
   

   リソースを削除するには、./terraform destroy を実行します。

次のステップ

リソースが作成されたことを確認します。

• 「プログラム識別情報」 UI を起動し、インスタンスが作成されたことを確認します。
• Access(IAM)の起動。 **「サービス ID」**を選択し、リソース・キーを探します。
• ユーザーに割り当てられたアクセス権限をコンソールで確認します。