Penyedia Terraform

Kelola DNS Anda sebagai kode

Penyedia Terraform kami, zinn-digital/zinn, mengelola rekaman DNS pada domain di organisasi Anda dan membaca situs, domain, paket, serta wilayah hosting Anda sebagai sumber data. Alat ini dipublikasikan di Terraform Registry dan dibangun di atas API publik yang sama seperti yang lainnya.

Semua dokumentasi pengembang →

Instal

Deklarasikan penyedia dan jalankan terraform init. Rilis telah ditandatangani, dan Terraform memverifikasi tanda tangan saat mengunduh penyedia.

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

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

Mulai cepat

Cari domain berdasarkan nama dan arahkan www ke domain tersebut, lalu buat daftar wilayah hosting.

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

Autentikasi

Penyedia membaca kunci API per organisasi dari argumen api_key atau dari variabel lingkungan ZINN_API_KEY. Sumber data regions dan plans tidak memerlukan kunci. Berikan kunci hanya izin yang diperlukan oleh konfigurasi Anda, misalnya melihat situs dan mengelola DNS.

Buat kunci API di dasbor Anda

Yang dikelolanya saat ini

Sumber daya: zinn_dns_record

Buat, perbarui, hapus, dan impor data DNS di domain Anda: A, AAAA, CNAME, MX, TXT, SRV, dan jenis lain yang didukung zona Anda.

Sumber data

zinn_sites dan zinn_domains membaca organisasi Anda. zinn_regions dan zinn_plans membaca katalog publik dan tidak memerlukan kunci.

Dibuat dari spesifikasi

Model permintaan dan respons penyedia dibuat dari spesifikasi OpenAPI kami, dan rilis baru dipublikasikan ke Terraform Registry secara otomatis.

Baca inventaris Anda

Sumber data tidak memerlukan sumber daya sama sekali, jadi Anda dapat memulai dengan membaca apa yang sudah Anda miliki.

# A read-only inventory of your organisation and the catalogue.
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] }

Tautan

Pertanyaan

Apakah Anda memiliki penyedia Terraform?

Ya. Gunakan source = "zinn-digital/zinn" dari Terraform Registry. Saat ini layanan tersebut mengelola rekaman DNS serta membaca situs, domain, paket, dan wilayah hosting.

Bisakah Terraform membuat situs atau kotak surat?

Belum. Situs, kotak surat, dan paket dikelola di dasbor, melalui API, SDK, atau Zinnector® CLI. Penyedia mengelola data DNS dan membaca sisanya.

Bagaimana cara memasukkan data DNS yang ada ke dalam pengelolaan Terraform?

Jalankan terraform import dengan id domain dan id catatan yang dipisahkan oleh garis miring, misalnya terraform import zinn_dns_record.www <domain_id>/<record_id>.

Jelajahi setiap endpoint

Segala hal yang belum dikelola oleh penyedia tersedia di API, yang dijelaskan titik akhir demi titik akhir dalam referensi API.

Referensi API