Sử dụng nhà cung cấp Terraform (zinn-digital/zinn)

zinn-digital/zinn là nhà cung cấp Terraform chính thức của chúng tôi, được phát hành trên Terraform Registry với các phiên bản có chữ ký xác thực. Nhà cung cấp này quản lý các bản ghi DNS trên các miền trong tổ chức của bạn, đồng thời đọc trang web, miền, gói dịch vụ và khu vực lưu trữ của bạn dưới dạng nguồn dữ liệu. Bản thân các trang web, hộp thư và gói dịch vụ hiện chưa được quản lý bởi Terraform — vui lòng sử dụng bảng điều khiển, API, SDK hoặc Zinnector® CLI cho các mục đó.

Cài đặt

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

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

Hãy chạy lệnh terraform init. Terraform sẽ tải nhà cung cấp xuống từ sổ đăng ký và kiểm tra chữ ký của nhà cung cấp đó.

Tạo khóa API

Hãy mở trang Khóa API trên bảng điều khiển của quý vị (app.zinndigital.com/api-keys) và nhấn Tạo khóa. Để quản lý DNS, hãy đánh dấu chọn sites.view và domains.dns.manage trong mục Quyền hạn. Hãy xuất khóa trước khi chạy Terraform:

export ZINN_API_KEY=zdk_live_…

Các nguồn dữ liệu zinn_regions và zinn_plans không cần khóa.

Quản lý bản ghi 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 sẽ tạo bản ghi; việc thay đổi value hoặc ttl sẽ cập nhật trực tiếp bản ghi đó; việc xóa khối sẽ xóa bản ghi. name chấp nhận @ cho đỉnh (apex), tên tương đối như www, hoặc tên đầy đủ.

Đưa một bản ghi hiện có vào Terraform

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

ID miền bắt nguồn từ data.zinn_domains; ID bản ghi được hiển thị bởi danh sách bản ghi DNS của API.

Đọc kho lưu trữ của bạn

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

Cài đặt nhà cung cấp

• api_key — khóa API; mặc định là ZINN_API_KEY.
• api_url — mặc định là ZINN_API_URL, sau đó là https://api.zinndigital.com.
• org — tổ chức cần thao tác; mặc định là ZINN_ORG. Thường không cần thiết vì một khóa chỉ thuộc về một tổ chức.

Nơi cần chuyển đến tiếp theo

• Hướng dẫn trên trang web của chúng tôi: zinndigital.com/developers/terraform
• Nhà cung cấp trên Terraform Registry: registry.terraform.io/providers/zinn-digital/zinn
• Mã nguồn: github.com/Zinn-Digital/terraform-provider-zinn