Azure Kubernetes Service で CoreDNS をカスタマイズする

[アーティクル]
09/27/2022

Azure Kubernetes Service (AKS) は、すべての 1.12.x 以降のクラスターでクラスター DNS の管理と解決に CoreDNS プロジェクトを使用します。以前は、kube-dns プロジェクトが使用されました。この kube-dns プロジェクトは非推奨となっています。 CoreDNS のカスタマイズおよび Kubernetes について詳しくは、公式のアップストリームドキュメントを参照してください。

AKS はマネージドサービスであるため、CoreDNS のメイン構成 (CoreFile) を変更することはできません。代わりに、既定の設定をオーバーライドするには、Kubernetes ConfigMap を使用してください。既定の AKS CoreDNS ConfigMaps を表示するには、kubectl get configmaps --namespace=kube-system coredns -o yaml コマンドを使用してください。

この記事では、AKS の CoreDNS の基本的なカスタマイズオプションに ConfigMaps を使用する方法を説明します。この方法は、CoreFile の使用といった他のコンテキストでの CoreDNS の構成とは異なります。バージョンによって構成値が変わる可能性があるため、実行している CoreDNS のバージョンを確認してください。

Note

kube-dns では、Kubernetes 構成マップを介してさまざまなカスタマイズオプションが提供されていました。 CoreDNS には kube-dns との下位互換性はありません。以前に使用したカスタマイズはすべて、CoreDNS で使用するために更新する必要があります。

開始する前に

この記事は、AKS クラスターがすでに存在していることを前提としています。 AKS クラスターが必要であれば、Azure CLI を使用した場合、Azure PowerShell を使用した場合、または Azure portal を使用した場合の AKS クイックスタートを参照してください。

次の例のような構成を作成する場合、data セクション内の名前は .server または .override のいずれかで終わる必要があります。この名前付け規則は、kubectl get configmaps --namespace=kube-system coredns -o yaml コマンドを使用して表示できる既定の AKS CoreDNS Configmap で定義されています。

サポート対象/サポート対象外

組み込みの CoreDNS プラグインはすべてサポート対象です。アドオン/サードパーティ製のプラグインはサポート対象外です。

DNS を書き換える

シナリオの 1 つとして、その場で DNS 名の書き換えを実行する場合があります。次の例では、<domain to be written> を独自の完全修飾ドメイン名に置き換えます。 corednsms.yaml という名前のファイルを作成し、次の構成例を貼り付けます。

apiVersion: v1
kind: ConfigMap
metadata:
  name: coredns-custom
  namespace: kube-system
data:
  test.server: | # you may select any name here, but it must end with the .server file extension
    <domain to be rewritten>.com:53 {
    log
    errors
    rewrite stop {
      name regex (.*)\.<domain to be rewritten>.com {1}.default.svc.cluster.local
      answer name (.*)\.default\.svc\.cluster\.local {1}.<domain to be rewritten>.com
    }
    forward . /etc/resolv.conf # you can redirect this to a specific DNS server such as 10.0.0.10, but that server must be able to resolve the rewritten domain name
    }

重要

CoreDNS サービス IP などの DNS サーバーにリダイレクトする場合、その DNS サーバーは、書き換えられたドメイン名を解決できる必要があります。

kubectl apply configmap コマンドを使用して ConfigMap を作成し、YAML マニフェストの名前を指定します。

kubectl apply -f corednsms.yaml

カスタマイズが適用されたことを確認するには、kubectl get configmaps を使用し、coredns-custom ConfigMap を指定します。

kubectl get configmaps --namespace=kube-system coredns-custom -o yaml

ここで、ConfigMap の再読み込みを CoreDNS に強制します。 kubectl delete pod コマンドは破壊的なコマンドではなく、停止時間も発生しません。 kube-dns ポッドが削除され、Kubernetes スケジューラによってそれらのポッドが再作成されます。それらの新しいポッドには TTL 値の変更が含まれています。

kubectl delete pod --namespace kube-system -l k8s-app=kube-dns

Note

上記のコマンドは正しいです。 coredns の変更中は、デプロイは kube-dns ラベルによって実行されます。

カスタム転送サーバー

