第7章 OpenShift Container Platform の DNS Operator
OpenShift Container Platform の DNS Operator は、CoreDNS インスタンスをデプロイおよび管理して、クラスター内の Pod に名前解決サービスを提供し、DNS ベースの Kubernetes Service 検出を有効にし、内部の cluster.local 名を解決します。
7.1. DNS Operator のステータスを確認します。 リンクのコピーリンクがクリップボードにコピーされました!
DNS Operator のデプロイメントとクラスター Operator のステータスを確認できます。DNS Operator は、インストール時に Deployment オブジェクトを使用してデプロイされます。
DNS Operator は、operator.openshift.io API グループから dns API を実装します。この Operator は、デーモンセットを使用して CoreDNS をデプロイし、デーモンセットのサービスを作成し、kubelet を Pod に対して名前解決に CoreDNS サービス IP を使用するように指示するように設定します。
手順
oc getコマンドを使用してデプロイメントのステータスを表示します。$ oc get -n openshift-dns-operator deployment/dns-operator出力例
NAME READY UP-TO-DATE AVAILABLE AGE dns-operator 1/1 1 1 23hoc getコマンドを使用して DNS Operator の状態を表示します。$ oc get clusteroperator/dns出力例
NAME VERSION AVAILABLE PROGRESSING DEGRADED SINCE MESSAGE dns 4.1.15-0.11 True False False 92mAVAILABLE、PROGRESSING、およびDEGRADEDは、Operator のステータスに関する情報を示します。AVAILABLEがTrueになるのは、CoreDNS デーモンセットの 1 つ以上の Pod がAvailableステータス条件を報告し、DNS サービスがクラスター IP アドレスを持っている場合です。
7.2. デフォルト DNS の表示 リンクのコピーリンクがクリップボードにコピーされました!
デフォルトの DNS リソースとクラスター DNS の設定を表示して、DNS 設定を確認したり、DNS の問題をトラブルシューティングしたりできます。
すべての新規 OpenShift Container Platform インストールには、default という名前の dns.operator があります。
手順
oc describeコマンドを使用してデフォルトのdnsを表示します。$ oc describe dns.operator/default出力例
Name: default Namespace: Labels: <none> Annotations: <none> API Version: operator.openshift.io/v1 Kind: DNS ... Status: Cluster Domain: cluster.local Cluster IP: 172.30.0.10 ...各項目の説明:
Status.Cluster Domain- 完全修飾 Pod およびサービスドメイン名を作成するために使用されるベース DNS ドメインを指定します。
Status.Cluster IP- Pod が名前解決のために照会するアドレスを指定します。IP は、サービス CIDR 範囲の 10 番目のアドレスで定義されます。
クラスターのサービス CIDR 範囲 (
172.30.0.0/16など) を確認するには、oc getコマンドを使用します。$ oc get networks.config/cluster -o jsonpath='{$.status.serviceNetwork}'
7.3. DNS 転送を使用する リンクのコピーリンクがクリップボードにコピーされました!
クラスターの DNS 転送サーバーとアップストリームリゾルバーを設定します。
次の方法で、DNS 転送を使用して /etc/resolv.conf ファイル内のデフォルトの転送設定をオーバーライドできます。
-
すべてのゾーンにネームサーバー (
spec.servers) を指定します。転送されるゾーンが OpenShift Container Platform によって管理される Ingress ドメインである場合、そのドメインに対してアップストリームのネームサーバーが許可されている必要があります。 -
アップストリーム DNS サーバーのリスト (
spec.upstreamResolvers) を指定します。 - デフォルトの転送ポリシーを変更します。
デフォルトドメインの DNS 転送設定には、/etc/resolv.conf ファイルおよびアップストリーム DNS サーバーで指定されたデフォルトのサーバーの両方を設定できます。
Pod の作成時、Kubernetes はノード上に存在する /etc/resolv.conf ファイルを使用します。ホストノード上の /etc/resolv.conf ファイルを変更しても、その変更はコンテナー内に存在する /etc/resolv.conf ファイルには反映されません。変更を有効にするには、コンテナーを再作成する必要があります。
手順
defaultという名前の DNS Operator オブジェクトを変更します。$ oc edit dns.operator/default上記のコマンドを実行すると、Operator が、
spec.serversに基づく追加のサーバー設定ブロックを使用してdns-defaultという名前の config map を作成および更新します。クエリーに一致するゾーンがサーバーにない場合には、名前解決はアップストリーム DNS サーバーにフォールバックします。DNS 転送の設定
apiVersion: operator.openshift.io/v1 kind: DNS metadata: name: default spec: cache: negativeTTL: 0s positiveTTL: 0s logLevel: Normal nodePlacement: {} operatorLogLevel: Normal servers: - name: example-server zones: - example.com forwardPlugin: policy: Random upstreams: - 1.1.1.1 - 2.2.2.2:5353 upstreamResolvers: policy: Random protocolStrategy: "" transportConfig: {} upstreams: - type: SystemResolvConf - type: Network address: 1.2.3.4 port: 53 status: clusterDomain: cluster.local clusterIP: x.y.z.10 conditions: ...各項目の説明:
spec.servers.name-
rfc6335サービス名の構文に準拠する必要があります。 spec.servers.zones-
rfc1123のサブドメイン構文に準拠する必要があります。クラスタードメインのcluster.localはzonesに対して無効です。 spec.servers.forwardPlugin.policy-
アップストリーム選択ポリシーを指定します。デフォルトは
Randomで、指定可能な値はRoundRobinとSequentialです。 spec.servers.forwardPlugin.upstreams-
forwardPluginごとに 15 個を超えるupstreamsエントリーを指定しないでください。 spec.upstreamResolvers.upstreams-
デフォルトの転送ポリシーをオーバーライドし、デフォルトドメインの指定された DNS リゾルバー (アップストリームリゾルバー) に DNS 解決を転送するために、
upstreamResolversを指定します。カスタムのアップストリームリゾルバーが必要な場合にこのフィールドを使用できます。それ以外の場合、クエリーは/etc/resolv.confで宣言されているサーバーを使用します。 spec.upstreamResolvers.policy-
アップストリームの選択順序を指定します。デフォルトは
Sequentialで、指定可能な値はRandom、RoundRobin、Sequentialです。 spec.upstreamResolvers.protocolStrategy-
要求が UDP を使用している場合でも、アップストリーム DNS 要求に強制的に使用するプロトコルとして
TCPを指定します。有効な値はTCPで、省略することもできます。省略すると、デフォルト (通常は元のクライアント要求のプロトコル) が選択されます。 spec.upstreamResolvers.transportConfig- DNS 要求をアップストリームリゾルバーに転送するときに使用するトランスポートタイプ、サーバー名、およびオプションのカスタム CA または CA バンドルを指定します。
spec.upstreamResolvers.upstreams.type-
2 種類の
upstreams(SystemResolvConfまたはNetwork) を指定します。SystemResolvConfで、アップストリームが/etc/resolv.confを使用するように設定して、NetworkでNetworkresolverを定義します。1 つまたは両方を指定できます。 spec.upstreamResolvers.upstreams.address-
タイプが
Networkの場合、有効な IPv4 または IPv6 アドレスを指定します。 spec.upstreamResolvers.upstreams.port-
ポート番号を指定するためのオプションフィールドを指定します。有効な値は
1から65535です。省略した場合はデフォルト値として 853 が使用されます。
7.4. DNS Operator ステータスの確認 リンクのコピーリンクがクリップボードにコピーされました!
oc describe コマンドを使用して、DNS Operator のステータスを検査し、その詳細を表示することができます。
手順
DNS Operator のステータスを表示します。
$ oc describe clusteroperators/dnsメッセージとスペルはリリースによって異なる場合がありますが、期待されるステータス出力は次のようになります。
Status: Conditions: Last Transition Time: <date> Message: DNS "default" is available. Reason: AsExpected Status: True Type: Available Last Transition Time: <date> Message: Desired and current number of DNSes are equal Reason: AsExpected Status: False Type: Progressing Last Transition Time: <date> Reason: DNSNotDegraded Status: False Type: Degraded Last Transition Time: <date> Message: DNS default is upgradeable: DNS Operator can be upgraded Reason: DNSUpgradeable Status: True Type: Upgradeable
7.5. DNS Operator ログの表示 リンクのコピーリンクがクリップボードにコピーされました!
oc logs コマンドを使用すると、DNS Operator のログを表示して、DNS の問題のトラブルシューティング、設定変更の確認、アクティビティーの監視を行うことができます。
手順
次のコマンドを実行して、DNS Operator のログを表示します。
$ oc logs -n openshift-dns-operator deployment/dns-operator -c dns-operator
7.6. CoreDNS ログレベルの設定 リンクのコピーリンクがクリップボードにコピーされました!
CoreDNS のログレベルを設定して、DNS エラーロギングの詳細を制御できます。
CoreDNS と CoreDNS Operator のログレベルは、それぞれ異なる方法を使用して設定します。CoreDNS ログレベルを設定して、ログに記録されたエラーメッセージの情報量を決定できます。CoreDNS ログレベルの有効な値は、Normal、Debug、および Trace です。デフォルトの logLevel は Normal です。
CoreDNS のエラーログレベルは常に有効です。次のログレベル設定では、それぞれ異なるエラー応答が報告されます。
-
logLevel:Normalは "errors" class:log . { class error }を有効にします。 -
logLevel:Debugは "denial" class:log . { class denial error }を有効にします。 -
logLevel:Traceは "all" class:log . { class all }を有効にします。
手順
logLevelをDebugに設定するには、次のコマンドを入力します。$ oc patch dnses.operator.openshift.io/default -p '{"spec":{"logLevel":"Debug"}}' --type=mergelogLevelをTraceに設定するには、次のコマンドを入力します。$ oc patch dnses.operator.openshift.io/default -p '{"spec":{"logLevel":"Trace"}}' --type=merge
検証
目的のログレベルが設定されていることを確認するには、config map を確認します。
$ oc get configmap/dns-default -n openshift-dns -o yamlたとえば、
logLevelをTraceに設定すると、各サーバーブロックに次のスタンザが表示されます。errors log . { class all }
7.7. CoreDNS ログの表示 リンクのコピーリンクがクリップボードにコピーされました!
oc logs コマンドを使用して CoreDNS Pod のログを表示し、DNS の問題をトラブルシューティングできます。
手順
特定の CoreDNS Pod のログを表示するには、次のコマンドを入力します。
$ oc -n openshift-dns logs -c dns <core_dns_pod_name>すべての CoreDNS Pod のログを追跡するには、次のコマンドを入力します。
$ oc -n openshift-dns logs -c dns -l dns.operator.openshift.io/daemonset-dns=default -f --max-log-requests=<number>1 -
<number>: ログをストリーミングする DNS Pod の数を指定します。最大は 6 です。
-
7.8. CoreDNS Operator のログレベルの設定 リンクのコピーリンクがクリップボードにコピーされました!
Operator ログレベルを設定して、OpenShift DNS の問題を迅速に追跡できます。
operatorLogLevel の有効な値は、Normal、Debug、および Trace です。Trace には最も詳細にわたる情報が含まれます。デフォルトの operatorlogLevel は Normal です。Operator の問題のログレベルには、Trace、Debug、Info、Warning、Error、Unrecoverable、および Panic の 7 つがあります。ログレベルの設定後に、その重大度またはそれを超える重大度のログエントリーがログに記録されます。
-
operatorLogLevel: "Normal"はlogrus.SetLogLevel("Info")を設定します。 -
operatorLogLevel: "Debug"はlogrus.SetLogLevel("Debug")を設定します。 -
operatorLogLevel: "Trace"はlogrus.SetLogLevel("Trace")を設定します。
手順
operatorLogLevelをDebugに設定するには、次のコマンドを入力します。$ oc patch dnses.operator.openshift.io/default -p '{"spec":{"operatorLogLevel":"Debug"}}' --type=mergeoperatorLogLevelをTraceに設定するには、次のコマンドを入力します。$ oc patch dnses.operator.openshift.io/default -p '{"spec":{"operatorLogLevel":"Trace"}}' --type=merge
検証
結果の変更を確認するには、次のコマンドを入力します。
$ oc get dnses.operator -A -oyaml2 つのログレベルのエントリーが表示されるはずです。
operatorLogLevelは OpenShift DNS Operator の問題に適用され、logLevelは CoreDNS Pod のデーモンセットに適用されます。logLevel: Trace operatorLogLevel: Debugデーモンセットのログを確認するには、次のコマンドを入力します。
$ oc logs -n openshift-dns ds/dns-default
7.9. CoreDNS キャッシュの調整 リンクのコピーリンクがクリップボードにコピーされました!
CoreDNS の場合、成功または失敗したキャッシュ (それぞれポジティブキャッシュまたはネガティブキャッシュとも呼ばれます) の最大期間を設定できます。DNS クエリー応答のキャッシュ期間をチューニングすると、アップストリーム DNS リゾルバーの負荷を軽減できます。
TTL フィールドを低い値に設定すると、クラスター、上流のリゾルバー、またはその両方の負荷が増加する可能性があります。
手順
次のコマンドを実行して、
defaultという名前の DNS Operator オブジェクトを編集します。$ oc edit dns.operator.openshift.io/defaultTime-to-Live (TTL) キャッシュ値を変更します。
DNS キャッシングの設定
apiVersion: operator.openshift.io/v1 kind: DNS metadata: name: default spec: cache: positiveTTL: 1h negativeTTL: 0.5h10m各項目の説明:
spec.cache.positiveTTL-
CoreDNS によって秒数に変換される文字列値を指定します。このフィールドを省略した場合、値は
0sと見なされ、クラスターはフォールバックとして内部デフォルト値の900sを使用します。 spec.cache.negativeTTL-
CoreDNS によって秒数に変換される文字列値を指定します。このフィールドを省略した場合、値は
0sと見なされ、クラスターはフォールバックとして内部デフォルト値の30sを使用します。
検証
変更を確認するには、次のコマンドを実行して config map を再度確認します。
$ oc get configmap/dns-default -n openshift-dns -o yaml次の例のようなエントリーが表示されていることを確認します。
cache 3600 { denial 9984 2400 }
7.9.1. DNS Operator managementState の変更 リンクのコピーリンクがクリップボードにコピーされました!
デフォルトの Managed 状態から Unmanaged に変更すると DNS Operator はリソースの管理を停止するため、回避策の適用や設定変更のテストを行えます。
DNS Operator は、CoreDNS コンポーネントを管理し、クラスター内の Pod とサービスに名前解決サービスを提供します。DNS Operator の managementState は、デフォルトで Managed に設定されます。これは、DNS Operator がそのリソースをアクティブに管理していることを意味します。これを Unmanaged に変更できます。つまり、DNS Operator がそのリソースを管理していないことを意味します。
以下は、DNS Operator managementState を変更するためのユースケースです。
-
開発者は、CoreDNS の問題が修正されているかどうかを確認するために、設定変更をテストする必要があります。
managementStateをUnmanagedに設定することで、DNS Operator による設定変更の上書きを防止できます。 -
クラスター管理者は、CoreDNS の問題を報告していますが、問題が修正されるまで回避策を適用する必要があります。DNS Operator の
managementStateフィールドをUnmanagedに設定して、回避策を適用できます。
managementState が Unmanaged に設定されている間はアップグレードできません。
手順
次のコマンドを実行して、DNS Operator の
managementStateをUnmanagedに変更します。oc patch dns.operator.openshift.io default --type merge --patch '{"spec":{"managementState":"Unmanaged"}}'jsonpathコマンドライン JSON パーサーを使用して DNS Operator のmanagementStateを確認します。$ oc get dns.operator.openshift.io default -ojsonpath='{.spec.managementState}'
7.9.2. DNS Pod 配置の制御 リンクのコピーリンクがクリップボードにコピーされました!
taint、toleration、セレクターを使用して、CoreDNS および node-resolver Pod の実行場所を制御します。
DNS Operator には 2 つのデーモンセットがあります。1 つは CoreDNS 用の dns-default という名前のデーモンセットで、もう 1 つは /etc/hosts ファイルの管理用の node-resolver という名前のデーモンセットです。
指定したノードに CoreDNS Pod を割り当て、そのノード上で実行できます。たとえば、クラスター管理者がノードペア間の通信を禁止するセキュリティーポリシーを設定している場合は、制限されたノードセットで実行するように CoreDNS Pod を設定できます。
次の状況が当てはまる場合、すべての Pod で DNS サービスを使用できます。
- クラスター内の一部のノードで DNS Pod が実行されている。
- DNS Pod が実行されていないノードに、DNS Pod が実行されているノードとのネットワーク接続がある。
node-resolver デーモンセットは、すべてのノードホストで実行する必要があります。このデーモンセットにより、イメージのプルをサポートするクラスターイメージレジストリーのエントリーが追加されるためです。node-resolver Pod には、1 つのジョブのみがあります。コンテナーランタイムがサービス名を解決できるように、image-registry.openshift-image-registry.svc サービスのクラスター IP アドレスを検索し、それをノードホストの /etc/hosts に追加するジョブです。
クラスター管理者は、カスタムノードセレクターを使用して、CoreDNS のデーモンセットを特定のノードで実行するか、実行しないように設定できます。
前提条件
-
ocCLI がインストールされている。 -
cluster-admin権限を持つユーザーとしてクラスターにログインしている。 -
DNS Operator の
managementStateがManagedに設定されている。
手順
CoreDNS のデーモンセットを特定のノードで実行できるようにするために、taint と toleration を設定します。
次のコマンドを入力して、DNS Pod の配置を制御するノードに taint を設定します。
$ oc adm taint nodes <node_name> dns-only=abc:NoExecute-
<node_name>は、ノードの実際の名前に置き換えます。
-
次のコマンドを入力して、
defaultという名前の DNS Operator オブジェクトを、対応する toleration が含まれるように変更します。$ oc edit dns.operator/defaulttaint の taint キーと toleration を指定します。次の toleration は、ノードに設定された taint と一致します。
apiVersion: operator.openshift.io/v1 kind: DNS metadata: name: default spec: nodePlacement: tolerations: - effect: NoExecute key: "dns-only" operator: Equal value: abc tolerationSeconds: 3600-
keyフィールドがdns-onlyに設定されている場合、永久的に許容されます。 -
tolerationSecondsフィールドはオプションです。
-
オプション: ノードセレクターを使用してノードの配置を指定するには、デフォルトの DNS Operator を変更します。
defaultという名前の DNS Operator オブジェクトを編集して、ノードセレクターを含めます。apiVersion: operator.openshift.io/v1 kind: DNS metadata: name: default spec: nodePlacement: nodeSelector: node-role.kubernetes.io/control-plane: ""-
例にある
spec.nodePlacement.nodeSelectorフィールドにより、CoreDNS Pod はコントロールプレーンノード上でのみ実行されるようになります。
-
例にある
7.9.3. TLS を使用して DNS 転送を設定する リンクのコピーリンクがクリップボードにコピーされました!
TLS を使用した DNS 転送を設定することで、アップストリームのリゾルバーへのクエリーを保護できます。
高度に規制された環境で作業する場合は、要求をアップストリームリゾルバーに転送する際に DNS トラフィックのセキュリティーを確保して、追加の DNS トラフィックおよびデータのプライバシーを確保できるようにする必要がある場合があります。
CoreDNS は転送された接続を 10 秒間キャッシュすることに注意してください。要求が発行されない場合、CoreDNS はその 10 秒間、TCP 接続を開いたままにします。
大規模なクラスターでは、ノードごとに接続を開始できるため、DNS サーバーが多くの新しい接続を開いたまま保持する可能性があることを認識しているか確認してください。パフォーマンスの問題を回避するために、それに応じて DNS 階層を設定します。
手順
defaultという名前の DNS Operator オブジェクトを変更します。$ oc edit dns.operator/defaultクラスター管理者は、転送された DNS クエリーに Transport Layer Security (TLS) を設定できるようになりました。
TLS を使用した DNS 転送の設定
apiVersion: operator.openshift.io/v1 kind: DNS metadata: name: default spec: servers: - name: example_server zones: - example.com forwardPlugin: transportConfig: transport: TLS tls: caBundle: name: mycacert serverName: dnstls.example.com policy: Random upstreams: - 1.1.1.1 - 2.2.2.2:5353 upstreamResolvers: transportConfig: transport: TLS tls: caBundle: name: mycacert serverName: dnstls.example.com upstreams: - type: Network address: 1.2.3.4 port: 53各項目の説明:
spec.servers.name-
rfc6335サービス名の構文に準拠する必要があります。 spec.servers.zones-
rfc1123のサブドメイン構文に準拠する必要があります。クラスタードメインのcluster.localはzonesに対して無効です。 spec.servers.forwardPlugin.transportConfig.transport-
TLS 転送を設定する場合は、必ず
TLSに設定する必要があります。 spec.servers.forwardPlugin.transportConfig.tls.serverName- アップストリームの TLS 証明書を検証するために使用される Server Name Indication (SNI) サーバーの名前に設定する必要があります。
spec.servers.forwardPlugin.policy-
アップストリーム選択ポリシーを指定します。デフォルトは
Randomで、有効な値はRoundRobinとSequentialです。 spec.servers.forwardPlugin.upstreams-
アップストリームリゾルバーを提供する必要があります (
forwardPluginごとに最大 15 エントリー)。 spec.upstreamResolvers.upstreams-
デフォルトドメインのデフォルトポリシーをオーバーライドするためのオプションフィールドを指定します。TLS が有効になっている場合にのみ
Networkタイプを使用し、IP アドレスを指定します。省略した場合、クエリーは/etc/resolv.confを使用します。 spec.upstreamResolvers.upstreams.address- 有効な IPv4 または IPv6 アドレスである必要があります。
spec.upstreamResolvers.upstreams.portポート番号を指定するためのオプションフィールドを指定します。有効な値は
1から65535です。省略した場合はデフォルト値として 853 が使用されます。注記serversが定義されていないか無効な場合、config map にはデフォルトサーバーのみが含まれます。
検証
config map を表示します。
$ oc get configmap/dns-default -n openshift-dns -o yamlTLS 転送の例に基づく DNS ConfigMap のサンプル
apiVersion: v1 data: Corefile: | example.com:5353 { forward . 1.1.1.1 2.2.2.2:5353 } bar.com:5353 example.com:5353 { forward . 3.3.3.3 4.4.4.4:5454 } .:5353 { errors health kubernetes cluster.local in-addr.arpa ip6.arpa { pods insecure upstream fallthrough in-addr.arpa ip6.arpa } prometheus :9153 forward . /etc/resolv.conf 1.2.3.4:53 { policy Random } cache 30 reload } kind: ConfigMap metadata: labels: dns.operator.openshift.io/owning-dns: default name: dns-default namespace: openshift-dns-
data.Corefileキーには、DNS サーバーの Corefile 設定が含まれています。forwardPluginへの変更により、CoreDNS デーモンセットのローリング更新がトリガーされます。
-