NodeLocal DNS キャッシュの有効化

Kubernetes クラスター内の 1 台以上のワーカー・ノードで NodeLocal DNS キャッシュを有効にします。

バージョン 1.35 以降

NodeLocal DNSはすべてのワーカーノードでデフォルトで有効になっています。 以前に NodeLocal DNS を無効にした場合、または NodeLocal DNS を無効にして新しいワーカーノードを追加する場合のみ、以下の手順に従ってください。

バージョン 1.34 およびそれ以前

NodeLocal DNSはオプトインである。 ワーカーノードで有効にするには、以下の手順に従ってください。

以下の手順で、特定のワーカー・ノードで実行される DNS ポッドを更新できます。 また、これ以降のノードがラベルを継承するようにワーカー・プールにラベルを付けることもできます。

作業を開始する前に、この機能の影響を受ける DNSアウトバウンドネットワークポリシー （たとえば、DNSアウトバウンドにPodやネームスペースのセレクタを使用しているポリシーなど）を更新してください。

kubectl get networkpolicy --all-namespaces -o yaml

1. アカウントにログインします。 該当する場合は、適切なリソース・グループをターゲットにします。 クラスターのコンテキストを設定します。

2. CoreDNS のスタブ・ドメインおよびアップストリーム DNS サーバーをカスタマイズした場合は、これらのスタブ・ドメインおよびアップストリーム DNS サーバーを使用して NodeLocal DNS キャッシュをカスタマイズする必要もあります。

3. クラスター内のノードをリストします。 NodeLocal DNS キャッシング・エージェント・ポッドは、各ノードで実行されるデーモン・セットに含まれています。

   kubectl get nodes
   

4. ibm-cloud.kubernetes.io/node-local-dns-enabled=true ラベルをワーカー・ノードに追加します。 このラベルは、ワーカー・ノード上の DNS キャッシング・エージェント・ポッドを開始します。

   1. 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 キャッシング・エージェント・ポッドが実行されていることを確認します。
   
   ```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 キャッシュの無効化

1 台以上のワーカー・ノードで 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. アカウントにログインします。 該当する場合は、適切なリソース・グループをターゲットにします。 クラスターのコンテキストを設定します。

2. ワーカー・ノードから ibm-cloud.kubernetes.io/node-local-dns-enabled ラベルを削除します。 この操作により、ワーカー・ノード上の DNS キャッシング・エージェント・ポッドが終了します。

   クラスター内のすべてのワーカー・ノードからラベルを削除するには、以下のコマンドを実行します。

   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 キャッシュが無効になっているノードでポッドが実行されていないことを確認します。 出力にはポッドが表示されていません。
   
   ```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 構成マップの編集

node-local-dns 構成マップを編集して、NodeLocal DNS キャッシュ構成をカスタマイズします。

始める前に: アカウントにログインします。 該当する場合は、適切なリソース・グループをターゲットにします。 クラスターのコンテキストを設定します。

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 キャッシュ構成マップに追加します。 インポートする各 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 キャッシュ・ポッドで、構成マップの変更が反映されます。

スタブ・ドメインまたはアップストリーム・サーバーを使用して拡張するための node-local-dns-config 構成マップの編集

node-local-dns-config 構成マップを編集し、スタブ・ドメインまたはアップストリーム DNS サーバーのカスタマイズなどによって NodeLocal DNS キャッシュ構成を拡張します。 詳細については、『 Kubernetes 』のドキュメントを参照してください。

始める前に: アカウントにログインします。 該当する場合は、適切なリソース・グループをターゲットにします。 クラスターのコンテキストを設定します。

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 キャッシュに構成マップがあることを確認します。

   1. NodeLocal DNS キャッシュの構成マップが存在するかどうかを判別します。

       kubectl get cm -n kube-system node-local-dns-config
       ```
       構成マップが存在しない場合の出力例
   
       ```sh {: screen}
       Error from server (NotFound): ConfigMaps "node-local-dns-config" not found
       ```
   2. 構成マップが存在しない場合は、`NodeLocal` DNS キャッシュの構成マップを作成します。
   
   ```sh {: pre}
       kubectl create cm -n kube-system node-local-dns-config
       ```
       出力例
   
       ```sh {: screen}
       configmap/node-local-dns-config created
       ```
   

3. NodeLocal DNS キャッシュの構成マップを編集します。 構成マップで、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 キャッシュ・ポッドで、構成マップの変更が反映されます。

ゾーン対応 DNS のセットアップ

マルチゾーン・クラスターでゾーン対応 DNS をセットアップするには、以下のステップを実行します。

1. ゾーン認識型DNSの影響を受ける DNS送信ネットワークポリシー （たとえば、DNS送信にPodやネームスペースのセレクタを利用しているポリシーなど）をすべて更新してください。 ネットワークポリシーのリストを取得するには、次のコマンドを実行してください。

   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 自動スケーリング機能ポッドを開始します。

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

8. すべてのゾーンで CoreDNS と CoreDNS 自動スケーリング機能ポッドが実行されていることを確認します。

   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 キャッシュ・ポッドを開始します。

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

10. すべてのワーカー・ノードで NodeLocal DNS キャッシュ・ポッドが実行されていることを確認します。

    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 キャッシュ・ポッドを停止します。

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

4. すべてのゾーンで CoreDNS 自動スケーリング機能ポッドを停止します。

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

5. すべてのゾーンで CoreDNS 自動スケーリング機能ポッドが実行されなくなったことを確認します。

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

6. すべてのゾーンで CoreDNS ポッドを停止します。

   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 名前空間の 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