ระดับ 6c · บทที่ 4/5

Terraform สำหรับ Cloudflare — provider v5, API token แบบแคบ, import ของเดิม และอ่าน plan ให้เป็น

⏱ 60 นาทีลองในCloudflare ↗
ข้อมูลบางส่วนอาจเปลี่ยน — ตรวจสอบก่อนใช้

บทนี้มีข้อมูลที่เปลี่ยนบ่อย (ฟีเจอร์ ราคา ชื่อเมนู) ตรวจกับเว็บทางการก่อนนำไปใช้

เป้าหมาย

จัดการ Cloudflare ทั้งบัญชีเป็นโค้ด: ตั้ง provider v5 ด้วย API token สิทธิ์แคบ, เก็บ state อย่างปลอดภัยบน R2, import ของที่เคยคลิกสร้างใน dashboard เข้ามาโดยไม่ลบของจริง, อ่าน terraform plan จับการ "ลบแล้วสร้างใหม่" ก่อนทำระบบล่ม และวาง pipeline plan-on-PR / apply-on-merge

ทำไมต้อง IaC กับ Cloudflare

คลิกใน dashboard Terraform
ใครแก้กฎ WAF เมื่อไร ไม่รู้ ทุกการเปลี่ยนผ่าน PR มีคนรีวิว มีประวัติ
ทำ 10 โซนให้เหมือนกันต้องคลิก 10 รอบ module เดียว ใช้ซ้ำ
พังแล้วจำไม่ได้ว่าค่าเดิมคืออะไร git revert + apply
ไม่รู้ว่ามีคนแก้นอกระบบ (drift) terraform plan บอกทันที

provider v5 — ของใหม่ที่ต้องรู้

  • ประกาศ version = "~> 5" (v5 สร้างจาก OpenAPI ของ Cloudflare ครอบคลุมบริการใหม่เร็ว)
  • ชื่อ/รูปแบบเปลี่ยนจาก v4 — ตัวอย่างบนเน็ตส่วนมากยังเป็น v4:
v4 (เก่า) v5
cloudflare_record + value cloudflare_dns_record + content
block ซ้อน rules { ... } attribute list rules = [{ ... }]
cloudflare_tunnel, cloudflare_access_application cloudflare_zero_trust_tunnel_cloudflared, cloudflare_zero_trust_access_application

⚠️ ต้องตรวจสอบ: ย้าย v4 → v5 มีคู่มือและเครื่องมือช่วยแปลง ดูหน้า Terraform ใน developers.cloudflare.com และ CHANGELOG ของ provider ก่อนอัปเกรดโปรเจกต์จริง

API token: แคบที่สุดเท่าที่ทำงานได้

  • ใช้ API token (ไม่ใช่ Global API Key) และส่งผ่าน env CLOUDFLARE_API_TOKEN — ห้ามเขียนใน .tf
  • จำกัด account/zone ที่ token เข้าถึง, ตั้ง วันหมดอายุ, จำกัด IP ของ CI ถ้าทำได้
  • แยก token: plan (Read) ใช้ได้ทุก PR · apply (Edit) ใช้เฉพาะ job บน main ที่มีคนอนุมัติ
  • ตัวอย่างสิทธิ์ของบทนี้: Zone › DNS › Edit, Zone › Zone WAF › Edit, Zone › Zone › Read, Account › Turnstile › Edit

⚠️ ต้องตรวจสอบ: ชื่อ permission group ในหน้าสร้าง token เปลี่ยนเป็นระยะ ถ้า apply ได้ 403 ให้ดูว่า resource นั้นต้องการสิทธิ์อะไร (เอกสาร resource ของ provider มีหัวข้อ "Accepted Permissions")

state = ความลับ

state เก็บค่าทุก attribute รวมถึงของ sensitive เช่น secret ของ Turnstile widget, tunnel_secret ของ tunnel — sensitive = true แค่ซ่อนตอนพิมพ์ ไม่ได้เข้ารหัสในไฟล์

  • ห้าม commit *.tfstate · เก็บบน remote backend ที่จำกัดสิทธิ์ (R2 bucket + token เฉพาะ bucket)
  • ทำงานหลายคน/หลาย pipeline ต้องกัน apply ซ้อน (state lock หรือ concurrency ใน CI)
  • backend s3 ล็อกด้วย use_lockfile = true (Terraform ≥ 1.10) ซึ่งอาศัย conditional write (If-None-Match) — R2 รองรับ header นี้ใน PutObject ตามตาราง S3 compatibility ของ R2

