지식 베이스

Terraform 공급자(zinn-digital/zinn) 사용

Terraform Registry에서 zinn-digital/zinn 공급자를 추가하고, API 키를 생성하며, DNS 레코드를 코드로 관리(생성, 업데이트, 가져오기)하고, 사이트, 도메인, 요금제 및 호스팅 리전을 데이터 소스로 읽어오십시오.

zinn-digital/zinn은 서명된 릴리스와 함께 Terraform Registry에 게시된 공식 Terraform 공급자입니다. 귀하의 조직에 있는 도메인의 DNS 레코드를 관리하며, 귀하의 사이트, 도메인, 요금제 및 호스팅 리전을 데이터 소스로 읽어옵니다. 사이트, 사서함 및 요금제 자체는 현재 Terraform으로 관리되지 않으므로, 대시보드, API, SDK 또는 Zinnector® CLI를 사용하십시오.

설치

terraform {
  required_providers {
    zinn = {
      source = "zinn-digital/zinn"
    }
  }
}

# api_key falls back to ZINN_API_KEY.
provider "zinn" {}

terraform init을 실행하십시오. Terraform이 레지스트리에서 공급자를 다운로드하고 서명을 확인합니다.

API 키 생성

대시보드의 API 키 페이지(app.zinndigital.com/api-keys)를 열고 키 생성을 누르십시오. DNS 관리를 위해 권한 아래의 sites.view 및 domains.dns.manage를 선택하십시오. Terraform을 실행하기 전에 이를 내보내십시오:

export ZINN_API_KEY=zdk_live_…

zinn_regions 및 zinn_plans 데이터 소스에는 키가 필요하지 않습니다.

DNS 레코드 관리

data "zinn_regions" "all" {}
data "zinn_domains" "all" {}

resource "zinn_dns_record" "www" {
  domain_id = one([for d in data.zinn_domains.all.domains : d.id if d.fqdn == "example.com"])
  name      = "www"
  type      = "CNAME"
  value     = "example.com."
  ttl       = 3600
}

output "regions" { value = [for r in data.zinn_regions.all.regions : r.slug] }

terraform apply는 레코드를 생성합니다. value 또는 ttl을 변경하면 제자리에서 업데이트되며, 블록을 제거하면 삭제됩니다. name에는 apex를 위한 @, www와 같은 상대 이름 또는 전체 이름을 사용할 수 있습니다.

기존 레코드를 Terraform 관리 대상으로 가져오기

terraform import zinn_dns_record.www <domain_id>/<record_id>

도메인 id는 data.zinn_domains에서 가져오며, 레코드 id는 API의 DNS 레코드 목록에 표시됩니다.

인벤토리 확인하기

data "zinn_sites" "all" {}
data "zinn_plans" "agency" { product_line = "agency" }

output "site_count" { value = length(data.zinn_sites.all.sites) }
output "agency_plans" { value = [for p in data.zinn_plans.agency.plans : p.code] }