1단계. Terraform CLI 설치

Terraform CLI를 설치하려면 다음 단계를 완료하십시오.

1. 로컬 머신에서 terraform 폴더를 작성하고 terraform 폴더로 이동하십시오.

   mkdir terraform && cd terraform
   

2. 원하는 Terraform 버전을 다운로드하십시오. 예를 들어, MacOS의 경우 terraform_0.15.5_darwin_amd64.zip을 다운로드할 수 있습니다.

   Terraform용 IBM Cloud Provider 플러그인은 현재 Terraform 버전 0.12.x, 0.13.x 및 0.14.x만 지원합니다. 지원되는 Terraform 버전을 선택해야 합니다.

3. Terraform zip 파일을 추출하고 파일을 terraform 디렉토리에 복사하십시오.

4. 환경 PATH 변수를 Terraform 파일로 설정하십시오.

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

5. Verify that the installation is successful by using a terraform command.

   ./terraform
   

2단계. IBM Cloud 제공자 플러그인 설정

Terraform CLI 설치가 완료된 후에는 IBM Cloud에서 리소스 및 서비스에 대한 작업을 시작할 수 있도록 Terraform용 IBM Cloud 제공자 플러그인을 설정해야 합니다. 지원되는 버전 목록은 IBM Cloud 공급자 플러그인 릴리스를 참조하세요.

IBM Cloud 제공자 플러그인의 설정은 사용할 Terraform CLI 버전에 따라 다릅니다. Terraform 버전 0.13.x 이상에서 Terraform 구성 파일을 실행하려면 Terraform용 IBM Cloud 제공자 플러그인이 필요하지 않습니다. 자세한 정보는 Terraform v0.13.x 이상을 참조하십시오.

예를 들어, Terraform 버전 0.13.x 이상에서 Terraform 구성 파일을 실행하려면 다음 단계를 완료하십시오.

1. versions.tf 파일을 작성하고 version 매개변수와 함께 사용할 IBM Cloud 제공자 플러그인 버전을 지정하십시오.

   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.48.0-beta0"
           }
       }
   }
   

2. Git 저장소 또는 Terraform이 설정된 폴더에 versions.tf 파일을 저장하십시오.

IBM Cloud 모듈에서 Terraform을 사용하는 경우 versions.tf 파일을 모든 모듈 폴더에 추가해야 합니다. 공급자 레지스트리에서 Terraform 공급자 블록을 참조할 수 있습니다. Activity Tracker Event Routing 구성의 경우, 일반적인 IBM Cloud Activity Tracker Event Routing 구성을 위해 사전 빌드되고 테스트된 모듈을 제공하는 IBM Cloud Activity Tracker Event Routing 용 Terraform IBM 모듈을 사용할 수 있습니다.

3단계. IBM Cloud 제공자 플러그인 구성

설정을 완료한 후 IBM Cloud 제공자 플러그인을 구성해야 합니다.

IBM Cloud에서 Terraform에 대한 작업을 시작하려면 Terraform 리소스 또는 데이터 소스에 필요한 인증 정보 및 매개변수를 검색하고 provider 구성에서 이를 지정해야 합니다. 이 구성은 IBM Cloud 플랫폼을 인증하고 IBM Cloud 리소스 및 서비스를 보거나 작성하거나 업데이트하거나 삭제하기 위해 IBM Cloud 제공자 플러그인에서 사용합니다.

다음 표에는 IBM Cloud 구성 파일에서 Terraform의 provider 블록에서 설정할 수 있는 입력 매개변수가 나열되어 있습니다.

환경 변수를 사용하는 방법에 대한 자세한 정보는 환경 변수 사용을 참조하십시오.

IBM Cloud 구성 파일의 동일한 Terraform 내에 여러 개의 제공자 구성을 추가하여 다른 제공자 매개변수로 IBM Cloud 리소스를 작성할 수 있습니다. 예를 들어, 다른 입력 매개변수(예: 다른 지역, 구역, 인프라 생성 또는 계정)를 사용하여 IBM Cloud 구성 파일의 Terraform에 IBM Cloud 리소스를 작성할 수 있도록 여러 개의 제공자를 사용할 수 있습니다. 자세한 내용은 공급자 블록 참조를 참조 하세요.

4단계. Terraform CLI를 초기화하십시오.

다음으로 Terraform CLI를 초기화하십시오. 다음 명령을 실행하십시오.

./terraform init

Terraform has been successfully initialized! 메시지가 표시되어야 합니다.

5단계. 변수 파일 작성

하드 코딩된 값을 포함하도록 variables.tf라는 변수 파일을 작성하십시오.

다음 샘플은 사용자가 정의하는 변수를 나열합니다.

// Data source arguments for atracker settings

variable "atracker_metadata_region_primary" {
  description = "Location where the metadata configuration is stored"
  type = string
  default = "Enter a supported location"
}

variable "atracker_metadata_region_backup" {
  description = "Location where the metadata configuration is stored"
  type = string
  default = "Enter a supported location"
}

// Data source arguments for atracker_targets
variable "target_type" {
  description = "Type of resource that can be defined as a target. Valid values are cloud_object_storage, cloud_logs and event_streams"
  type        = string
}

variable "atracker_target_name" {
  description = "The name of the target. Must be 256 characters or less."
  type        = string
  default     = "Enter a default target name"
}

// Data source arguments for target of type cloud_object_storage
variable "cos_bucket_name" {
  description = "Name of the Cloud Object Storage bucket"
  type        = string
}

variable "cos_target_crn" {
  description = "CRN of the Cloud Object Storage bucket"
  type        = string
}

variable "cos_endpoint" {
  description = "Private endpoint of the Cloud Object Storage bucket"
  type        = string
}


