Container Service for Kubernetes:Gunakan add-on NodeLocal DNSCache

Cara kerja

NodeLocal DNSCache terdiri dari dua komponen:

• DaemonSet (agen caching DNS): Berjalan di setiap node, membuat antarmuka jaringan virtual, dan mendengarkan kueri DNS pada 169.254.20.10 secara default. Untuk mengubah alamat IP pendengar, ajukan tiket.

• Deployment (admission controller): Menangkap permintaan pembuatan Pod melalui admission webhook dan secara otomatis menyuntikkan dnsConfig ke dalam spesifikasi Pod.

Berdasarkan CoreDNS, agen caching hanya menyediakan proxy dan caching. Jangan aktifkan plugin seperti hosts atau rewrite di atasnya — konfigurasikan plugin tersebut di CoreDNS.

Alur kueri DNS setelah NodeLocal DNSCache diterapkan:

Alur kueri DNS setelah NodeLocal DNSCache diterapkan:

Lihat Kebijakan resolusi DNS dan kebijakan caching.

Prasyarat

Sebelum memulai, pastikan Anda telah:

• Membuat kluster ACK.

• kubectl telah terhubung ke kluster.

Batasan

• Node Windows tidak didukung. Untuk Pod pada node virtual (termasuk Pod ECI dan ACS), caching DNS hanya didukung jika NodeLocal DNSCache v1.6.0 atau lebih baru dan ack-virtual-node v2.14.0 atau lebih baru telah diinstal.

• Jika kluster menggunakan Terway, diperlukan versi 1.0.10.301 atau lebih baru. Jika Terway berjalan dalam Mode ENI inklusif dengan IPvlan, konfigurasikan Terway untuk mode IPvlan terlebih dahulu.

• NodeLocal DNSCache hanya bertindak sebagai proxy caching transparan untuk CoreDNS dan tidak menyediakan ekstensibilitas plugin. Konfigurasikan plugin seperti hosts atau rewrite di CoreDNS saja.

• Konfigurasikan protokol default plugin forward CoreDNS sebelum menggunakan NodeLocal DNSCache, atau CoreDNS mungkin gagal menyelesaikan domain eksternal. Lihat Praktik terbaik untuk layanan DNS.

• Tidak diinstal pada node master secara default. Jika Pod berjalan pada node master yang memiliki taint, tambahkan toleransi yang sesuai ke DaemonSet node-local-dns di namespace kube-system.

Instal NodeLocal DNSCache

1. Masuk ke Konsol ACK. Di panel navigasi kiri, klik Konsol ACK Clusters.

2. Temukan kluster Anda dan pilih More > Operations > Manage Components di kolom Actions.

3. Pada halaman Add-ons, klik tab Networking dan temukan ACK NodeLocal DNSCache.

4. Klik Install. Di kotak dialog, klik OK.

Konfigurasi NodeLocal DNSCache

Untuk mengarahkan kueri DNS dari Pod melalui NodeLocal DNSCache, atur nameservers dalam dnsConfig Pod ke 169.254.20.10 dan alamat IP kluster kube-dns. Gunakan salah satu metode berikut:

kubectl label namespace default node-local-dns-injection=enabled

dnsConfig:
  nameservers:
  - 169.254.20.10
  - 172.21.0.10
  options:
  - name: ndots
    value: "3"
  - name: attempts
    value: "2"
  - name: timeout
    value: "1"
  searches:
  - default.svc.cluster.local
  - svc.cluster.local
  - cluster.local
dnsPolicy: None

metadata:
  labels:
    node-local-dns-injection: "disabled"

apiVersion: v1
kind: Pod
metadata:
  name: alpine
  namespace: default
spec:
  containers:
  - image: alpine
    command:
      - sleep
      - "10000"
    imagePullPolicy: Always
    name: alpine
  dnsPolicy: None
  dnsConfig:
    nameservers: ["169.254.20.10","172.21.0.10"]
    searches:
    - default.svc.cluster.local
    - svc.cluster.local
    - cluster.local
    options:
    - name: ndots
      value: "3"
    - name: attempts
      value: "2"
    - name: timeout
      value: "1"

--cluster-dns=169.254.20.10 --cluster-dns=<kube-dns-ip> --cluster-domain=<search-domain>

sudo systemctl daemon-reload
sudo systemctl restart kubelet

Contoh: Konfigurasi NodeLocal DNSCache untuk Deployment

Aktifkan NodeLocal DNSCache untuk Deployment di namespace default dengan Metode 1 (penyuntikan otomatis).

1. Beri label namespace untuk mengaktifkan penyuntikan dnsConfig otomatis.

   Penting

   Admission controller melewati Pod di namespace kube-system dan kube-public. Jangan aktifkan penyuntikan untuk namespace tersebut.

   kubectl label namespace default node-local-dns-injection=enabled

