Terraform sağlayıcısını (zinn-digital/zinn) kullanma

zinn-digital/zinn, imzalı sürümlerle Terraform Registry üzerinde yayımlanan resmi Terraform sağlayıcımızdır. Kuruluşunuzdaki alan adlarında yer alan DNS kayıtlarını yönetir; sitelerinizi, alan adlarınızı, planlarınızı ve barındırma bölgelerinizi veri kaynağı olarak okur. Siteler, posta kutuları ve planların kendileri şu anda Terraform tarafından yönetilmemektedir; bunlar için kontrol panelini, API'yi, SDK'leri veya Zinnector® CLI'yı kullanın.

Yükle

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

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

terraform init komutunu çalıştırın. Terraform, sağlayıcıyı kayıt defterinden indirir ve imzasını doğrular.

Bir API anahtarı oluşturun

Kontrol panelinizin API anahtarları sayfasını açın (app.zinndigital.com/api-keys) ve Bir anahtar oluştur seçeneğine basın. DNS yönetimi için İzinler altında sites.view ve domains.dns.manage öğelerini işaretleyin. Terraform'u çalıştırmadan önce bunu dışa aktarın:

export ZINN_API_KEY=zdk_live_…

zinn_regions ve zinn_plans veri kaynakları anahtar gerektirmez.

Bir DNS kaydını yönetin

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 kaydı oluşturur; value veya ttl değerini değiştirmek kaydı yerinde günceller; bloğu kaldırmak ise kaydı siler. name, tepe noktası için @, www gibi göreli bir ad veya tam bir ad kabul eder.

Mevcut bir kaydı Terraform altına alın

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

Alan adı kimliği data.zinn_domains üzerinden gelir; kayıt kimliği API'nin DNS kayıt listesinde gösterilir.

Envanterinizi okuyun

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

Sağlayıcı ayarları

• api_key — API anahtarı; varsayılan olarak ZINN_API_KEY.
• api_url — varsayılan olarak ZINN_API_URL, ardından https://api.zinndigital.com.
• org — işlem yapılacak kuruluş; varsayılan olarak ZINN_ORG. Bir anahtar tek bir kuruluşa ait olduğundan genellikle gereksizdir.

Sırada ne var

• Web sitemizdeki kılavuz: zinndigital.com/developers/terraform
• Terraform Registry üzerindeki sağlayıcı: registry.terraform.io/providers/zinn-digital/zinn
• Kaynak kodu: github.com/Zinn-Digital/terraform-provider-zinn