د Terraform چمتوکوونکي (zinn-digital/zinn) کارول

zinn-digital/zinn زموږ رسمي Terraform برابروونکی دی، چې په Terraform Registry کې د لاسلیک شویو خپرونو سره خپور شوی. دا ستاسو په اداره کې د ډومینونو اړوند DNS ریکارډونه سمبالوي، او ستاسو سایټونه، ډومینونه، پلانونه او د کوربه‌توب سیمې د معلوماتو سرچینو په توګه لولي. سایټونه، میل‌بکسونه او پلانونه پخپله نن ورځ د Terraform لخوا نه اداره کیږي — د دې لپاره ډشبورډ، API، SDKs یا 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] }

د وړاندې کوونکي ترتیبات

• api_key — د API کیلي؛ تلواله بڼه یې ZINN_API_KEY ده.
• api_url — تلواله بڼه یې ZINN_API_URL ده، بیا https://api.zinndigital.com ده.
• org — هغه اداره چې عمل پرې ترسره کېږي؛ تلواله بڼه یې ZINN_ORG ده. معمولاً غیر ضروري ده، ځکه چې یوه کیلي په یوې ادارې پورې اړه لري.

بل چیرته لاړ شئ

• زموږ په ویبپاڼه کې لارښود: zinndigital.com/developers/terraform
• په Terraform Registry کې وړاندې کوونکی: registry.terraform.io/providers/zinn-digital/zinn
• سرچینه کوډ: github.com/Zinn-Digital/terraform-provider-zinn