2. Terapkan aplikasi contoh. Simpan YAML ini sebagai ubuntu-deployment.yaml:

   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: ubuntu
     labels:
       app: ubuntu
   spec:
     replicas: 2
     selector:
       matchLabels:
         app: ubuntu
     template:
       metadata:
         labels:
           app: ubuntu
       spec:
         containers:
         - name: ubuntu
           image: ubuntu
           command: ["sh", "-c"]
           args: ["sleep 100000"]

   Terapkan manifes:

   kubectl apply -f ubuntu-deployment.yaml

   Output yang diharapkan:

   deployment.apps/ubuntu created

3. Verifikasi Deployment sedang berjalan.

   kubectl get deployment ubuntu

   Output yang diharapkan:

   NAME     READY   UP-TO-DATE   AVAILABLE   AGE
   ubuntu   2/2     2            2           7s

4. Verifikasi penyuntikan dnsConfig. Dapatkan nama Pod:

   kubectl get pods

   Output yang diharapkan:

   NAME                      READY   STATUS    RESTARTS   AGE
   ubuntu-766448f68c-m****   1/1     Running   0          4m39s
   ubuntu-766448f68c-w****   1/1     Running   0          4m39s

   Periksa dnsConfig Pod:

   kubectl get pod ubuntu-766448f68c-m**** -o=jsonpath='{.spec.dnsConfig}'

   Output yang diharapkan:

   map[nameservers:[169.254.20.10 172.21.0.10] options:[map[name:ndots value:5]] searches:[default.svc.cluster.local svc.cluster.local cluster.local]]

   Kehadiran 169.254.20.10 dalam nameservers mengonfirmasi penyuntikan dnsConfig.

Peningkatan NodeLocal DNSCache

1. Masuk ke Konsol ACK. Di panel navigasi sebelah kiri, klik Clusters.

2. Klik nama kluster Anda. Di panel navigasi kiri, pilih Operations > Add-ons.

3. Pada halaman Add-ons, temukan NodeLocal DNSCache dan klik Upgrade. Di kotak dialog, klik OK.

Toleransi kustom pada DaemonSet node-local-dns akan ditimpa selama peningkatan. Konfigurasikan ulang setelahnya. Jika peningkatan gagal, lihat Troubleshooting komponen.

Uninstal NodeLocal DNSCache

1. Masuk ke Konsol ACK. Di panel navigasi kiri, klik Clusters.

2. Klik nama kluster Anda. Di panel navigasi kiri, pilih Operations > Add-ons.

3. Pada halaman Add-ons, temukan NodeLocal DNSCache dan klik Uninstall. Di kotak dialog, klik OK.

Konfigurasi Terway untuk mode IPvlan

Pada kluster dengan versi Terway lama, konfigurasi default mungkin tidak mengarahkan traffic DNS ke 169.254.20.10 dengan benar. Perbarui konfigurasi sebelum menginstal NodeLocal DNSCache.

1. Buka ConfigMap Terway untuk diedit:

   kubectl -n kube-system edit cm eni-config -o yaml

2. Periksa ConfigMap:

   • Jika eniip_virtual_type bukan IPVlan, tidak perlu perubahan. Lanjutkan ke Instal NodeLocal DNSCache.

   • Jika host_stack_cidrs sudah ada, tidak perlu perubahan. Lanjutkan ke Instal NodeLocal DNSCache.

3. Jika eniip_virtual_type adalah IPVlan dan host_stack_cidrs tidak ada, tambahkan host_stack_cidrs dan atur nilainya menjadi 169.254.20.10/32. Simpan dan keluar.

   10-terway.conf: |
    {
      "cniVersion": "0.3.0",
      "name": "terway",
      "eniip_virtual_type": "IPVlan",
      "host_stack_cidrs": ["169.254.20.10/32"],
      "type": "terway"
    }

4. Daftar Pod DaemonSet Terway:

   kubectl -n kube-system get pod | grep terway-eniip

   Output yang diharapkan:

   terway-eniip-7****         2/2     Running   0          30m
   terway-eniip-s****         2/2     Running   0          30m

5. Hapus Pod untuk menerapkan konfigurasi yang diperbarui:

   kubectl -n kube-system delete pod terway-eniip-7**** terway-eniip-s****

6. Masuk ke node kluster dan verifikasi pembaruan:

   cat /etc/cni/net.d/*

   Output yang diharapkan:

   {
     "cniVersion": "0.3.0",
     "name": "terway-chainer",
     "plugins": [
       {
         "eniip_virtual_type": "IPVlan",
         "host_stack_cidrs": [
           "169.254.20.10/32"
         ],
         "type": "terway"
       },
       {
         "type": "cilium-cni"
       }
     ]
   }

   Setelah semua Pod Terway berjalan, lanjutkan ke Instal NodeLocal DNSCache.

Langkah selanjutnya

• Penemuan layanan berbasis DNS

• Kebijakan DNS dan resolusi nama domain

• Praktik terbaik untuk layanan DNS