موفر Terraform

إدارة DNS الخاص بك كتعليمة برمجية

يدير موفر Terraform التابع لنا، zinn-digital/zinn، سجلات DNS على النطاقات في مؤسستكم ويقرأ مواقعكم ونطاقاتكم وخططكم ومناطق الاستضافة الخاصة بكم كمصادر بيانات. تم نشره على Terraform Registry وتم بناؤه على نفس واجهة برمجة التطبيقات (API) العامة مثل كل شيء آخر.

جميع مستندات المطورين →

تثبيت

قم بالتصريح عن المزود وشغّل terraform init. يتم توقيع الإصدارات، ويتحقق Terraform من التوقيع عند تنزيل المزود.

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

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

البدء السريع

ابحث عن نطاق بالاسم ووجّه www إليه، ثم اعرض قائمة بمناطق الاستضافة.

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

المصادقة

يقرأ المزود مفتاح API خاصًا بكل مؤسسة من المعامل api_key أو من متغير البيئة ZINN_API_KEY. لا تحتاج مصادر بيانات regions وplans إلى أي مفتاح. امنح المفتاح فقط الأذونات التي يحتاجها تكوينك، مثل عرض المواقع وإدارة DNS.

أنشئ مفتاح API في لوحة التحكم الخاصة بك

ما يديره اليوم

المورد: zinn_dns_record

أنشئ سجلات نظام أسماء النطاقات (DNS) وحدّثها واحذفها واستوردها على نطاقاتك: A وAAAA وCNAME وMX وTXT وSRV والأنواع الأخرى التي تدعمها منطقتك.

مصادر البيانات

تقرأ zinn_sites وzinn_domains مؤسستكم. بينما تقرأ zinn_regions وzinn_plans الكتالوج العام ولا تحتاج إلى أي مفتاح.

تم إنشاؤه من المواصفات

يتم إنشاء نماذج الطلب والاستجابة الخاصة بالموفر من مواصفات OpenAPI الخاصة بنا، وتُنشر الإصدارات الجديدة تلقائيًا في Terraform Registry.

قراءة قائمة الجرد الخاصة بك

لا تتطلب مصادر البيانات أي موارد على الإطلاق، لذا يمكنك البدء بقراءة ما لديك بالفعل.

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

الروابط

أسئلة

هل لديكم مزود Terraform؟

نعم. استخدم source = "zinn-digital/zinn" من Terraform Registry. اليوم يدير سجلات DNS ويقرأ المواقع والنطاقات والخطط ومناطق الاستضافة.

هل يمكن لـ Terraform إنشاء مواقع أو صناديق بريد؟

ليس بعد. تُدار المواقع وصناديق البريد والخطط في لوحة التحكم، أو من خلال API، أو مجموعات أدوات تطوير البرمجيات (SDKs)، أو ⁦Zinnector® CLI⁩. يدير موفر الخدمة سجلات DNS ويقرأ الباقي.

كيف يمكنني إدراج سجل DNS حالي تحت إدارة Terraform؟

قم بتشغيل terraform import مع تضمين معرّف النطاق ومعرّف السجل مفصولين بشرطة مائلة، على سبيل المثال terraform import zinn_dns_record.www <domain_id>/<record_id>.

استكشف كل نقطة نهاية

أي شيء لا يديره الموفر بعد متاح في واجهة برمجة التطبيقات، والموضحة نقطة نهاية بنقطة نهاية في مرجع واجهة برمجة التطبيقات.

مرجع واجهة برمجة التطبيقات