⚠️ ต้องตรวจสอบ: ทดสอบการล็อกบน R2 เองก่อนพึ่งพา (รัน terraform plan สองหน้าต่างพร้อมกัน ตัวที่สองต้องขึ้น Error acquiring the state lock) และใส่ concurrency ใน CI ให้ apply ทีละงานไว้อีกชั้นเสมอ

import: ของที่มีอยู่แล้วต้อง "รับเลี้ยง" ไม่ใช่สร้างใหม่

  • โซนหนึ่งมี entrypoint ruleset ได้ phase ละหนึ่งชุด — ถ้าเคยตั้ง WAF ใน dashboard/API (บท 01) แล้วเขียน cloudflare_ruleset phase เดียวกัน apply จะ error → ต้อง import
  • Terraform 1.5+ ใช้ import {} block ใน .tf แล้วดูผลใน plan ก่อน (ปลอดภัยกว่า terraform import ที่แก้ state ทันที)
  • มีของเยอะ ใช้ cf-terraforming generate สร้าง HCL และ cf-terraforming import --modern-import-block สร้าง import block ให้
  • เป้าหมายหลัง import: terraform plan ต้องขึ้น No changes ก่อนจะเริ่มแก้อะไร
resource รูปแบบ id ตอน import
cloudflare_dns_record <zone_id>/<dns_record_id>
cloudflare_ruleset zones/<zone_id>/<ruleset_id>
cloudflare_turnstile_widget <account_id>/<sitekey>

อ่าน plan ให้เป็น

สัญลักษณ์ ความหมาย ระวัง
+ สร้าง ชนกับของที่มีอยู่ไหม (เช่น DNS ชื่อซ้ำ)
~ แก้ในที่ ดูว่าแก้ field ไหน ตรงกับที่ตั้งใจไหม
- ลบ ใครลบ resource ออกจากโค้ด? ตั้งใจหรือ refactor ผิด
-/+ ลบแล้วสร้างใหม่ ID เปลี่ยน: tunnel ใหม่ = connector เดิมใช้ไม่ได้, widget ใหม่ = sitekey/secret เปลี่ยน, record ใหม่ = DNS หายชั่วขณะ
  • เปลี่ยนชื่อ resource ในโค้ด (refactor) → ใช้ moved {} block ไม่ให้เกิด destroy/create
  • ของสำคัญใส่ lifecycle { prevent_destroy = true }
  • apply จาก plan file ที่รีวิวแล้วเสมอ (plan -out → apply tfplan) ไม่ใช่ apply ใหม่ที่อาจต่างจากที่รีวิว

ลองเลย 🧪

ต้องมี Terraform ≥ 1.5 (terraform version), โดเมนบน Cloudflare, jq

1) ตั้งค่าโปรเจกต์

mkdir cf-infra && cd cf-infra && git init
printf '.terraform/\n*.tfstate\n*.tfstate.*\n*.tfvars\nbackend.hcl\ntfplan\n' > .gitignore
read -s CLOUDFLARE_API_TOKEN && export CLOUDFLARE_API_TOKEN
export TF_VAR_zone_id=[zone-id]
export TF_VAR_account_id=[account-id]
export TF_VAR_domain=[your-domain.example]

main.tf:

terraform {
  required_version = ">= 1.5"
  required_providers {
    cloudflare = {
      source  = "cloudflare/cloudflare"
      version = "~> 5"
    }
  }
}

provider "cloudflare" {} # อ่าน token จาก env CLOUDFLARE_API_TOKEN

variable "zone_id" { type = string }
variable "account_id" { type = string }
variable "domain" { type = string }

resource "cloudflare_dns_record" "iac_marker" {
  zone_id = var.zone_id
  name    = "_iac.${var.domain}"   # ใส่ชื่อเต็ม (FQDN) กัน plan เห็น diff ระหว่างชื่อสั้นกับชื่อที่ API คืนมา
  type    = "TXT"
  content = "\"managed-by=terraform\""
  ttl     = 1
  comment = "ใช้ยืนยันว่าโซนนี้จัดการด้วย Terraform"
}

