前提条件

• 作業を開始する前に、 IBM Cloud Logs リソースを作成および操作するために 必要なアクセス権を持って いることを確認してください。
• Terraform CLIをインストールする。

IBM Cloud プロバイダー・プラグインの構成

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

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

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

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

ibmcloud_api_key = "<ibmcloud_api_key>"
region = "region"
account_id = "<Account ID>"
rg_id = "d7c0e937c529461f90a19e1421f9746d"
plan = "standard"
cos_instance_crn = "crn:v1:bluemix:public:cloud-object-storage:global:a/<Account ID>:<COS instance ID>::"
cos_storage_class = "standard"
cos_bucket_data_name = "cloud-logs-tf-data"
cos_bucket_metrics_name = "cloud-logs-tf-metrics"
event_notifications_crn = "crn:v1:bluemix:public:event-notifications:eu-gb:a/<Account ID>:<Event Notifications instance ID>::"
event_notifications_instance_id = "<Event Notifications instance ID>"
event_notifications_region = "eu-gb"

variable "ibm_region" {
  description = "Region to create resources. To see the list of valid regions, see https://cloud.ibm.com/docs/cloud-logs?topic=cloud-logs-regions."
  type        = string
  default     = "eu-gb"
}

variable "resource_group_name" {
  type        = string
  description = "Resource group where resources are created"
  default     = "Default"
}


variable "rg_id" {
  type        = string
  description = "Resource group ID where resources are created"
  default     = "b302120431c4456097f8970d80b93dfb"
}

variable "plan" {
  type        = string
  description = "Service plan for Cloud Logs instances"
  default     = "standard"
}

variable "cos_instance_crn" {
  type        = string
  description = "COS instance CRN where buckets are created"
  default     = "crn:v1:bluemix:public:cloud-object-storage:global:a/<Account ID>:<COS instance ID>::"
}

variable "cos_storage_class" {
  type        = string
  description = "COS instance storage class"
  default     = "standard"
}

variable "account_id" {
  type        = string
  description = "Account where resources are created"
  default     = "<Account ID>"
}

variable "cos_bucket_data_name" {
  type        = string
  description = "Cloud Object Storage bucket data name"
  default     = "cloud-logs-tf-data"
}

variable "cos_bucket_metrics_name" {
  type        = string
  description = "Cloud Object Storage bucket data name"
  default     = "cloud-logs-tf-metrics"
}

variable "event_notifications_crn" {
  type        = string
  description = "Event Notifications CRN"
  default     = "crn:v1:bluemix:public:event-notifications:eu-gb:a/<Account ID>:<Event Notifications Instance ID>::"
}

variable "event_notifications_instance_id" {
  type        = string
  description = "Event Notifications instance ID"
  default     = "<Event Notifications Instance ID>"
}

variable "event_notifications_region" {
  type        = string
  description = "Event notifications region"
  default     = "eu-gb"
}

variable "ibmcloud_api_key" {}
variable "region" {}

provider "ibm" {
  ibmcloud_api_key    = var.ibmcloud_api_key
  region = var.region
}

のインスタンスをプロビジョニングするためのTerraform設定ファイルを作成する。 IBM Cloud Logs

次に、以下のファイルを作成する：

• data-bucket.tf:ログデータを保存するバケットを作成するためのTerraformリソース定義が含まれています。

  resource "ibm_cos_bucket" "data_bucket" {
  	      bucket_name          = var.cos_bucket_data_name
    	resource_instance_id = var.cos_instance_crn
    	region_location      = var.region
  	    storage_class        = var.cos_storage_class
  }
  

• metrics-bucket.tf:ログデータから収集したメトリクスを保存するバケットを作成するためのTerraformリソース定義が含まれています。

  resource "ibm_cos_bucket" "metrics_bucket" {
  	      bucket_name          = var.cos_bucket_metrics_name
    	resource_instance_id = var.cos_instance_crn
  	    region_location      = var.region
    	storage_class        = var.cos_storage_class
  }
  

• main.tf: IBM Cloud Logs インスタンスを作成し、データバケットとメトリクスバケットをアタッチするための Terraform リソース定義が含まれています。

  data "ibm_resource_group" "group" {
    name = "marisa"
  }
  
  resource "ibm_resource_instance" "cloud_logs_instance" {
    name              = "cloud-logs-via-tf"
    service           = "logs"
    plan              = var.plan
    location          = var.region
    resource_group_id = data.ibm_resource_group.group.id
  
    parameters = {
      retention_period = "7"
    }
  
  }
  
  resource "null_resource" "update_instance_parameters" {
    triggers = {
      instance_id = ibm_resource_instance.cloud_logs_instance.id
    }
  
    provisioner "local-exec" {
      command = <<EOT
        ibmcloud login --apikey=$IC_API_KEY
        ibmcloud resource service-instance-update ${ibm_resource_instance.cloud_logs_instance.guid} -p '{"logs_bucket_crn": "${ibm_cos_bucket.data_bucket.crn}", "logs_bucket_endpoint": "${ibm_cos_bucket.data_bucket.s3_endpoint_direct}", "metrics_bucket_crn": "${ibm_cos_bucket.metrics_bucket.crn}","metrics_bucket_endpoint": "${ibm_cos_bucket.metrics_bucket.s3_endpoint_direct}"}'
      EOT
    }
    depends_on = [ibm_iam_authorization_policy.policy-cl-data-bucket,ibm_iam_authorization_policy.policy-cl-metrics-bucket]
  }
  

