전제조건

• 시작하기 전에 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
}

테라폼 구성 파일을 생성하여 다음 인스턴스를 프로비저닝합니다 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 인스턴스 간에 아웃바운드 통합을 생성하여 Slack 또는 이메일 등의 대상에게 알림을 보내는 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 인스턴스 간의 권한을 생성하기 위한 테라폼 리소스 정의를 포함합니다.

  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)레지스트리