// Resource arguments for atracker_route
variable "atracker_route_name" {
  description = "The name of the route. Must be 180 characters or less and cannot include any special characters other than `(space) - . _ :`."
  type        = string
  default     = "Enter a default target name"
}
variable "atracker_route_receive_global_events" {
  description = "Whether or not all global events should be forwarded to this region."
  type        = bool
  default     = false
}
variable "atracker_route_rules" {
  description = "Routing rules that will be evaluated in their order of the array."
  type        = list(object({ example=string }))
  default     = [ { example: "object" } ]
}

유효한 지역의 목록을 보려면 위치를 참조하십시오.

6단계. Terraform 구성 파일 작성

다음으로 main.tf라는 Terraform 구성 파일을 작성하십시오. 이 파일에서는 HashiCorp 구성 언어(HCL)를 사용하여 Activity Tracker Event Routing 을 구성합니다. 자세한 내용은 테라폼 문서를 참조하세요.

resource "ibm_atracker_settings" "atracker_settings" {
  metadata_region_primary = var.atracker_metadata_region_primary
  metadata_region_backup = var.atracker_metadata_region_backup
  default_targets = ["comma-separated-list-of-target-ids"]
  permitted_target_regions  = ["comma-separated-list-of-locations"]
  private_api_endpoint_only = false

  # Optional but recommended lifecycle flag
  lifecycle {
    create_before_destroy = true
  }
}

# Target type: cloud-object-storage
# Using service to service authorization
resource "ibm_atracker_target" "atracker_target" {
  cos_endpoint {
     endpoint = var.cos_endpoint
     target_crn = var.cos_target_crn
     bucket = var.cos_bucket_name
     service_to_service_enabled = true
  }
  name = "<Target-Name>"
  target_type = "cloud_object_storage"
  region = "us-south"
}

# Target type: cloud-object-storage
# Using a service ID Api key
resource "ibm_atracker_target" "atracker_target" {
  cos_endpoint {
     endpoint = var.cos_endpoint
     target_crn = var.cos_target_crn
     bucket = var.cos_bucket_name
     api_key = "api_key"
  }
  name = "<Target-Name>"
  target_type = "cloud_object_storage"
  region = "us-south"
}

# Target type: cloud_logs
# Using a service ID API key
resource "ibm_atracker_target" "atracker_cloudlogs_target" {
  cloudlogs_endpoint {
    target_crn = "crn:v1:bluemix:public:logs:eu-es:a/11111111111111111111111111111111:22222222-2222-2222-2222-222222222222::"
  }
  name = "<Target-Name>"
  target_type = "cloud_logs"
  region = "us-south"
}

# Target type: event-streams
# Using a service ID API key
resource "ibm_atracker_target" "atracker_eventstreams_target" {
  eventstreams_endpoint {
    target_crn = "crn:v1:bluemix:public:logs:us-south:a/11111111111111111111111111111111:22222222-2222-2222-2222-222222222222::"
    brokers = ["xxxxx.cloud.ibm.com:9093","yyyyy.cloud.ibm.com:9093"]
    topic = "my-topic"
    api_key = "api-key"
  }
  name = "<Target-Name>"
  target_type = "event_streams"
  region = "us-south"
}

## Create a route to route auditing events from Frankfurt

resource "ibm_atracker_route" "atracker_route_instance" {
  lifecycle {
    create_before_destroy = true
  }
  name = "<Route-Name>"
  rules {
    target_ids = [ibm_atracker_target.atracker_target.id]
    locations = ["eu-de"]
  }
}

## Create a route to route auditing events from 2 regions and also global events.

resource "ibm_atracker_route" "atracker_route_instance-global" {
  name = var.route_name-global

  rules {
    target_ids = [ibm_atracker_target.atracker_target-global.id]
    locations = ["global", "us-south", "eu-de"]
  }
}

## Create a route that includes multiple rules.

resource "ibm_atracker_route" "atracker_route_instance-global" {
  name = var.route_name-global

  rules {
    target_ids = [ibm_atracker_target.atracker_target-global.id]
    locations = ["eu-gb", "eu-de"]
  }
  rules {
    target_ids = [ibm_atracker_target.atracker_eventstreams_target.id]
    locations = ["us-south", "global"]
  }
}

module "activity_tracker" {
  source  = "terraform-ibm-modules/activity-tracker/ibm"
  version = "X.Y.Z" # Replace with a specific release version

  cos_targets = [{
    bucket_name   = var.cos_bucket_name
    endpoint      = var.cos_endpoint
    instance_id   = var.cos_target_crn
    target_region = "us-south"
    target_name   = "<Target-Name>"
  }]

  activity_tracker_routes = [{
    route_name = "<Route-Name>"
    locations  = ["eu-de"]
    target_ids = [module.activity_tracker.activity_tracker_targets[var.cos_bucket_name].id]
  }]
}

7단계. 리소스 프로비저닝

다음 단계를 완료하십시오.

1. Terraform CLI를 초기화하십시오.

   ./terraform init
   

2. Terraform 실행 플랜을 작성하십시오. Terraform 실행 플랜은 계정에 Activity Tracker 인스턴스, 리소스 키 및 IAM 액세스 정책을 작성하기 위해 실행해야 하는 모든 조치를 요약한 것입니다.

   ./terraform plan
   

3. 리소스를 작성하십시오.

   ./terraform apply
   

   리소스를 삭제하려면 ./terraform destroy를 실행하십시오.

다음에 수행할 작업

리소스가 작성되었는지 확인하십시오.

Terraform IBM 모듈(TIM)레지스트리에서 사용 가능한 모든 모듈을 살펴보세요.