NodeLocal DNS 캐시 사용

Kubernetes 클러스터에 있는 하나 이상의 작업자 노드에 대해 NodeLocal DNS 캐시를 사용으로 설정합니다.

1.35 버전 및 이후 버전

NodeLocal DNS는 모든 워커 노드에서 기본적으로 사용하도록 설정됩니다. 이전에 NodeLocal DNS를 비활성화했거나 NodeLocal DNS를 비활성화한 상태에서 새 작업자 노드를 추가하는 경우에만 이 단계를 따르세요.

1.34 및 그 이전 버전

NodeLocal DNS는 옵트인입니다. 워커 노드에서 이 기능을 사용 설정하려면 다음 단계를 따르세요.

다음 단계는 특정 작업자 노드에서 실행되는 DNS 팟(Pod)을 업데이트합니다. 향후 노드에서 레이블을 상속하도록 작업자 풀을 레이블 지정할 수도 있습니다.

시작하기 전에, 이 기능의 영향을 받는 모든 DNS 아웃바운드 네트워크 정책 (예: DNS 아웃바운드에 팟 또는 네임스페이스 선택자를 사용하는 정책 등)을 업데이트하십시오.

kubectl get networkpolicy --all-namespaces -o yaml

1. 계정에 로그인하십시오. If applicable, target the appropriate resource group. 클러스터에 대한 컨텍스트를 설정하십시오.

2. CoreDNS의 스텁 도메인 및 업스트림 DNS 서버를 사용자 정의한 경우, 이러한 스텁 도메인 및 업스트림 DNS 서버에서 NodeLocal DNS 캐시를 사용자 정의해야 합니다.

3. 클러스터의 노드를 나열하십시오. NodeLocal DNS 캐싱 에이전트 팟(Pod)은 각 노드에서 실행되는 디먼 세트의 일부입니다.

   kubectl get nodes
   

4. 작업자 노드에 ibm-cloud.kubernetes.io/node-local-dns-enabled=true 레이블을 추가하십시오. 해당 레이블에서 작업자 노드의 DNS 캐싱 에이전트 팟(Pod)을 시작합니다.

   1. 하나 이상의 작업자 노드에 레이블을 추가하십시오.

      • 클러스터에서 모든 작업자 노드에 레이블을 지정하려는 경우: 모든 기존 작업자 풀에 레이블을 추가하십시오.

      • 개별 작업자 노드의 레이블을 지정할 경우:

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

   2. NODE-LOCAL-DNS-ENABLED 필드가 true로 설정되어 있는지 확인하여 노드에 레이블이 있는지 확인하십시오.

       kubectl get nodes -L "ibm-cloud.kubernetes.io/node-local-dns-enabled"
       ```
       출력 예
   
       ```sh {: screen}
       NAME          STATUS                      ROLES    AGE   VERSION       NODE-LOCAL-DNS-ENABLED
       10.xxx.xx.xxx Ready,SchedulingDisabled    <none>   28h   v1.35+IKS   true
       ```
   3. DNS 캐싱 에이전트 팟(Pod)이 작업자 노드에서 실행되고 있는지 확인하십시오.
   
   ```sh {: pre}
       kubectl get pods -n kube-system -l k8s-app=node-local-dns -o wide
       ```
       출력 예
   
       ```sh {: screen}
       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. 각 작업자 노드에 대해 이전 단계를 반복하여 DNS 캐싱을 사용으로 설정하십시오.

NodeLocal DNS 캐시 사용 안함

하나 이상의 작업자 노드에 대해 NodeLocal DNS 캐시를 사용 안함으로 설정할 수 있습니다.

1.35 버전 및 이후 버전

기본적으로 사용하도록 설정된 NodeLocal DNS를 사용하지 않으려면 ibm-cloud.kubernetes.io/node-local-dns-disabled=true 레이블을 워커 노드에 추가하세요.

kubectl label node --all --overwrite "ibm-cloud.kubernetes.io/node-local-dns-disabled=true"

1.34 및 그 이전 버전

NodeLocal DNS를 비활성화하려면 작업자 노드에서 ibm-cloud.kubernetes.io/node-local-dns-enabled 레이블을 제거하세요.

