Container Service for Kubernetes:Konfigurasikan parameter kustom untuk CoreDNS terkelola

Ikhtisar

CoreDNS terkelola ACK menyediakan CustomResourceDefinition (CRD) CustomDNSConfig ber-cakupan kluster dalam grup API networking.alibabacloud.com/v1beta1. Saat Anda membuat atau memperbarui CR default, sebuah controller merekonsiliasikannya ke ConfigMap CoreDNS (Corefile) dan memicu reload langsung—tanpa perlu me-restart pod.

CRD CustomDNSConfig ber-cakupan kluster hanya memiliki satu instans bernama default. Desain ini memastikan konfigurasi DNS otoritatif tunggal per kluster dan mencegah konflik antara beberapa konfigurasi. Untuk memperbarui konfigurasi, terapkan perubahan pada CR yang sudah ada, bukan membuat yang baru.

Cara kerja:

CustomDNSConfig CR (default)
        ↓  controller reconciles
CoreDNS ConfigMap (Corefile)
        ↓  CoreDNS reloads (~20 seconds)
Live DNS resolution updated

apiVersion: networking.alibabacloud.com/v1beta1
kind: CustomDNSConfig
metadata:
  name: default
  namespace: default
spec:
  zones:
  - name: example.com
    forward:
      protocolStrategy: ""
      transportConfig: {}
      upstreams:
      - xxx.xxx.xxx.xxx     # Alamat IP
      - xxx.xxx.xxx.xxx:53  # IP:port
    hosts:
    - hostName: "a.example.com"
      ipAddress: xxx.xxx.xxx.xxx

Prasyarat

• Plugin CoreDNS terkelola telah diinstal pada versi 1.9.3.20 atau lebih baru. Untuk informasi selengkapnya, lihat Service discovery DNS.

• Klien kubectl telah terhubung ke kluster. Untuk informasi selengkapnya, lihat Obtain the kubeconfig file of a cluster and use kubectl to connect to the cluster.

Batasan

• Anda hanya dapat membuat satu CR CustomDNSConfig, dan harus diberi nama default. Jika Anda membuat CR dengan nama lain, fase-nya diatur menjadi NotSupported dan konfigurasinya diabaikan.

• Bidang upstreams hanya mendukung alamat IPv4 (format: IP atau IP:PORT). Maksimal 15 alamat per zona.

• Bidang ipAddress dalam entri hosts hanya mendukung alamat IPv4.

• Bidang transportConfig tidak dapat dimodifikasi.

Skenario 1: Konfigurasikan zona kustom

Gunakan skenario ini untuk mengarahkan kueri domain tertentu ke server DNS hulu atau memetakan hostname dalam domain ke alamat IP statis.

Contoh berikut mengonfigurasi dua zona kustom:

• example.com — mengarahkan semua kueri ke server DNS hulu 100.100.2.136 dan 100.100.2.138 (alamat layanan resolusi DNS internal default; lihat Endpoints untuk detailnya).

• foo.com — memetakan a.foo.com dan b.foo.com ke alamat IP statis menggunakan plugin hosts.

Langkah 1: Buat manifes CR.

Buat file bernama default.yaml dengan konten berikut:

apiVersion: networking.alibabacloud.com/v1beta1
kind: CustomDNSConfig
metadata:
  name: default   # Harus diberi nama "default"
spec:
  zones:
  - name: example.com
    forward:
      upstreams:
      - 100.100.2.136  # Atur alamat server DNS hulu untuk example.com ke 100.100.2.136 dan 100.100.2.138.
      - 100.100.2.138
  - name: foo.com
    hosts:
    - hostName: "a.foo.com"  # Konfigurasikan alamat IP statis kustom untuk a.foo.com dan b.foo.com dalam zona foo.com.
      ipAddress: 192.168.0.251
    - hostName: "b.foo.com"
      ipAddress: 192.168.0.252

Langkah 2: Terapkan manifes.

kubectl apply -f default.yaml

Langkah 3: Verifikasi bahwa Corefile telah dihasilkan.

kubectl get customdnsconfig default -o yaml | grep corefile -A 35 -B 1

Output yang diharapkan:

status:
  corefile: |
    example.com:53 {
        prometheus :9153
        forward .  100.100.2.136 100.100.2.138 {
          policy random
          prefer_udp
        }
    ...
    }
    foo.com:53 {
        prometheus :9153
        hosts {
          192.168.0.251    a.foo.com
          192.168.0.252    b.foo.com
          fallthrough
        }
        forward .  /etc/resolv.conf {
          policy random
          prefer_udp
        }
    ...
    }
  ...
--
  corefileHash: 41f7be21cf3022c305091665ed33b1e5
  lastTransitionTime: "2024-09-13T09:07:37Z"
  phase: GenerateSuccess

