Container Service for Kubernetes:NodeLocal DNSCache の構成

方法 1: DNSConfig を自動的に挿入する

アドミッションコントローラーを使用して、新しく作成されたポッドに DNSConfig を自動的に挿入できます。こうすることで、ポッドの YAML ファイルを手動で構成する必要がなくなります。デフォルトでは、アプリケーションは、node-local-dns-injection=enabled ラベルが付いた名前空間からのポッド作成リクエストをリッスンします。次のコマンドを使用して、このラベルを名前空間に追加できます。

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

DNSConfig の自動挿入が有効になると、新しく作成されたポッドに次のパラメーターが追加されます。 DNS サービスの高可用性を確保するために、kube-dns のクラスター IP アドレスがバックアップ DNS サーバーとして nameservers パラメーターに追加されます。

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

DNSConfig の自動挿入は、ポッドが次のすべての要件を満たしている場合にのみ有効になります。ポッド内のコンテナーに DNS サーバーの IP アドレスが挿入されていない場合は、ポッドがこれらの要件を満たしているかどうかを確認する必要があります。

• 新しく作成されたポッドは、kube-system または kube-public 名前空間に属していません。

• 新しく作成されたポッドが属する名前空間には、node-local-dns-injection=enabled ラベルが付いています。

• 新しく作成されたポッドが属する名前空間には、virtual-node-affinity-injection、eci、alibabacloud.com/eci などの Elastic Container Instance に関連するラベルが付いていません。

• 新しく作成されたポッドには、eci や alibabacloud.com/eci などの Elastic Container Instance に関連するラベル、または node-local-dns-injection=disabled ラベルが付いていません。

• 新しく作成されたポッドは、hostNetwork ネットワークと ClusterFirstWithHostNet DNS ポリシーを使用するか、hostNetwork ネットワークを使用せずに ClusterFirst DNS ポリシーを使用します。

方法 2: DNSConfig を手動で指定する

アドミッション Webhook を使用して DNSConfig を自動的に挿入したくない場合は、ポッド構成を変更して DNSConfig を手動で指定できます。

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"

• dnsPolicy: 値を None に設定します。

• nameservers: 値を 169.254.20.10 と kube-dns のクラスター IP アドレスに設定します。

• searches: DNS 検索ドメインを設定します。内部ドメイン名が解決できることを確認してください。

• ndots: このパラメーターを小さい値に設定することで、解決効率を向上させることができます。デフォルト値：5。詳細については、resolv.conf を参照してください。

方法 3: kubelet 起動パラメーターを構成する

kubelet は、--cluster-dns パラメーターと --cluster-domain パラメーターを使用して、ポッド DNSConfig を制御します。/etc/systemd/system/kubelet.service.d/10-kubeadm.conf ファイルで、--cluster-dns パラメーターを追加し、値をローカル IP アドレス 169.254.20.10 に設定します。次に、変更を有効にするために、sudo systemctl daemon-reload コマンドと sudo systemctl restart kubelet コマンドを実行します。

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

• cluster-dns: ポッド構成で使用される DNS サーバーを指定します。デフォルトでは、`kube-dns` の IP アドレスのみが指定されています。ローカル IP アドレス 169.254.20.10 を追加する必要があります。

• cluster-domain: ポッド構成で使用される DNS 検索ドメインを指定します。既存の検索ドメインを使用できます。ほとんどの場合、既存の検索ドメインは `cluster.local` です。

NodeLocal DNSCache を構成する例

次の例は、default 名前空間で作成された Deployment に対して NodeLocal DNSCache を構成する方法を示しています。

1. 次のコマンドを実行して、Deployment が属する名前空間にラベルを追加します。この例では、Deployment は default 名前空間に作成されます。

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

   重要

   アドミッションコントローラーは、kube-system 名前空間と kube-public 名前空間のアプリケーションを無視します。2 つの名前空間のアプリケーションに dnsConfig を自動的に挿入するように構成しないでください。

2. default 名前空間にサンプルアプリケーションをデプロイします。

   1. 次の YAML テンプレートを使用して、ubuntu-deployment という名前のサンプルアプリケーションを作成します。

      apiVersion: apps/v1 # 1.8.0 より前のバージョンでは apps/v1beta1 を使用します
      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"]

   2. 次のコマンドを実行して、クラスターにアプリケーションをデプロイします。

      kubectl apply -f ubuntu-deployment.yaml

      予期される出力：

      deployment.apps/ubuntu created

   3. 次のコマンドを実行して、アプリケーションに関する情報を表示します。

      kubectl get deployment ubuntu

      予期される出力：

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

3. dnsConfig が挿入されているかどうかを確認します。

   1. 次のコマンドを実行して、アプリケーションを実行しているポッドをクエリします。

      kubectl get pods

      予期される出力：

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

   2. 次のコマンドを実行して、ポッドの dnsConfig で NodeLocal DNSCache が有効になっているかどうかを確認します。

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

      予期される出力：

      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]]

      上記の出力は、アプリケーションに対して NodeLocal DNSCache が有効になっていることを示しています。

      アプリケーションに対して NodeLocal DNSCache が有効になると、アプリケーションにプロビジョニングされたポッドに次のパラメーターが追加されます。 DNS サービスの高可用性を確保するために、kube-dns サービスのクラスター IP アドレス 172.21.0.10 が、nameservers パラメーターのバックアップ DNS サーバーの IP アドレスとして指定されています。

        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