Terraform-szolgáltató

Kezelje DNS-ét kódként

Terraform szolgáltatónk, a zinn-digital/zinn kezeli a szervezetéhez tartozó domainek DNS-rekordjait, és adatforrásként olvassa webhelyeit, domainjeit, csomagjait és tárhelyrégióit. Megtalálható a Terraform Registry felületén, és ugyanarra a nyilvános API-ra épül, mint minden más.

Minden fejlesztői dokumentáció →

Telepítés

Deklarálja a szolgáltatót, és futtassa a terraform init parancsot. A kiadások alá vannak írva, és a Terraform ellenőrzi az aláírást a szolgáltató letöltésekor.

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

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

Gyorsindítás

Keressen egy domaint név alapján, és irányítsa rá a www-t, majd listázza a tárhelyrégiókat.

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

Hitelesítés

A szolgáltató a szervezetenkénti API-kulcsot az api_key argumentumból vagy a ZINN_API_KEY környezeti változóból olvassa be. A regions és a plans adatforrásokhoz nincs szükség kulcsra. Csak azokat az engedélyeket adja meg a kulcsnak, amelyekre a konfigurációjának szüksége van, például a webhelyek megtekintését és a DNS kezelését.

Hozzon létre egy API-kulcsot a vezérlőpultján

Amit ma kezel

Erőforrás: zinn_dns_record

Hozzon létre, frissítsen, töröljön és importáljon DNS-rekordokat a domainjein: A, AAAA, CNAME, MX, TXT, SRV és az egyéb típusokat, amelyeket a zónája támogat.

Adatforrások

A zinn_sites és a zinn_domains az Ön szervezetét olvassa. A zinn_regions és a zinn_plans a nyilvános katalógust olvassa, és nem igényel kulcsot.

A specifikációból generálva

A szolgáltató kérés- és válaszmodelljei az OpenAPI-specifikációnkból jönnek létre, az új kiadások pedig automatikusan közzétételre kerülnek a Terraform Registry felületén.

Leltár megtekintése

Az adatforrások egyáltalán nem igényelnek erőforrásokat, így kezdheti azzal, hogy elolvassa azt, amivel már rendelkezik.

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

Hivatkozások

Kérdések

Rendelkezik Terraform-szolgáltatóval?

Igen. Használja a source = "zinn-digital/zinn" forrást a Terraform Registry-ből. Jelenleg kezeli a DNS-rekordokat, valamint beolvassa a webhelyeket, domaineket, díjcsomagokat és tárhelyrégiókat.

Létrehozhat a Terraform webhelyeket vagy postafiókokat?

Még nem. A webhelyek, postafiókok és csomagok kezelése a vezérlőpulton, az API-n, az SDK-kon vagy a Zinnector® CLI-n keresztül történik. A szolgáltató kezeli a DNS-rekordokat, a többit pedig olvassa.

Hogyan vonhatok be egy létező DNS-rekordot a Terraform felügyelete alá?

Futtassa a terraform import parancsot a tartományazonosítóval és a rekordazonosítóval perjellel elválasztva, például: terraform import zinn_dns_record.www <domain_id>/<record_id>.

Fedezze fel az összes végpontot

Minden olyan funkció, amelyet a szolgáltató még nem kezel, elérhető az API-ban, amely végpontról végpontra részletezve megtalálható az API-referenciában.

API-referencia