このドキュメントでは、Google Distributed Cloud のドメイン ネーム システム（DNS）プロバイダ オプションを構成する方法について説明します。クラスタの DNS 構成は、default という名前の ClusterDNS カスタム リソースに保持されます。このリソースはクラスタ全体にわたります。つまり、Namespace はありません。ClusterDNS カスタム リソースは、すべてのクラスタタイプに適用されます。
ClusterDNS リソースを作成する
default という名前の ClusterDNS リソースのマニフェストを作成します。必要に応じて spec を設定します。例:
apiVersion: networking.gke.io/v1alpha1
kind: ClusterDNS
metadata:
name: default
spec:
upstreamNameservers:
- serverIP: 8.8.8.8
- serverIP: 8.8.4.4
domains:
- name: altostrat.com
nameservers:
- serverIP: 198.51.100.0.1
- name: my-own-personal-domain.com
- serverIP: 203.0.113.1
- serverIP: 203.0.113.2
serverPort: 54
googleAccess: default
マニフェストを my-dns.yaml という名前のファイルに保存して、リソースをクラスタに適用します。
kubectl --kubeconfig KUBECONFIG apply -f my-dns.yaml
KUBECONFIG は、クラスタの kubeconfig ファイルのパスに置き換えます。
ClusterDNS リソースを表示する
ClusterDNS リソースを表示するには:
kubectl --kubeconfig KUBECONFIG get clusterdns default --output yaml
KUBECONFIG は、クラスタの kubeconfig ファイルのパスに置き換えます。
ClusterDNS の仕様
以下の各セクションでは、クラスタの DNS を構成するために使用する ClusterDNS カスタム リソース定義の一部について説明します。クラスタの ClusterDNS リソースはいつでも更新できます。
spec.upstreamNameservers
デフォルトのアップストリーム ネームサーバーを、それぞれがサーバー IP アドレスと、必要に応じてサーバーポートを備えるオブジェクトの配列とともに指定します。サーバーポートのデフォルト値は 53 です。クラスタ以外のドメインのリクエストは、デフォルトでこのサーバー アドレスの配列に転送されます。
以下は、upstreamNameservers 構成の例です。
spec:
upstreamNameservers:
- serverIP: 8.8.8.8
- serverIP: 1.2.3.4
serverPort: 54
upstreamNameservers の値を指定しない場合、DNS プロバイダはノード上の /etc/resolve.conf ファイルを使用して、アップストリーム ネームサーバーのリストを検索します。
spec.domains
特定のドメインの構成。このセクションを使用して、特定のドメイン用に異なるアップストリーム ネームサーバーを構成します。これらのドメイン特有のネームサーバーの設定は、upstreamNameservers の構成をオーバーライドします。
ドメインのクエリロギングをオンにすることもできます。任意に指定されたドメインまたはクラスタ ドメイン（cluster.local）に対してクエリロギングを有効にできます。
例:
spec:
domains:
- name: altostrat.com
nameservers:
- serverIP: 203.0.113.1
- name: my-own-personal-domain.com
nameservers:
- serverIP: 198.51.100.1
- serverIP: 198.51.100.2
serverPort: 50000
- name: cluster.local
queryLogging: true
spec.googleAccess
列挙（private、restricted、default）。Google ドメインの処理方法を指定します。googleAccess 値は、次の動作を指定します。
default: Google ドメインの特別な処理はありません。googleAccessフィールドを削除しても結果は同じです。private: Google ドメインは、プライベート アクセス IP アドレスにのみ名前解決されます。restricted: Google ドメインは、アクセス制限付き IP アドレスにのみ名前解決されます。
次の設定例では、Google ドメインはプライベート アクセス IP アドレスにのみ名前解決されます。
spec:
googleAccess: private
詳細については、オンプレミス ホスト用の限定公開の Google アクセスの構成をご覧ください。