빠른 시작¶

이 문서에서는 Terraform을 사용하여 Guance 블랙리스트를 생성하고 관리하는 방법을 설명합니다.

준비 작업¶

Terraform 설치 후 Terraform 명령이 정상 작동하는지 확인합니다.
API Token을 획득합니다.

Terraform 구성 파일 작성¶

작업 디렉터리를 생성하고 그 안에 main.tf라는 구성 파일을 만듭니다.

$ mkdir learn-terraform-pipeline && cd $_
$ touch main.tf

main.tf 파일을 열고 다음 내용을 추가합니다.

terraform {
  required_version = ">=0.12"

  required_providers {
    guance = {
      source = "GuanceCloud/guance"
      version = "~> 0.0.6"
    }
  }
}

provider "guance" {
  access_token = "<API Token>" # 자신의 API Token으로 변경
  region = "hangzhou"
}

resource "guance_blacklist" "demo" {
  name = "blacklist-demo"
  type   = "logging"
  sources = ["mysql", "oracle"]
  desc = "this is a demo"

  filters = [
    {
      name      = "foo1"
      operation = "in"
      condition = "and"
      values    = ["oac-*"]
    }
  ]
}

Terraform 초기화¶

다음 명령을 실행하여 Terraform을 초기화합니다.

$ terraform init

이 명령은 Terraform 플러그인을 다운로드하여 설치하고 로컬 작업 디렉터리를 설정합니다.

구성 적용¶

구성을 적용하기 전에 Terraform이 실행할 작업 계획을 먼저 확인할 수 있습니다.

$ terraform plan

계획이 성공적으로 실행되면 다음 명령을 실행하여 리소스를 생성합니다.

$ terraform apply

Terraform이 변경될 리소스 정보를 표시하고 확인을 요청합니다. yes를 입력하여 계속 진행합니다. 명령이 성공적으로 실행되면 Guance에서 생성된 블랙리스트를 확인할 수 있습니다.

리소스 삭제¶

해당 블랙리스트가 더 이상 필요하지 않을 경우 다음 명령을 사용하여 리소스를 삭제할 수 있습니다.

$ terraform destroy

마찬가지로 Terraform이 확인을 요청하며 yes를 입력하여 계속 진행합니다. 명령이 성공적으로 실행되면 Guance에서 해당 블랙리스트가 더 이상 표시되지 않습니다.