1. 계정에 로그인하십시오. If applicable, target the appropriate resource group. 클러스터에 대한 컨텍스트를 설정하십시오.

2. 작업자 노드에서 ibm-cloud.kubernetes.io/node-local-dns-enabled 레이블을 제거하십시오. 이 조치는 작업자 노드의 DNS 캐싱 에이전트 팟(Pod)을 종료합니다.

   다음 명령을 실행하여 클러스터의 모든 작업자 노드에서 레이블을 제거하십시오.

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

   다음 명령을 실행하여 개별 작업자 노드에서 레이블을 제거하십시오.

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

   1. NODE-LOCAL-DNS-ENABLED 필드가 비어 있는지 확인하여 레이블이 제거되었는지 확인하십시오.

       kubectl get nodes -L "ibm-cloud.kubernetes.io/node-local-dns-enabled"
       ```
       출력 예
   
       ```sh {: screen}
       NAME          STATUS                      ROLES    AGE   VERSION       NODE-LOCAL-DNS-ENABLED
       10.xxx.xx.xxx Ready,SchedulingDisabled    <none>   28h   v1.35+IKS   
       ```
   2. DNS 캐시가 사용 안함으로 설정된 노드에서 해당 팟(Pod)이 더 이상 실행되지 않는지 확인하십시오. 출력에 팟(Pod)이 표시되지 않습니다.
   
   ```sh {: pre}
       kubectl get pods -n kube-system -l k8s-app=node-local-dns -o wide
       ```
       출력 예
   
       ```sh {: screen}
       No resources found.
       ```
   

3. 각 작업자 노드에 대해 이전 단계를 반복하여 DNS 캐싱을 사용 안함으로 설정하십시오.

일반 구성 업데이트에 대한 node-local-dns configmap 편집

node-local-dns configmap을 편집하여 NodeLocal DNS 캐시 구성을 사용자 정의합니다.

시작하기 전에: 계정에 로그인하십시오. If applicable, target the appropriate resource group. 클러스터에 대한 컨텍스트를 설정하십시오.

1. NodeLocal DNS 캐시 디먼 세트가 사용 가능한지 확인하십시오.

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

   출력 예

   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. 기본 설정을 편집하거나 사용자 정의 Corefile을 NodeLocal DNS 캐시 configmap에 추가하십시오. 가져온 각 Corefile은 coredns 경로를 사용해야 합니다. 자세한 내용은 ‘ Kubernetes ’ 문서를 참조하십시오.

   NodeLocal 의 DNS 캐시에서는 제한된 수의 플러그인 만 지원됩니다.

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

   출력 예

   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. 몇 분 후에 NodeLocal DNS 캐시 팟(Pod)이 configmap 변경사항을 선택합니다.

node-local-dns-config configmap을 편집하여 스텁 도메인 또는 업스트림 서버로 확장

node-local-dns-config configmap을 편집하여 NodeLocal DNS 캐시 구성을 확장하십시오(예: 스텁 도메인 또는 업스트림 DNS 서버를 사용자 정의하여). 자세한 내용은 ‘ Kubernetes ’ 문서를 참조하십시오.

시작하기 전에: 계정에 로그인하십시오. If applicable, target the appropriate resource group. 클러스터에 대한 컨텍스트를 설정하십시오.

1. NodeLocal DNS 캐시 디먼 세트가 사용 가능한지 확인하십시오.

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

   출력 예

   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. NodeLocal DNS 캐시에 configmap이 있는지 확인하십시오.

   1. NodeLocal DNS 캐시 configmap이 있는지 여부를 결정하십시오.

       kubectl get cm -n kube-system node-local-dns-config
       ```
       Configmap이 없는 경우 출력 예
   
       ```sh {: screen}
       Error from server (NotFound): ConfigMaps "node-local-dns-config" not found
       ```
   2. configmap이 없는 경우, `NodeLocal` DNS 캐시 configmap을 작성하십시오.
   
   ```sh {: pre}
       kubectl create cm -n kube-system node-local-dns-config
       ```
       출력 예
   
       ```sh {: screen}
       configmap/node-local-dns-config created
       ```
   

