Abilita la cache DNS NodeLocal

Abilita la cache DNS NodeLocal per uno o più nodi di lavoro nel tuo cluster Kubernetes.

La seguente procedura aggiorna i pod DNS che vengono eseguiti su specifici nodi di lavoro. Puoi anche etichettare il pool di nodi di lavoro in modo che i nodi futuri ereditino l'etichetta.

Prima di iniziare, aggiornare tutti i criteri di rete per l'uscita DNS che sono influenzati da questa funzione, come ad esempio i criteri che si basano su pod o selettori di spazio dei nomi per l'uscita DNS.

kubectl get networkpolicy --all-namespaces -o yaml

1. Accedi al tuo account. Se applicabile, specifica il gruppo di risorse appropriato. Imposta il contesto per il tuo cluster.

2. Se hai personalizzato dei domini stub e dei server DNS upstream per CoreDNS, devi anche personalizzare la cache DNS NodeLocal con questi domini stub e server DNS upstream.

3. Elenca i nodi nel tuo cluster. I pod dell'agent di memorizzazione in cache DNS NodeLocal fanno parte di un insieme di daemon che viene eseguito su ciascun nodo.

   kubectl get nodes
   

4. Aggiungi l'etichetta ibm-cloud.kubernetes.io/node-local-dns-enabled=true al nodo di lavoro. L'etichetta avvia il pod dell'agent di memorizzazione in cache DNS sul nodo di lavoro.

   1. Aggiungere l'etichetta a uno o più nodi di lavoro.

      • Per etichettare tutti i nodi di lavoro del cluster: Aggiungi l'etichetta a tutti i pool di nodi di lavoro esistenti.

      • Per etichettare un singolo nodo di lavoro:

        kubectl label node <node_name> --overwrite "ibm-cloud.kubernetes.io/node-local-dns-enabled=true"
        

   2. Verifica che il nodo abbia l'etichetta controllando che il campo NODE-LOCAL-DNS-ENABLED sia impostato su true.

      kubectl get nodes -L "ibm-cloud.kubernetes.io/node-local-dns-enabled"
      

      Output di esempio

      NAME          STATUS                      ROLES    AGE   VERSION       NODE-LOCAL-DNS-ENABLED
      10.xxx.xx.xxx Ready,SchedulingDisabled    <none>   28h   v1.32+IKS   true
      

   3. Verifica che il pod dell'agent di memorizzazione in cache DNS sia in esecuzione sul nodo di lavoro.

      kubectl get pods -n kube-system -l k8s-app=node-local-dns -o wide
      

      Output di esempio

      NAME                   READY   STATUS    RESTARTS   AGE   IP            NODE          NOMINATED NODE   READINESS GATES
      node-local-dns-pvnjn   1/1     Running   0          1m    10.xxx.xx.xxx   10.xxx.xx.xxx  <none>           <none>
      

5. Ripeti i passi precedenti per ciascun nodo di lavoro per abilitare la memorizzazione in cache DNS.

Disabilita la cache DNS NodeLocal

Puoi disabilitare la cache DNS NodeLocal per uno o più nodi di lavoro.

1. Accedi al tuo account. Se applicabile, specifica il gruppo di risorse appropriato. Imposta il contesto per il tuo cluster.

2. Rimuovi l'etichetta ibm-cloud.kubernetes.io/node-local-dns-enabled dal nodo di lavoro. Questa azione termina il pod dell'agent di memorizzazione in cache DNS sul nodo di lavoro.

   Esegui il seguente comando per rimuovere l'etichetta da tutti i nodi di lavoro nel cluster.

   kubectl label node --all --overwrite "ibm-cloud.kubernetes.io/node-local-dns-enabled-"
   

   Immetti questo comando per rimuovere l'etichetta da un singolo nodo di lavoro.

   kubectl label node <node_name> "ibm-cloud.kubernetes.io/node-local-dns-enabled-"
   

   1. Verifica che l'etichetta sia stata rimossa controllando che il campo NODE-LOCAL-DNS-ENABLED sia vuoto.

      kubectl get nodes -L "ibm-cloud.kubernetes.io/node-local-dns-enabled"
      

      Output di esempio

      NAME          STATUS                      ROLES    AGE   VERSION       NODE-LOCAL-DNS-ENABLED
      10.xxx.xx.xxx Ready,SchedulingDisabled    <none>   28h   v1.32+IKS   
      

   2. Verifica che il pod non sia più in esecuzione sul nodo dove la cache DNS è disabilitata. L'output non mostra alcun pod.

      kubectl get pods -n kube-system -l k8s-app=node-local-dns -o wide
      

      Output di esempio

      No resources found.
      

3. Ripeti i passi precedenti per ogni nodo di lavoro per disabilitare la memorizzazione in cache DNS.

Modifica di node-local-dns ConfigMap per aggiornamenti di configurazione generali

Modificare node-local-dns ConfigMap per personalizzare la configurazione della cache DNS NodeLocal.

Prima di iniziare: Accedere al proprio account. Se applicabile, specifica il gruppo di risorse appropriato. Imposta il contesto per il tuo cluster.

