先决条件

• 在开始之前，请确保您拥有创建和使用 IBM Cloud Logs 资源 所需的权限。
• 安装 Terraform CLI。

配置 IBM Cloud 提供者插件

完成设置后，必须 配置 IBM Cloud 提供程序插件。

在 IBM Cloud上开始使用 Terraform 之前，必须检索 Terraform 资源或数据源所需的凭证和参数，并在 provider 配置中指定这些凭证和参数。 此配置由 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)注册表