Përdorimi i ofruesit të Terraform-it (zinn-digital/zinn)

zinn-digital/zinn është ofruesi ynë zyrtar i Terraform, i publikuar në Terraform Registry me versione të nënshkruara. Ai menaxhon regjistrimet DNS në domenet e organizatës suaj dhe lexon faqet, domenet, planet dhe rajonet e pritjes tuaja si burime të dhënash. Vetë faqet, kutitë postare dhe planet nuk menaxhohen nga Terraform sot — përdorni panelin e kontrollit, API-në, SDK-të ose Zinnector® CLI për to.

Instaloni

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

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

Ekzekutoni terraform init. Terraform shkarkon ofruesin nga regjistri dhe verifikon nënshkrimin e tij.

Krijoni një çelës API

Hapni faqen Çelësat API të panelit tuaj (app.zinndigital.com/api-keys) dhe shtypni Krijoni një çelës. Për menaxhimin e DNS-së, shënoni sites.view dhe domains.dns.manage nën Lejet. Eksportojeni atë përpara se të ekzekutoni Terraform:

export ZINN_API_KEY=zdk_live_…

Burimet e të dhënave zinn_regions dhe zinn_plans nuk kanë nevojë për çelës.

Menaxhoni një regjistrim 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 krijon regjistrimin; ndryshimi i value ose ttl e përditëson atë në vend; heqja e bllokut e fshin atë. name pranon @ për kulmin (apex), një emër relativ si www, ose një emër të plotë.

Kaloni një regjistrim ekzistues nën Terraform

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

Identifikuesi i domenit vjen nga data.zinn_domains; identifikuesi i regjistrimit shfaqet nga lista e regjistrimeve DNS të API-t.

Lexoni inventarin tuaj

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

Cilësimet e ofruesit

• api_key — çelësi API; si parazgjedhje është ZINN_API_KEY.
• api_url — si parazgjedhje është ZINN_API_URL, më pas https://api.zinndigital.com.
• org — organizata mbi të cilën do të veprohet; si parazgjedhje është ZINN_ORG. Zakonisht e panevojshme, sepse një çelës i përket një organizate.

Ku të shkoni më tej

• Udhëzuesi në faqen tonë të internetit: zinndigital.com/developers/terraform
• Ofruesi në Terraform Registry: registry.terraform.io/providers/zinn-digital/zinn
• Kodi burimor: github.com/Zinn-Digital/terraform-provider-zinn