resource "cloudflare_ruleset" "waf_custom" {
  zone_id     = var.zone_id
  name        = "default"
  description = "custom rules จัดการด้วย Terraform เท่านั้น"
  kind        = "zone"
  phase       = "http_request_firewall_custom"
  rules = [
    {
      ref         = "block_wp_probes"
      description = "block WordPress probes #SEC-102"
      expression  = "http.request.uri.path in {\"/wp-login.php\" \"/xmlrpc.php\"}"
      action      = "block"
    },
    {
      ref         = "challenge_admin_outside_th"
      description = "challenge /admin จากนอกไทย ยกเว้น verified bots #SEC-103"
      expression  = "starts_with(lower(http.request.uri.path), \"/admin\") and ip.src.country ne \"TH\" and not cf.client.bot"
      action      = "managed_challenge"
    }
  ]
  lifecycle {
    prevent_destroy = true
  }
}

resource "cloudflare_turnstile_widget" "signup" {
  account_id = var.account_id
  name       = "signup form"
  domains    = [var.domain]
  mode       = "managed"
}

output "turnstile_sitekey" {
  value = cloudflare_turnstile_widget.signup.sitekey
}
terraform init
terraform fmt -check && terraform validate

2) plan ครั้งแรก — ชนกับของเดิม?

terraform plan -out tfplan

ถ้าบท 01 เคยสร้าง entrypoint http_request_firewall_custom ไว้ (แม้จะ PUT rules ว่างแล้ว) การ apply จะ error ว่ามี ruleset ของ phase นี้อยู่แล้ว → import แทน:

RULESET_ID=$(curl -s "https://api.cloudflare.com/client/v4/zones/$TF_VAR_zone_id/rulesets/phases/http_request_firewall_custom/entrypoint" \
  -H "Authorization: Bearer $CLOUDFLARE_API_TOKEN" | jq -r '.result.id')
echo $RULESET_ID
cat > imports.tf <<EOF
import {
  to = cloudflare_ruleset.waf_custom
  id = "zones/$TF_VAR_zone_id/$RULESET_ID"
}
EOF
terraform plan -out tfplan

ผลที่ควรเห็น (ส่วนสำคัญ):

  # cloudflare_ruleset.waf_custom will be updated in-place
  # (imported from "zones/…/…")
  ~ resource "cloudflare_ruleset" "waf_custom" {
      ~ rules = [ + { … block_wp_probes … }, + { … challenge_admin_outside_th … } ]
  # cloudflare_dns_record.iac_marker will be created
  # cloudflare_turnstile_widget.signup will be created
Plan: 1 to import, 2 to add, 1 to change, 0 to destroy.

อ่านก่อน apply: ต้องไม่มี destroy และ -/+ · ถ้า RULESET_ID เป็น null แปลว่าโซนยังไม่มี entrypoint ให้ลบ imports.tf แล้ว plan ใหม่

terraform apply tfplan
curl -s -o /dev/null -w "%{http_code}\n" https://$TF_VAR_domain/wp-login.php
dig +short TXT _iac.$TF_VAR_domain
terraform plan

ผลที่ควรเห็น: 403 · "managed-by=terraform" · plan รอบสุดท้าย No changes. Your infrastructure matches the configuration.

3) จับ drift และดูความลับใน state แก้ description ของกฎ block_wp_probes ใน dashboard (Security › Security rules) แล้ว:

terraform plan

ผลที่ควรเห็น: ~ description = "…(แก้ใน dashboard)" -> "block WordPress probes #SEC-102" — Terraform จะเขียนทับของที่แก้นอกระบบ → ตกลงกับทีมว่า โซนที่อยู่ใน Terraform ห้ามแก้ใน dashboard

terraform state show cloudflare_turnstile_widget.signup | grep -i secret
grep -c '"secret"' terraform.tfstate

ผลที่ควรเห็น: secret = (sensitive value) แต่ grep ในไฟล์ state เจอ ≥ 1 — ค่า secret จริงอยู่ในไฟล์ เหตุผลที่ state ต้องอยู่ที่ปลอดภัย

4) ย้าย state ไป R2 (remote backend)