1. Verifica che la serie di daemon della cache DNS NodeLocal sia disponibile.

   kubectl get ds -n kube-system node-local-dns
   

   Output di esempio

   NAME             DESIRED   CURRENT   READY   UP-TO-DATE   AVAILABLE   NODE SELECTOR                                         AGE
   node-local-dns   4         4         4       4            4           ibm-cloud.kubernetes.io/node-local-dns-enabled=true   82d
   

2. Modificare le impostazioni predefinite o aggiungere i Corefile personalizzati alla NodeLocal cache DNS ConfigMap. Ogni Corefile che importi deve utilizzare il percorso coredns. Per ulteriori informazioni, consultare la documentazione Kubernetes.

   Solo una serie limitata di plug-in è supportata per la cache DNS NodeLocal.

   kubectl edit configmap -n kube-system node-local-dns
   

   Output di esempio

   apiVersion: v1
   kind: ConfigMap
   metadata:
     name: node-local-dns
     namespace: kube-system
   data:
     Corefile: |
       # Add your NodeLocal DNS customizations as import files under ./coredns directory.
       # Refer to /docs/containers?topic=containers-cluster_dns for details.
       import ./coredns/<MyCorefile>
       cluster.local:53 abc.com:53 {
           errors
           cache {
                   success 9984 30
                   denial 9984 5
           }
           reload
           loop
           bind 169.254.20.10 172.21.0.10
           forward . __PILLAR__CLUSTER__DNS__ {
                   force_tcp
           }
           prometheus :9253
           health 169.254.20.10:8080
           }
       in-addr.arpa:53 {
           errors
           cache 30
           reload
           loop
           bind 169.254.20.10 172.21.0.10
           forward . __PILLAR__CLUSTER__DNS__ {
                   force_tcp
           }
           prometheus :9253
           }
       ip6.arpa:53 {
           errors
           cache 30
           reload
           loop
           bind 169.254.20.10 172.21.0.10
           forward . __PILLAR__CLUSTER__DNS__ {
                   force_tcp
           }
           prometheus :9253
           }
       .:53 {
           errors
           cache 30 {
                 disable success cluster.local
                 disable denial cluster.local
           }
           reload
           loop
           bind 169.254.20.10 172.21.0.10
           forward . __PILLAR__UPSTREAM__SERVERS__ {
                   force_tcp
           }
           prometheus :9253
           }
     <MyCorefile>: |
       # Add custom corefile content ...
   

3. Dopo pochi minuti, i pod della cache DNS NodeLocal rilevano le modifiche della mappa di configurazione.

Modifica di node-local-dns-config ConfigMap per l'estensione con domini stub o server upstream

Modificare la node-local-dns-config ConfigMap per estendere la configurazione della cache DNS NodeLocal, ad esempio personalizzando i domini stub o i server DNS upstream. Per ulteriori informazioni, consultare la documentazione Kubernetes.

Prima di iniziare: Accedere al proprio account. Se applicabile, specifica il gruppo di risorse appropriato. Imposta il contesto per il tuo cluster.

1. Verifica che la serie di daemon della cache DNS NodeLocal sia disponibile.

   kubectl get ds -n kube-system node-local-dns
   

   Output di esempio

   NAME             DESIRED   CURRENT   READY   UP-TO-DATE   AVAILABLE   NODE SELECTOR                                         AGE
   node-local-dns   4         4         4       4            4           ibm-cloud.kubernetes.io/node-local-dns-enabled=true   82d
   

2. Conferma che la cache DNS NodeLocal abbia una mappa di configurazione.

   1. Determina se la mappa di configurazione della cache DNS NodeLocal DNS esiste.

      kubectl get cm -n kube-system node-local-dns-config
      

      Esempio di output se non esiste ConfigMap

      Error from server (NotFound): ConfigMaps "node-local-dns-config" not found
      

   2. Se la mappa di configurazione non esiste, crea una mappa di configurazione della cache DNS NodeLocal.

      kubectl create cm -n kube-system node-local-dns-config
      

      Output di esempio

      configmap/node-local-dns-config created
      

3. Modifica la mappa di configurazione della cache DNS NodeLocal. La mappa di configurazione utilizza la sintassi KubeDNS per personalizzare i domini stub e i server DNS upstream. Per ulteriori informazioni, consultare la documentazione Kubernetes.

   kubectl edit cm -n kube-system node-local-dns-config
   

   Output di esempio

   apiVersion: v1
   kind: ConfigMap
   metadata:
     name: node-local-dns-config
     namespace: kube-system
   data:
     stubDomains: |
         {"abc.com" : ["1.2.3.4"]}
   

4. Dopo pochi minuti, i pod della cache DNS NodeLocal rilevano le modifiche della mappa di configurazione.

Configurazione di DNS con zone

Completa il seguente passo per configurare il DNS consapevole della zona nel tuo cluster multizona.

