Container Service for Kubernetes:Gunakan komponen 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.

Agen caching dibangun di atas CoreDNS dan hanya menyediakan layanan proxy dan caching. Jangan aktifkan plugin lain seperti hosts atau rewrite — konfigurasikan plugin tersebut di CoreDNS saja.

Diagram berikut menunjukkan alur kueri DNS setelah NodeLocal DNSCache diterapkan.

<table> <thead> <tr> <td><p><b>No.</b></p></td> <td><p><b>Deskripsi</b></p></td> </tr> </thead> <colgroup></colgroup> <colgroup></colgroup> <tbody> <tr> <td><p>①</p></td> <td><p>Secara default, Pod dengan dnsConfig lokal yang disuntikkan menggunakan NodeLocal DNSCache untuk mendengarkan kueri DNS yang dikirim ke alamat IP 169.254.20.10 pada node tersebut.</p></td> </tr> <tr> <td><p>②</p></td> <td><p>Jika NodeLocal DNSCache tidak menemukan hasil cache untuk kueri DNS tersebut, layanan kube-dns digunakan untuk meminta CoreDNS menangani kueri tersebut.</p></td> </tr> <tr> <td><p>③</p></td> <td><p>CoreDNS menggunakan server DNS yang diterapkan di virtual private cloud (VPC) untuk melakukan resolusi nama domain yang bukan lokal kluster.</p></td> </tr> <tr> <td><p>④</p></td> <td><p>Jika Pod dengan dnsConfig lokal yang disuntikkan gagal terhubung ke NodeLocal DNSCache, Pod tersebut menggunakan layanan kube-dns untuk terhubung ke CoreDNS guna melakukan resolusi DNS.</p></td> </tr> <tr> <td><p>⑤</p></td> <td><p>Pod tanpa dnsConfig lokal yang disuntikkan menggunakan layanan kube-dns untuk terhubung ke CoreDNS guna melakukan resolusi DNS.</p></td> </tr> </tbody> </table>

Untuk detail kebijakan caching, lihat Kebijakan resolusi DNS dan kebijakan caching.

Prasyarat

Sebelum memulai, pastikan Anda telah memiliki:

• Kluster ACK. Lihat Buat kluster ACK yang dikelola.

• kubectl yang terhubung ke kluster. Lihat Dapatkan file kubeconfig kluster dan gunakan kubectl untuk terhubung ke kluster.

Batasan

• NodeLocal DNSCache tidak mendukung Pod yang berjalan di kluster ACK Serverless atau di Elastic Container Instance (ECI) dalam kluster ACK yang dikelola maupun khusus.

• Jika kluster menggunakan plugin jaringan Terway, diperlukan Terway versi 1.0.10.301 atau lebih baru. Jika Terway berjalan dalam mode ENI inklusif berbasis IPvlan, diperlukan konfigurasi tambahan. Lihat Konfigurasi Terway untuk mode IPvlan.

• NodeLocal DNSCache adalah proxy caching transparan untuk CoreDNS dan tidak menyediakan plugin seperti hosts atau rewrite. Untuk menggunakan plugin tersebut, konfigurasikan di CoreDNS.

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

• NodeLocal DNSCache tidak diinstal pada node master secara default. Jika Pod bisnis berjalan di 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 sebelah kiri, klik Konsol ACKClusters.

2. Temukan kluster yang ingin Anda kelola 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. Pada kotak dialog yang muncul, 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

Contoh ini menggunakan Metode 1 (penyuntikan otomatis) untuk mengaktifkan NodeLocal DNSCache pada Deployment di namespace default.

1. Tambahkan label ke namespace untuk mengaktifkan penyuntikan dnsConfig otomatis.

   Penting

   Admission controller melewatkan 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 berikut 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 bahwa dnsConfig telah disuntikkan. 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 pada 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 bahwa dnsConfig telah disuntikkan.

Perbarui NodeLocal DNSCache

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

2. Temukan kluster yang ingin Anda kelola dan klik namanya. Di panel navigasi sebelah kiri, pilih Operations > Add-ons.

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

Jika Anda memodifikasi toleransi pada DaemonSet node-local-dns, perubahan tersebut akan ditimpa selama upgrade. Konfigurasikan ulang toleransi setelah upgrade selesai. Jika upgrade gagal, lihat Troubleshooting komponen.

Uninstal NodeLocal DNSCache

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

2. Temukan kluster yang ingin Anda kelola dan klik namanya. Di panel navigasi sebelah kiri, pilih Operations > Add-ons.

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

Konfigurasi Terway untuk mode IPvlan

Pada kluster yang dibuat dengan versi awal Terway, konfigurasi default Terway mungkin tidak mengarahkan traffic DNS ke 169.254.20.10 dengan benar. Periksa dan 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 tidak diatur ke IPVlan, tidak diperlukan perubahan. Lanjutkan ke Instal NodeLocal DNSCache.

   • Jika host_stack_cidrs sudah ada, tidak diperlukan 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 ke 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 memicu pembuatan ulang dengan konfigurasi yang diperbarui:

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

6. Masuk ke node kluster dan verifikasi konfigurasi telah diterapkan:

   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 dibuat ulang dan berjalan, lanjutkan ke Instal NodeLocal DNSCache.

Langkah selanjutnya

• Penemuan layanan berbasis DNS

• Kebijakan DNS dan resolusi nama domain

• Praktik terbaik untuk layanan DNS