Terraform ప్రొవైడర్‌ను (zinn-digital/zinn) ఉపయోగించడం

zinn-digital/zinn అనేది మా అధికారిక Terraform ప్రొవైడర్, ఇది సంతకం చేసిన విడుదలలతో Terraform Registry లో ప్రచురించబడింది. ఇది మీ సంస్థలోని డొమైన్‌లపై DNS రికార్డులను నిర్వహిస్తుంది మరియు మీ సైట్‌లు, డొమైన్‌లు, ప్లాన్‌లు మరియు హోస్టింగ్ ప్రాంతాలను డేటా మూలాలుగా చదువుతుంది. సైట్‌లు, మెయిల్‌బాక్స్‌లు మరియు ప్లాన్‌లు ప్రస్తుతం Terraform ద్వారా నిర్వహించబడవు — వాటి కోసం డ్యాష్‌బోర్డ్, API, SDKలు లేదా 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ని మార్చడం దానిని అక్కడే నవీకరిస్తుంది; బ్లాక్‌ను తీసివేయడం దానిని తొలగిస్తుంది. అపెక్స్ కోసం @, www వంటి సాపేక్ష పేరు లేదా పూర్తి పేరును name అంగీకరిస్తుంది.

ఇప్పటికే ఉన్న రికార్డును Terraform పరిధిలోకి తీసుకురండి

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

డొమైన్ ఐడి data.zinn_domains నుండి వస్తుంది; రికార్డ్ ఐడి 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