Menggunakan penyedia Terraform (zinn-digital/zinn)

zinn-digital/zinn adalah provider Terraform resmi kami, yang dipublikasikan di Terraform Registry dengan rilis bertanda tangan. Provider ini mengelola catatan DNS pada domain di organisasi Anda, dan membaca situs, domain, paket, serta wilayah hosting Anda sebagai sumber data. Situs, kotak surat, dan paket itu sendiri saat ini tidak dikelola oleh Terraform — gunakan dasbor, API, SDK, atau Zinnector® CLI untuk hal tersebut.

Pasang

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

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

Jalankan terraform init. Terraform mengunduh penyedia dari registri dan memverifikasi tanda tangannya.

Buat kunci API

Buka halaman Kunci API di dasbor Anda (app.zinndigital.com/api-keys) dan tekan Buat kunci. Untuk mengelola DNS, centang sites.view dan domains.dns.manage di bagian Izin. Ekspor kunci tersebut sebelum menjalankan Terraform:

export ZINN_API_KEY=zdk_live_…

Sumber data zinn_regions dan zinn_plans tidak memerlukan kunci.

Kelola rekaman 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 membuat rekaman; mengubah value atau ttl akan memperbaruinya di tempat; menghapus blok akan menghapusnya. name menerima @ untuk apex, nama relatif seperti www, atau nama lengkap.

Menempatkan rekaman yang ada di bawah Terraform

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

ID domain berasal dari data.zinn_domains; ID data ditampilkan oleh daftar data DNS API.

Baca inventaris Anda

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] }

Pengaturan penyedia

• api_key — kunci API; default ke ZINN_API_KEY.
• api_url — default ke ZINN_API_URL, lalu https://api.zinndigital.com.
• org — organisasi target tindakan; default ke ZINN_ORG. Biasanya tidak diperlukan, karena satu kunci milik satu organisasi.

Ke mana selanjutnya

• Panduan di situs web kami: zinndigital.com/developers/terraform
• Penyedia di Terraform Registry: registry.terraform.io/providers/zinn-digital/zinn
• Kode sumber: github.com/Zinn-Digital/terraform-provider-zinn