ការប្រើប្រាស់កម្មវិធីផ្ដល់សេវា Terraform (zinn-digital/zinn)

zinn-digital/zinn គឺជា Terraform provider ផ្លូវការរបស់យើង ដែលត្រូវបានបោះពុម្ពផ្សាយនៅលើ Terraform Registry ជាមួយនឹងការចេញផ្សាយដែលមានហត្ថលេខាឌីជីថល។ វាគ្រប់គ្រង DNS records នៅលើដែននានាក្នុងស្ថាប័នរបស់អ្នក ហើយវាអាន គេហទំព័រ, ដែន, គម្រោង និង តំបន់បង្ហោះ របស់អ្នកជាប្រភពទិន្នន័យ។ គេហទំព័រ ប្រអប់សំបុត្រ និងគម្រោងផ្ទាល់ មិនត្រូវបានគ្រប់គ្រងដោយ Terraform នៅពេលនេះទេ — សូមប្រើប្រាស់ផ្ទាំងគ្រប់គ្រង, API, SDKs ឬ Zinnector® CLI សម្រាប់ធាតុទាំងនោះ។

ដំឡើង

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

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

ដំណើរការ terraform init។ Terraform ទាញយក provider ពី registry ហើយពិនិត្យមើលហត្ថលេខារបស់វា។

បង្កើតសោ 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 ធ្វើបច្ចុប្បន្នភាពវាដោយផ្ទាល់។ ការលុបប្លុកចេញ គឺលុបវាចោល។ name ទទួលយក @ សម្រាប់ apex ឈ្មោះដែលទាក់ទងដូចជា www ឬឈ្មោះពេញ។

ដាក់បញ្ចូលកំណត់ត្រាដែលមានស្រាប់ក្រោមការគ្រប់គ្រងរបស់ Terraform

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

លេខសម្គាល់ដែន (domain id) គឺទទួលបានពី data.zinn_domains; លេខសម្គាល់កំណត់ត្រា (record id) ត្រូវបានបង្ហាញដោយបញ្ជីកំណត់ត្រា DNS របស់ API។

អានសារពើភ័ណ្ឌរបស់អ្នក

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