Použití poskytovatele Terraform (zinn-digital/zinn)

zinn-digital/zinn je náš oficiální poskytovatel pro Terraform, publikovaný v Terraform Registry s podepsanými vydáními. Spravuje záznamy DNS na doménách ve vaší organizaci a čte vaše weby, domény, tarify a hostingové regiony jako zdroje dat. Samotné weby, poštovní schránky a tarify dnes Terraform nespravuje — pro ně použijte ovládací panel, API, sady SDK nebo Zinnector® CLI.

Instalace

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

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

Spusťte terraform init. Terraform stáhne poskytovatele z registru a zkontroluje jeho podpis.

Vytvoření klíče API

Otevřete stránku Klíče API na svém ovládacím panelu (app.zinndigital.com/api-keys) a stiskněte Vytvořit klíč. Pro správu DNS zaškrtněte sites.view a domains.dns.manage v části Oprávnění. Před spuštěním nástroje Terraform jej exportujte:

export ZINN_API_KEY=zdk_live_…

Datové zdroje zinn_regions a zinn_plans nevyžadují žádný klíč.

Správa záznamu 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 vytvoří záznam; změna value nebo ttl jej aktualizuje na místě; odstranění bloku jej smaže. name přijímá @ pro apex, relativní název jako www nebo úplný název.

Převod existujícího záznamu pod správu Terraformu

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

Identifikátor domény pochází z data.zinn_domains; identifikátor záznamu se zobrazuje v seznamu DNS záznamů rozhraní API.

Načtěte svůj inventář

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

Nastavení provideru

• api_key — klíč API; výchozí hodnota je ZINN_API_KEY.
• api_url — výchozí hodnota je ZINN_API_URL, poté https://api.zinndigital.com.
• org — organizace, se kterou se má pracovat; výchozí hodnota je ZINN_ORG. Obvykle není nutné, protože klíč patří jedné organizaci.

Kam pokračovat dál

• Návod na našem webu: zinndigital.com/developers/terraform
• Provider v Terraform Registry: registry.terraform.io/providers/zinn-digital/zinn
• Zdrojový kód: github.com/Zinn-Digital/terraform-provider-zinn