ネットワークトラフィックの転送サーバーを指定する必要がある場合は、DNS をカスタマイズするための ConfigMap を作成できます。次の例では、forward の名前とアドレスを自分の環境の値で更新します。 corednsms.yaml という名前のファイルを作成し、次の構成例を貼り付けます。

apiVersion: v1
kind: ConfigMap
metadata:
  name: coredns-custom
  namespace: kube-system
data:
  test.server: | # you may select any name here, but it must end with the .server file extension
    <domain to be rewritten>.com:53 {
        forward foo.com 1.1.1.1
    }

前述の例のように、kubectl apply configmap コマンドを使用して ConfigMap を作成し、YAML マニフェストの名前を指定します。次に、Kubernetes スケジューラで再作成するために、kubectl delete pod を使用して ConfigMap の再読み込みを CoreDNS に強制します。

kubectl apply -f corednsms.yaml
kubectl delete pod --namespace kube-system --selector k8s-app=kube-dns

カスタムドメインを使用する

内部的にしか解決できないカスタムドメインを構成する必要が生じる場合があります。たとえば、有効な最上位レベルのドメインではないカスタムドメイン puglife.local を解決したい場合があります。カスタムドメインの ConfigMap がないと、AKS クラスターはアドレスを解決できません。

次の例では、自分の環境の値で、トラフィックの送信先となるカスタムドメインと IP アドレスを更新します。 corednsms.yaml という名前のファイルを作成し、次の構成例を貼り付けます。

apiVersion: v1
kind: ConfigMap
metadata:
  name: coredns-custom
  namespace: kube-system
data:
  puglife.server: | # you may select any name here, but it must end with the .server file extension
    puglife.local:53 {
        errors
        cache 30
        forward . 192.11.0.1  # this is my test/dev DNS server
    }

kubectl apply -f corednsms.yaml
kubectl delete pod --namespace kube-system --selector k8s-app=kube-dns

スタブドメイン

CoreDNS を使用してスタブドメインを構成することもできます。次の例では、自分の環境の値でカスタムドメインと IP アドレスを更新します。 corednsms.yaml という名前のファイルを作成し、次の構成例を貼り付けます。

apiVersion: v1
kind: ConfigMap
metadata:
  name: coredns-custom
  namespace: kube-system
data:
  test.server: | # you may select any name here, but it must end with the .server file extension
    abc.com:53 {
        errors
        cache 30
        forward . 1.2.3.4
    }
    my.cluster.local:53 {
        errors
        cache 30
        forward . 2.3.4.5
    }

kubectl apply -f corednsms.yaml
kubectl delete pod --namespace kube-system --selector k8s-app=kube-dns

ホストのプラグイン

組み込みのプラグインがすべてサポートされるということは、CoreDNS Hosts プラグインもカスタマイズして使用できることを意味します。

apiVersion: v1
kind: ConfigMap
metadata:
  name: coredns-custom # this is the name of the configmap you can overwrite with your changes
  namespace: kube-system
data:
    test.override: | # you may select any name here, but it must end with the .override file extension
          hosts { 
              10.0.0.1 example1.org
              10.0.0.2 example2.org
              10.0.0.3 example3.org
              fallthrough
          }

トラブルシューティング

エンドポイントや解決策を調べるなど、CoreDNS の一般的なトラブルシューティング手順については、「DNS 解決のデバッグ」を参照してください。

DNS クエリのログ記録を有効にするには、次の構成を coredns-custom ConfigMap に適用します。

apiVersion: v1
kind: ConfigMap
metadata:
  name: coredns-custom
  namespace: kube-system
data:
  log.override: | # you may select any name here, but it must end with the .override file extension
        log

構成の変更を適用した後に、kubectl logs コマンドを使用して CoreDNS のデバッグログを表示します。次に例を示します。

kubectl logs --namespace kube-system --selector k8s-app=kube-dns

次のステップ

この記事では、CoreDNS カスタマイズのシナリオ例をいくつか紹介しました。 CoreDNS プロジェクトについては、CoreDNS アップストリームプロジェクトページを参照してください。

コアネットワークの概念の詳細については、「AKS でのアプリケーションに対するネットワークの概念」を参照してください。