• en_s2s.tf: IBM Cloud Logs インスタンスとバケット間の認証サービスを作成するための Terraform リソース定義が含まれます。

  locals {
  	  cos_instance_id = split(":", ibm_cos_bucket.data_bucket.resource_instance_id)[7]
  }
  
  resource "ibm_iam_authorization_policy" "policy-cl-data-bucket" {
      source_service_name         = "logs"
  	    source_resource_instance_id = ibm_resource_instance.cloud_logs_instance.guid
  	    roles                       = ["Writer"]
  
      resource_attributes {
  	          name  = "serviceName"
  	      value = "cloud-object-storage"
      }
  
      resource_attributes {
  	 	        name  = "serviceInstance"
  	 	        value = local.cos_instance_id
  	 	        operator = "stringEquals"
      }
  
      resource_attributes {
  		        name = "resourceType"
  		        value = "bucket"
  		        operator = "stringEquals"
  	      }
  
      resource_attributes {
  	 	        name  = "resource"
  	      	  value = ibm_cos_bucket.data_bucket.bucket_name
  	 	        operator = "stringEquals"
      }
  
  	      resource_attributes {
  		        name  = "accountId"
  		        value = var.account_id
  	      }
  }
  
  resource "ibm_iam_authorization_policy" "policy-cl-metrics-bucket" {
  	    source_service_name         = "logs"
  	    source_resource_instance_id = ibm_resource_instance.cloud_logs_instance.guid
  	    roles                       = ["Writer"]
  
  
      resource_attributes {
  	        name  = "serviceName"
  	        value = "cloud-object-storage"
      }
  
      resource_attributes {
  	        name  = "serviceInstance"
  	 	      value = local.cos_instance_id
  	 	      operator = "stringEquals"
      }
  
      resource_attributes {
  		      name = "resourceType"
  		      value = "bucket"
  		      operator = "stringEquals"
  	      }
  
      resource_attributes {
  	 	      name  = "resource"
  	 	      value = ibm_cos_bucket.metrics_bucket.bucket_name
  	 	      operator = "stringEquals"
      }
  
      resource_attributes {
  		      name  = "accountId"
  		      value = var.account_id
  	      }
  }
  

• event-notification-extension.tf: IBM Cloud Logs インスタンスと IBM Cloud Event Notifications インスタンス間のアウトバウンドインテグレーションを作成するための Terraform リソース定義が含まれています。

  resource "ibm_logs_outgoing_webhook" "logs_outgoing_webhook_instance" {
  	    instance_id               = ibm_resource_instance.cloud_logs_instance.guid
  	    region                    = ibm_resource_instance.cloud_logs_instance.location
  	    name        			  = "Event-notification-cloud-logs-instance"
  	    type                      = "ibm_event_notifications"
  	    ibm_event_notifications {
  	    event_notifications_instance_id = var.event_notifications_instance_id
   	    region_id                       = var.event_notifications_region
  	    }
  	    depends_on = [ibm_iam_authorization_policy.policy-event-notifications]
  }
  

• s2s.tf: IBM Cloud Logs インスタンスと IBM Cloud Event Notifications インスタンス間の認可を作成するための Terraform リソース定義を含む。

  resource "ibm_iam_authorization_policy" "policy-event-notifications" {
  	    source_service_name = "logs"
  	    source_resource_instance_id = ibm_resource_instance.cloud_logs_instance.guid
  	    roles               = ["Reader","Event Source Manager","Viewer"]
  	    description         = ""
  	    target_service_name = "event-notifications"
  }
  

IBM Cloud リソースに Terraform を使う方法についての追加情報は、 ibm _resource_instance を参照してください

リソースのプロビジョン

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

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

   ../terraform init
   

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

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

   ../terraform plan
   

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

   ../terraform apply
   

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

次のステップ

リソースが作成されたことを確認します。 Observability UIを起動 し、インスタンスが作成されていることを確認する。

すべてのモジュールについて、生産可能な構成を検討することができます：

• Terraform IBM モジュール(TIM)GitHub リポジトリ
• Terraform IBM モジュール(TIM)レジストリ