第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 を使用するように指示するように設定します。

手順

  1. oc get コマンドを使用してデプロイメントのステータスを表示します。

    $ oc get -n openshift-dns-operator deployment/dns-operator

    出力例

    NAME           READY     UP-TO-DATE   AVAILABLE   AGE
    dns-operator   1/1       1            1           23h

  2. oc get コマンドを使用して DNS Operator の状態を表示します。

    $ oc get clusteroperator/dns

    出力例

    NAME      VERSION     AVAILABLE   PROGRESSING   DEGRADED   SINCE   MESSAGE
    dns       4.1.15-0.11  True        False         False      92m

    AVAILABLE、PROGRESSING、および DEGRADED は、Operator のステータスに関する情報を示します。AVAILABLE が True になるのは、CoreDNS デーモンセットの 1 つ以上の Pod が Available ステータス条件を報告し、DNS サービスがクラスター IP アドレスを持っている場合です。

7.2. デフォルト DNS の表示

デフォルトの DNS リソースとクラスター DNS の設定を表示して、DNS 設定を確認したり、DNS の問題をトラブルシューティングしたりできます。

すべての新規 OpenShift Container Platform インストールには、default という名前の dns.operator があります。

手順

  1. 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 番目のアドレスで定義されます。
  2. クラスターのサービス 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=merge
  • logLevel を 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=merge
  • operatorLogLevel を Trace に設定するには、次のコマンドを入力します。

    $ oc patch dnses.operator.openshift.io/default -p '{"spec":{"operatorLogLevel":"Trace"}}' --type=merge

検証

  1. 結果の変更を確認するには、次のコマンドを入力します。

    $ oc get dnses.operator -A -oyaml

    2 つのログレベルのエントリーが表示されるはずです。operatorLogLevel は OpenShift DNS Operator の問題に適用され、logLevel は CoreDNS Pod のデーモンセットに適用されます。

     logLevel: Trace
     operatorLogLevel: Debug
  2. デーモンセットのログを確認するには、次のコマンドを入力します。

    $ oc logs -n openshift-dns ds/dns-default

7.9. CoreDNS キャッシュの調整

CoreDNS の場合、成功または失敗したキャッシュ (それぞれポジティブキャッシュまたはネガティブキャッシュとも呼ばれます) の最大期間を設定できます。DNS クエリー応答のキャッシュ期間をチューニングすると、アップストリーム DNS リゾルバーの負荷を軽減できます。

警告

TTL フィールドを低い値に設定すると、クラスター、上流のリゾルバー、またはその両方の負荷が増加する可能性があります。

手順

  1. 次のコマンドを実行して、default という名前の DNS Operator オブジェクトを編集します。

    $ oc edit dns.operator.openshift.io/default
  2. Time-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 を使用します。

検証

  1. 変更を確認するには、次のコマンドを実行して config map を再度確認します。

    $ oc get configmap/dns-default -n openshift-dns -o yaml
  2. 次の例のようなエントリーが表示されていることを確認します。

           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 に設定されている間はアップグレードできません。

手順

  1. 次のコマンドを実行して、DNS Operator の managementState を Unmanaged に変更します。

    oc patch dns.operator.openshift.io default --type merge --patch '{"spec":{"managementState":"Unmanaged"}}'
  2. 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 のデーモンセットを特定のノードで実行するか、実行しないように設定できます。

前提条件

  • oc CLI がインストールされている。
  • cluster-admin 権限を持つユーザーとしてクラスターにログインしている。
  • DNS Operator の managementState が Managed に設定されている。

手順

  • CoreDNS のデーモンセットを特定のノードで実行できるようにするために、taint と toleration を設定します。

    1. 次のコマンドを入力して、DNS Pod の配置を制御するノードに taint を設定します。

      $ oc adm taint nodes <node_name> dns-only=abc:NoExecute
      • <node_name> は、ノードの実際の名前に置き換えます。
    2. 次のコマンドを入力して、default という名前の DNS Operator オブジェクトを、対応する toleration が含まれるように変更します。

      $ oc edit dns.operator/default
    3. taint の 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 フィールドはオプションです。
    4. オプション: ノードセレクターを使用してノードの配置を指定するには、デフォルトの DNS Operator を変更します。

      1. 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 階層を設定します。

手順

  1. 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 にはデフォルトサーバーのみが含まれます。

検証

  1. config map を表示します。

    $ oc get configmap/dns-default -n openshift-dns -o yaml

    TLS 転送の例に基づく 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 デーモンセットのローリング更新がトリガーされます。
Red Hat logoGithubRedditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

Red Hat ドキュメントについて

Legal Notice

Theme

© 2026 Red Hat
トップに戻る