1. Aggiornare tutti i criteri di rete per l'uscita DNS che sono influenzati dal DNS zone-aware, ad esempio i criteri che si basano sui selettori di pod o di spazio dei nomi per l'uscita DNS. Eseguire il seguente comando per ottenere un elenco dei criteri di rete.

   kubectl get networkpolicy --all-namespaces -o yaml
   

2. Etichettare coredns ConfigMap nello spazio dei nomi kube-system con ibm-cloud.kubernetes.io/deploy-zone-aware-dns=true.

   kubectl label cm -n kube-system coredns --overwrite "ibm-cloud.kubernetes.io/deploy-zone-aware-dns=true"
   

3. Aggiorna il master cluster per distribuire le risorse DNS sensibili alla zona.

   ibmcloud ks cluster master refresh -c <cluster_name_or_ID>
   

4. Controlla il completamento dell'operazione di aggiornamento esaminando il campo Master Health nei dettagli del cluster.

   ibmcloud ks cluster get -c <cluster_name_or_ID>
   

5. Se hai personalizzato dei domini stub e dei server DNS upstream per CoreDNS, devi anche personalizzare la cache DNS NodeLocal con questi domini stub e server DNS upstream.

6. Imposta una variabile di ambiente per le zone del cluster.

   ZONES=$(kubectl get nodes --no-headers --ignore-not-found=true -o jsonpath='{range .items[*]}{.metadata.labels.topology\.kubernetes\.io/zone}{"\n"}{end}' | uniq)
   

7. Avvia i pod CoreDNS e dell'autoscaler CoreDNS in tutte le zone.

   for ZONE in ${ZONES}; do
       kubectl scale deployment -n kube-system "coredns-autoscaler-${ZONE}" --replicas=1
   done
   

8. Verifica che i pod CoreDNS e dell'autoscaler CoreDNS siano in esecuzione in tutte le zone.

   for ZONE in ${ZONES}; do
       kubectl get pods -n kube-system -l "k8s-app=coredns-autoscaler-${ZONE}" -o wide
       kubectl get pods -n kube-system -l "k8s-app=coredns-${ZONE}" -o wide
   done
   

9. Avvia i pod della cache DNS NodeLocal su tutti i nodi di lavoro.

   kubectl label nodes --all --overwrite "ibm-cloud.kubernetes.io/zone-aware-dns-enabled=true"
   

10. Verifica che i pod della cache DNS NodeLocal siano in esecuzione su tutti i nodi di lavoro.

    for ZONE in ${ZONES}; do
        kubectl get pods -n kube-system -l "k8s-app=node-local-dns-${ZONE}" -o wide
    done
    

11. Etichetta i tuoi pool di nodi di lavoro in modo che i futuri nodi di lavoro ereditino l'etichetta ibm-cloud.kubernetes.io/zone-aware-dns-enabled=true.

Disabilitazione ed eliminazione del DNS con riconoscimento della zona

Per rimuovere il DNS con riconoscimento della zona, devi prima disabilitarlo in ogni zona del tuo cluster multizona. Quindi, elimina le risorse DNS con riconoscimento della zona.

1. Rimuovi l'etichetta ibm-cloud.kubernetes.io/zone-aware-dns-enabled=true dal tuo pool di nodi di lavoro.

2. Imposta una variabile di ambiente per le zone nel cluster.

   ZONES=$(kubectl get nodes --no-headers --ignore-not-found=true -o jsonpath='{range .items[*]}{.metadata.labels.topology\.kubernetes\.io/zone}{"\n"}{end}' | uniq)
   

3. Arresta i pod della cache DNS NodeLocal su tutti i nodi di lavoro.

   kubectl label nodes --all --overwrite "ibm-cloud.kubernetes.io/zone-aware-dns-enabled-"
   

4. Arresta i pod dell'autoscaler CoreDNS in tutte le zone.

   for ZONE in ${ZONES}; do
       kubectl scale deployment -n kube-system "coredns-autoscaler-${ZONE}" --replicas=0
   done
   

5. Verifica che i pod dell'autoscaler CoreDNS non siano più in esecuzione in tutte le zone.

   for ZONE in ${ZONES}; do
       kubectl get pods -n kube-system -l "k8s-app=coredns-autoscaler-${ZONE}"
   done
   

6. Arresta i pod CoreDNS in tutte le zone.

   for ZONE in ${ZONES}; do
       kubectl scale deployment -n kube-system "coredns-${ZONE}" --replicas=0
   done
   

7. Rimuovi l'etichetta ibm-cloud.kubernetes.io/deploy-zone-aware-dns=true dalla mappa di configurazione coredns nello spazio dei nomi kube-system.

   kubectl label cm -n kube-system coredns --overwrite "ibm-cloud.kubernetes.io/deploy-zone-aware-dns-"
   

8. Aggiorna il master cluster per eliminare le risorse DNS con riconoscimento della zona.

   ibmcloud ks cluster master refresh --cluster <cluster-name-or-id>
   

9. Controlla il completamento dell'operazione di aggiornamento esaminando il campo Master Health nei dettagli del cluster.

   ibmcloud ks cluster get -c <cluster_name_or_ID>