⚠️ ต้องเปิดใช้ R2 ในบัญชี (โควตาฟรีพอสำหรับ state) — ตรวจหน้า R2 pricing

npx wrangler r2 bucket create tfstate-[ชื่อทีม]

สร้าง R2 API token แบบ Object Read & Write เฉพาะ bucket นี้ (R2 › Manage R2 API tokens) แล้วเขียน backend.hcl (อยู่ใน .gitignore แล้ว):

bucket     = "tfstate-[ชื่อทีม]"
key        = "zones/[your-domain.example]/terraform.tfstate"
access_key = "[r2-access-key-id]"
secret_key = "[r2-secret-access-key]"
endpoints  = { s3 = "https://[account-id].r2.cloudflarestorage.com" }

เพิ่มใน terraform {} ของ main.tf:

  backend "s3" {
    region                      = "auto"
    skip_credentials_validation = true
    skip_metadata_api_check     = true
    skip_region_validation      = true
    skip_requesting_account_id  = true
    skip_s3_checksum            = true
    use_path_style              = true
    use_lockfile                = true   # ต้อง Terraform ≥ 1.10 — ถ้าเวอร์ชันเก่ากว่าให้ลบบรรทัดนี้ แล้วพึ่ง concurrency ของ CI
  }
terraform init -backend-config=backend.hcl -migrate-state
rm -f terraform.tfstate terraform.tfstate.backup
terraform plan

ผลที่ควรเห็น: ถามว่าจะคัดลอก state ไป backend ใหม่ไหม → yes · plan หลังย้าย = No changes

5) pipeline (แนวคิด) PR → terraform fmt -check, validate, plan ด้วย token Read แล้วโพสต์ผล plan ใน PR · merge → apply ด้วย token Edit ใน GitHub Environment ที่ต้องมีคนอนุมัติ และ concurrency ให้ apply ทีละงาน

เก็บกวาด

# ถอด prevent_destroy ออกจาก waf_custom ก่อน แล้ว
terraform destroy

ตรวจว่า TXT _iac และ widget หายไป แล้วลบ R2 bucket (npx wrangler r2 object delete tfstate-[ชื่อทีม]/zones/[your-domain.example]/terraform.tfstate --remote แล้ว npx wrangler r2 bucket delete tfstate-[ชื่อทีม]), R2 token และ API token ที่สร้างไว้

กับดักที่เจอบ่อย

อาการ สาเหตุ / แก้
คัดลอกตัวอย่างจากบล็อกแล้ว Unsupported block type "rules" ตัวอย่างเป็น v4 — v5 ใช้ rules = [{ ... }] และ cloudflare_dns_record
apply ruleset แล้ว error ว่ามี entrypoint อยู่แล้ว phase นั้นถูกสร้างนอก Terraform — import {} เข้ามาก่อน
plan โชว์ -/+ ที่ tunnel/widget field ที่บังคับสร้างใหม่ถูกแก้ หรือเปลี่ยนชื่อ resource — ใช้ moved {} / ย้อนการแก้ ถ้าจำเป็นต้องสร้างใหม่ วางแผนเปลี่ยน token/sitekey
state หลุดขึ้น GitHub มี secret ของ widget/tunnel อยู่ข้างใน — หมุน secret ทุกตัว, ลบประวัติ git, ย้ายไป remote backend
คนแก้ใน dashboard แล้วโดน apply ทับ drift — ประกาศว่าโซนนี้ Terraform เป็นเจ้าของ และรัน plan ตามรอบเวลาเพื่อจับ drift
CI ใช้ token ที่ลบโซนได้ทั้งบัญชี token กว้างเกิน — แยก Read/Edit, จำกัด zone, ตั้งหมดอายุ
apply สองงานพร้อมกันแล้ว state เพี้ยน ไม่มี lock — ใช้ concurrency ของ CI หรือ backend ที่ล็อกได้

สรุปจำง่าย

provider ~> 5 (cloudflare_dns_record, rules = [{}]) — token จาก env สิทธิ์แคบ แยก plan/apply — state มีความลับ เก็บ R2 ไม่ commit — ของเดิม import {} จน plan = No changes — อ่าน plan หา -/+ ก่อนทุก apply — โซนที่อยู่ใน Terraform ห้ามแก้ใน dashboard