3. NodeLocal DNS 캐시 configmap을 편집하십시오. configmap은 KubeDNS 구문을 사용하여 스텁 도메인 및 업스트림 DNS 서버를 사용자 정의합니다. 자세한 내용은 ‘ Kubernetes ’ 문서를 참조하십시오.

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

   출력 예

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

4. 몇 분 후에 NodeLocal DNS 캐시 팟(Pod)이 configmap 변경사항을 선택합니다.

구역 인식 DNS 설정

다중 구역 클러스터에서 구역 인식 DNS를 설정하려면 다음 단계를 완료하십시오.

1. 존 인식 DNS의 영향을 받는 모든 DNS 아웃바운드 네트워크 정책 (예: DNS 아웃바운드에 팟 또는 네임스페이스 선택자를 사용하는 정책 등)을 업데이트하십시오. 네트워크 정책 목록을 확인하려면 다음 명령을 실행하십시오.

   kubectl get networkpolicy --all-namespaces -o yaml
   

2. kube-system 네임스페이스의 coredns ConfigMap 에 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. 클러스터 마스터 새로 고치기 를 수행하여 구역 인식 DNS 자원을 배치하십시오.

   ibmcloud ks cluster master refresh -c CLUSTER_NAME_OR_ID
   

4. 클러스터 세부사항의 Master Health를 검토하여 새로 고치기 오퍼레이션이 완료되는 것을 지켜보십시오.

   ibmcloud ks cluster get -c CLUSTER_NAME_OR_ID
   

5. CoreDNS의 스텁 도메인 및 업스트림 DNS 서버를 사용자 정의한 경우, 이러한 스텁 도메인 및 업스트림 DNS 서버에서 NodeLocal DNS 캐시를 사용자 정의해야 합니다.

6. 클러스터의 구역에 대한 환경 변수를 설정하십시오.

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

7. 모든 구역에서 CoreDNS 및 CoreDNS 오토스케일러 팟(Pod)을 시작하십시오.

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

8. 모든 구역에서 CoreDNS 및 CoreDNS 오토스케일러 팟(Pod)이 실행 중인지 확인하십시오.

   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. 모든 작업자 노드에서 NodeLocal DNS 캐시 팟(Pod)을 시작하십시오.

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

10. 모든 작업자 노드에서 NodeLocal DNS 캐시 팟(Pod)이 실행 중인지 확인하십시오.

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

11. 워커 풀에 레이블을 지정하여, 향후 워커 노드가 ‘ ibm-cloud.kubernetes.io/zone-aware-dns-enabled=true ’ 레이블을 상속받도록 하십시오.

구역 인식 DNS 사용 안함 및 삭제

구역 인식 DNS를 제거하려면 먼저 다중 구역 클러스터의 각 구역에서 구역 인식 DNS 리소스를 사용 안함으로 설정해야 합니다. 그런 다음 구역 인식 DNS 리소스를 삭제하십시오.

1. ibm-cloud.kubernetes.io/zone-aware-dns-enabled=true 레이블을 작업자 풀에서 제거하십시오.

2. 클러스터의 구역에 대한 환경 변수를 설정하십시오.

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

3. 모든 작업자 노드에서 NodeLocal DNS 캐시 팟(Pod)을 중지하십시오.

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

4. 모든 구역에서 CoreDNS 오토스케일러 팟(Pod)을 중지하십시오.

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

5. 모든 구역에서 CoreDNS 오토스케일러 팟(Pod)이 더 이상 실행 중이 아닌지 확인하십시오.

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

6. 모든 구역에서 CoreDNS 팟(Pod)을 중지하십시오.

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

7. ibm-cloud.kubernetes.io/deploy-zone-aware-dns=true 네임스페이스의 coredns configmap에서 kube-system 레이블을 제거하십시오.

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

8. 클러스터 마스터를 새로 고쳐 구역 인식 DNS 리소스를 삭제하십시오.

   ibmcloud ks cluster master refresh --cluster CLUSTER_NAME_OR_ID
   

9. 클러스터 세부사항의 Master Health를 검토하여 새로 고치기 오퍼레이션이 완료되는 것을 지켜보십시오.

   ibmcloud ks cluster get -c CLUSTER_NAME_OR_ID