Status phase: GenerateSuccess mengonfirmasi bahwa CR diterima dan Corefile telah dihasilkan.

Langkah 4: Verifikasi resolusi DNS.

Setelah konfigurasi direload (sekitar 20 detik), jalankan pod uji untuk memastikan kueri DNS terselesaikan dengan benar:

# Uji apakah example.com diselesaikan melalui server DNS hulu
kubectl run -it --rm dns-test --image=busybox:1.28 --restart=Never -- nslookup example.com

# Uji apakah pemetaan host statis berfungsi untuk foo.com
kubectl run -it --rm dns-test --image=busybox:1.28 --restart=Never -- nslookup a.foo.com

Output nslookup harus menampilkan alamat yang Anda konfigurasikan (192.168.0.251 untuk a.foo.com, 192.168.0.252 untuk b.foo.com).

hosts:
  - hostName: "a.example.com"
    ipAddress: 10.0.0.123
  - hostName: "a.example.com"
    ipAddress: 10.0.0.124

Skenario 2: Modifikasi konfigurasi zona default

Gunakan skenario ini untuk mengubah server DNS hulu untuk semua kueri kluster—yaitu, mengganti zona resolver default bawaan (".").

Langkah 1: Buat manifes CR.

Buat file bernama default.yaml dengan konten berikut:

apiVersion: networking.alibabacloud.com/v1beta1
kind: CustomDNSConfig
metadata:
  name: default   # Harus diberi nama "default"
spec:
  zones:
  - name: .
    forward:
      upstreams:
      - 100.100.2.136  # Alamat server DNS hulu untuk zona default kustom bernama "." adalah 100.100.2.136 dan 100.100.2.138.
      - 100.100.2.138

Langkah 2: Terapkan manifes.

kubectl apply -f default.yaml

Langkah 3: Verifikasi bahwa Corefile telah dihasilkan.

kubectl get customdnsconfig default -o yaml | grep corefile -A 35 -B 1

Output yang diharapkan:

status:
  corefile: |
    .:53 {
        errors
        health {
          lameduck 20s
        }
        ready
        kubeapi {
          kubeconfig /etc/kubernetes/config/managed-coredns.conf
        }
        k8s_event {
          level error warning
        }
    ...
        prometheus :9153
        forward .  100.100.2.136 100.100.2.138 {
          policy random
          prefer_udp
        }
    ...
    }
  corefileHash: 847bf69cc4c97cee965945f45d17c661
  lastTransitionTime: "2024-09-13T09:54:22Z"
  phase: GenerateSuccess

Status phase: GenerateSuccess mengonfirmasi bahwa konfigurasi zona default telah diperbarui.

Langkah 4: Verifikasi resolusi DNS.

Setelah konfigurasi direload (sekitar 20 detik), jalankan pod uji untuk memastikan kueri eksternal diarahkan melalui server hulu yang dikonfigurasi:

kubectl run -it --rm dns-test --image=busybox:1.28 --restart=Never -- nslookup kubernetes.default.svc.cluster.local

Pemecahan Masalah

apiVersion: networking.alibabacloud.com/v1beta1
kind: CustomDNSConfig
metadata:
  name: test  ## Anda hanya dapat membuat CR CustomDNSConfig bernama default.
spec:
  zones:
  - name: example.com
    forward:
      upstreams:
      - 100.100.2.138
  - name: foo.com
    hosts:
    - hostName: "ah.foo.com"
      ipAddress: 1.1.xx.251
    - hostName: "aha.foo.com"
      ipAddress: 1.1.xx.252

kubectl apply -f test.yaml

kubectl get customdnsconfig

NAME      PHASE             VERSION                            AGE
default   GenerateSuccess   847bf69cc4c97cee96xxxxxxxxxxx      89m
test      NotSupported                                         9s

kubectl delete customdnsconfig test
kubectl apply -f default.yaml

Informasi event

Controller CoreDNS kustom menyinkronkan informasi event ke namespace default. Gunakan event ini untuk mengonfirmasi sinkronisasi konfigurasi yang berhasil atau mendiagnosis kegagalan.

Jalankan perintah berikut untuk melihat event:

kubectl get events

Output yang diharapkan:

LAST SEEN   TYPE     REASON                  OBJECT                           MESSAGE
45m         Normal   CustomDNSConfigSyncOk   customdnsconfig/default          custom dns config sync to coredns configmap success

Tabel berikut menjelaskan jenis-jenis event:

• Normal / CustomDNSConfigSyncOk: CR berhasil direkonsiliasi ke ConfigMap CoreDNS. Tidak perlu tindakan.

• NotSupported: Nama CR bukan default. Konfigurasi ditolak. Hapus CR tersebut dan terapkan ulang dengan name: default.

Untuk memantau status CR secara real-time selama perubahan disebarkan:

kubectl get customdnsconfig default -w