Terraform provayderindən (zinn-digital/zinn) istifadə

zinn-digital/zinn imzalanmış buraxılışlarla Terraform Registry-də dərc edilmiş rəsmi Terraform təminatçımızdır. O, təşkilatınızdakı domenlərdə DNS qeydlərini idarə edir və saytlarınızı, domenlərinizi, planlarınızı və hostinq regionlarınızı məlumat mənbələri kimi oxuyur. Saytlar, poçt qutuları və planların özləri hazırda Terraform tərəfindən idarə olunmur — onlar üçün idarə panelindən, API-dən, SDK-lardan və ya Zinnector® CLI-dən istifadə edin.

Quraşdırın

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

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

terraform init əmrini işə salın. Terraform təminatçını reyestrdən endirir və onun imzasını yoxlayır.

API açarı yaradın

İdarəetmə panelinizin API açarları səhifəsini (app.zinndigital.com/api-keys) açın və Açar yarat düyməsini sıxın. DNS-i idarə etmək üçün İcazələr bölməsində sites.view və domains.dns.manage seçimlərini qeyd edin. Terraform-u işə salmazdan əvvəl onu ixrac edin:

export ZINN_API_KEY=zdk_live_…

zinn_regions və zinn_plans məlumat mənbələri heç bir açar tələb etmir.

DNS qeydini idarə edin

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 qeydi yaradır; value və ya ttl dəyərini dəyişmək onu yerində yeniləyir; bloku silmək isə onu ləğv edir. name təpə domen (apex) üçün @, www kimi nisbi ad və ya tam ad qəbul edir.

Mövcud qeydin Terraform idarəetməsinə keçirilməsi

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

Domen id-si data.zinn_domains daxilindən gəlir; qeyd id-si isə API-nin DNS qeydləri siyahısında göstərilir.

İnventarınızı oxuyun

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

Provider tənzimləmələri

• api_key — API açarı; susmaya görə dəyəri ZINN_API_KEY kimidir.
• api_url — susmaya görə ZINN_API_URL, sonra isə https://api.zinndigital.com.
• org — üzərində əməliyyat aparılacaq təşkilat; susmaya görə dəyəri ZINN_ORG kimidir. Açarlar yalnız bir təşkilata aid olduğu üçün adətən tələb olunmur.

Növbəti addımlar

• Veb-saytımızdakı təlimat: zinndigital.com/developers/terraform
• Terraform Registry-də provayder: registry.terraform.io/providers/zinn-digital/zinn
• Mənbə kodu: github.com/Zinn-Digital/terraform-provider-zinn