先決條件

• 在開始之前，請確定您擁有建立和使用 IBM Cloud Logs 資源 所需的存取權限。
• 安裝 Terraform CLI。

配置 IBM Cloud 提供者外掛程式

完成設定之後，您必須 配置 IBM Cloud 提供者外掛程式。

您必須先擷取 Terraform 資源或資料來源所需的認證和參數，並在 provider 配置中指定它們，然後才能在 IBM Cloud上開始使用 Terraform。 IBM Cloud 提供者外掛程式使用此配置向 IBM Cloud 平台進行鑑別，以及檢視、建立、更新或刪除 IBM Cloud 資源和服務。

下表列出您可以在 IBM Cloud 配置檔上 Terraform 的 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:包含 Terraform 資源定義，用於建立 IBM Cloud Logs 實例，並附加資料桶和度量資料桶。

  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:包含 Terraform 資源定義，用於在 IBM Cloud Logs 實例和儲存桶之間建立服務對服務授權。

  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:包含 Terraform 資源定義，用於在 IBM Cloud Logs 實例和 IBM Cloud Event Notifications 實例之間建立向外整合，您可透過該整合將通知傳送至您的目的地，例如 Slack 或電子郵件。

  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:包含 Terraform 資源定義，用於建立 IBM Cloud Logs 與 IBM Cloud Event Notifications 之間的授權。

  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"
  }
  

有關如何使用 Terraform 來取得 IBM Cloud 資源的其他資訊，請參閱 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)註冊表