1. tls.crt および tls.key ファイルを使用して、カスタム証明書を含む Secret リソースを openshift-ingress namespace に作成します。

   $ oc --namespace openshift-ingress create secret tls custom-certs-default --cert=tls.crt --key=tls.key

2. IngressController CR を、新規証明書シークレットを参照するように更新します。

   $ oc patch --type=merge --namespace openshift-ingress-operator ingresscontrollers/default \
     --patch '{"spec":{"defaultCertificate":{"name":"custom-certs-default"}}}'

3. 更新が正常に行われていることを確認します。

   $ echo Q |\
     openssl s_client -connect console-openshift-console.apps.<domain>:443 -showcerts 2>/dev/null |\
     openssl x509 -noout -subject -issuer -enddate

   ここでは、以下のようになります。

   <domain>

   クラスターのベースドメイン名を指定します。

   出力例

   subject=C = US, ST = NC, L = Raleigh, O = RH, OU = OCP4, CN = *.apps.example.com
   issuer=C = US, ST = NC, L = Raleigh, O = RH, OU = OCP4, CN = example.com
   notAfter=May 10 08:32:45 2022 GM

   ヒント

   または、以下の YAML を適用してカスタムのデフォルト証明書を設定できます。

   apiVersion: operator.openshift.io/v1
   kind: IngressController
   metadata:
     name: default
     namespace: openshift-ingress-operator
   spec:
     defaultCertificate:
       name: custom-certs-default

   証明書シークレットの名前は、CR を更新するために使用された値に一致する必要があります。

手順

1. デフォルト IngressController の現在の利用可能なレプリカ数を表示します。

   $ oc get -n openshift-ingress-operator ingresscontrollers/default -o jsonpath='{$.status.availableReplicas}'

   出力例

   2

2. oc patch コマンドを使用して、デフォルトの IngressController を必要なレプリカ数にスケーリングします。以下の例では、デフォルトの IngressController を 3 つのレプリカにスケーリングしています。

   $ oc patch -n openshift-ingress-operator ingresscontroller/default --patch '{"spec":{"replicas": 3}}' --type=merge

   出力例

   ingresscontroller.operator.openshift.io/default patched

3. デフォルトの IngressController が指定したレプリカ数にスケーリングされていることを確認します。

   $ oc get -n openshift-ingress-operator ingresscontrollers/default -o jsonpath='{$.status.availableReplicas}'

   出力例

   3

   ヒント

   または、以下の YAML を適用して Ingress コントローラーを 3 つのレプリカにスケーリングすることもできます。

   apiVersion: operator.openshift.io/v1
   kind: IngressController
   metadata:
     name: default
     namespace: openshift-ingress-operator
   spec:
     replicas: 3               1

   1

   異なる数のレプリカが必要な場合は replicas 値を変更します。

手順

1. 以下の例のように、<name>-ingress-controller.yaml という名前のファイルに IngressController カスタムリソース (CR) を作成します。

   apiVersion: operator.openshift.io/v1
   kind: IngressController
   metadata:
     namespace: openshift-ingress-operator
     name: <name> 1
   spec:
     domain: <domain> 2
     endpointPublishingStrategy:
       type: LoadBalancerService
       loadBalancer:
         scope: Internal 3

   1

   <name> を IngressController オブジェクトの名前に置き換えます。

   2

   コントローラーによって公開されるアプリケーションの ドメイン を指定します。

   3

   内部ロードバランサーを使用するために Internal の値を指定します。

2. 以下のコマンドを実行して、直前の手順で定義された Ingress コントローラーを作成します。

   $ oc create -f <name>-ingress-controller.yaml 1

   1

   <name> を IngressController オブジェクトの名前に置き換えます。

3. オプション: 以下のコマンドを実行して Ingress コントローラーが作成されていることを確認します。

   $ oc --all-namespaces=true get ingresscontrollers

手順

1. グローバルアクセスを許可するように Ingress コントローラーリソースを設定します。

   注記

   Ingress コントローラーを作成し、グローバルアクセスのオプションを指定することもできます。

   1. Ingress コントローラーリソースを設定します。

      $ oc -n openshift-ingress-operator edit ingresscontroller/default

   2. YAML ファイルを編集します。

      サンプル clientAccess 設定を Global に設定します。

        spec:
          endpointPublishingStrategy:
            loadBalancer:
              providerParameters:
                gcp:
                  clientAccess: Global 1
                type: GCP
              scope: Internal
            type: LoadBalancerService

      1

      gcp.clientAccess を Global に設定します。

   3. 変更を適用するためにファイルを保存します。

2. 以下のコマンドを実行して、サービスがグローバルアクセスを許可することを確認します。

   $ oc -n openshift-ingress edit svc/router-default -o yaml

   この出力では、グローバルアクセスがアノテーション networking.gke.io/internal-load-balancer-allow-global-access で GCP について有効にされていることを示しています。

手順

1. 削除や再作成を実行して、クラスターを内部に配置するように default Ingress コントローラーを設定します。

   $ oc replace --force --wait --filename - <<EOF
   apiVersion: operator.openshift.io/v1
   kind: IngressController
   metadata:
     namespace: openshift-ingress-operator
     name: default
   spec:
     endpointPublishingStrategy:
       type: LoadBalancerService
       loadBalancer:
         scope: Internal
   EOF

手順

1. ワイルドカードポリシーを設定します。

   1. 以下のコマンドを使用して IngressController リソースを編集します。

      $ oc edit IngressController

   2. spec の下で、wildcardPolicy フィールドを WildcardsDisallowed または WildcardsAllowed に設定します。

      spec:
        routeAdmission:
          wildcardPolicy: WildcardsDisallowed # or WildcardsAllowed

手順

1. Ingress コントローラー用に HTTPHeaders フィールドを設定します。

   1. 以下のコマンドを使用して IngressController リソースを編集します。

      $ oc edit IngressController

   2. spec の下で、HTTPHeaders ポリシーフィールドを Append、Replace、IfNone、または Never に設定します。

      apiVersion: operator.openshift.io/v1
      kind: IngressController
      metadata:
        name: default
        namespace: openshift-ingress-operator
      spec:
        httpHeaders:
          forwardedHeaderPolicy: Append

手順

1. Ingress コントローラーリソースを編集します。

   $ oc -n openshift-ingress-operator edit ingresscontroller/default

2. PROXY 設定を設定します。

   • Ingress コントローラーが hostNetwork エンドポイント公開ストラテジータイプを使用する場合は、spec.endpointPublishingStrategy.nodePort.protocol サブフィールドを PROXY に設定します。

     PROXY への hostNetwork の設定例

       spec:
         endpointPublishingStrategy:
           hostNetwork:
             protocol: PROXY
           type: HostNetwork

   • Ingress コントローラーが NodePortService エンドポイント公開ストラテジータイプを使用する場合は、spec.endpointPublishingStrategy.nodePort.protocol サブフィールドを PROXY に設定します。

     PROXY へのサンプル nodePort 設定

       spec:
         endpointPublishingStrategy:
           nodePort:
             protocol: PROXY
           type: NodePortService

手順

1. ユーザーが作成するルートに代替のデフォルトドメインを指定して appsDomain フィールドを設定します。

   1. Ingress cluster リソースを編集します。

      $ oc edit ingresses.config/cluster -o yaml

   2. YAML ファイルを編集します。

      test.example.com への apps Domain の設定例

      apiVersion: config.openshift.io/v1
      kind: Ingress
      metadata:
        name: cluster
      spec:
        domain: apps.example.com            1
        appsDomain: <test.example.com>      2

      1

      デフォルトドメインを指定します。インストール後にデフォルトドメインを変更することはできません。

      2

      オプション: アプリケーションルートに使用する OpenShift Container Platform インフラストラクチャーのドメイン。デフォルトの接頭辞である apps の代わりに、test のような別の接頭辞を使用できます。

2. ルートを公開し、ルートドメインの変更を確認して、既存のルートに、appsDomain フィールドで指定したドメイン名が含まれていることを確認します。

   注記

   ルートを公開する前に openshift-apiserver がローリング更新を終了するのを待機します。

   1. ルートを公開します。

      $ oc expose service hello-openshift
      route.route.openshift.io/hello-openshift exposed

      出力例:

      $ oc get routes
      NAME              HOST/PORT                                   PATH   SERVICES          PORT       TERMINATION   WILDCARD
      hello-openshift   hello_openshift-<my_project>.test.example.com
      hello-openshift   8080-tcp                 None

手順

1. Ingress Controller のhttpCompressionフィールドを設定します。

   1. 以下のコマンドを使用して IngressController リソースを編集します。

      $ oc edit -n openshift-ingress-operator ingresscontrollers/default

   2. specで、 httpCompression ポリシーフィールドをmimeTypes に設定し、圧縮を適用する必要がある MIME タイプのリストを指定します。

      apiVersion: operator.openshift.io/v1
      kind: IngressController
      metadata:
        name: default
        namespace: openshift-ingress-operator
      spec:
        httpCompression:
          mimeTypes:
          - "text/html"
          - "text/css; charset=utf-8"
          - "application/json"
         ...

手順

1. openshift-config に my-custom-error-code-pages という名前の設定マップを作成します。

   $ oc -n openshift-config create configmap my-custom-error-code-pages \
   --from-file=error-page-503.http \
   --from-file=error-page-404.http

   重要

   カスタムエラーコードの応答ページに適した形式を指定しない場合は、ルーター Pod が停止します。この停止を解決するには、設定マップを削除するか、または修正し、影響を受けるルーター Pod を削除して、正しい情報で再作成できるようにします。

2. Ingress コントローラーにパッチを適用し、名前を指定して my-custom-error-code-pages 設定マップを参照します。

   $ oc patch -n openshift-ingress-operator ingresscontroller/default --patch '{"spec":{"httpErrorCodePages":{"name":"my-custom-error-code-pages"}}}' --type=merge

   Ingress Operator は、openshift-config namespace から openshift-ingress namespace に my-custom-error-code-pages 設定マップをコピーします。Operator は、openshift-ingress namespace のパターン <your_ingresscontroller_name>-errorpages に従って設定マップに名前を付けます。

3. コピーを表示します。

   $ oc get cm default-errorpages -n openshift-ingress

   出力例

   NAME                       DATA   AGE
   default-errorpages         2      25s  1

   1

   default の Ingress Controller カスタムリソース (CR) にパッチが適用されているため、設定マップ名の例は default-errorpages です。

4. カスタムエラー応答ページを含む設定マップがルーターボリュームにマウントされることを確認します。設定マップキーは、カスタム HTTP エラーコード応答を持つファイル名です。

   • 503 カスタム HTTP カスタムエラーコード応答の場合:

     $ oc -n openshift-ingress rsh <router_pod> cat /var/lib/haproxy/conf/error_code_pages/error-page-503.http

   • 404 カスタム HTTP カスタムエラーコード応答の場合:

     $ oc -n openshift-ingress rsh <router_pod> cat /var/lib/haproxy/conf/error_code_pages/error-page-404.http

1. テストプロジェクトおよびアプリケーションを作成します。

    $ oc new-project test-ingress

   $ oc new-app django-psql-example

2. 503 カスタム http エラーコード応答の場合:

   1. アプリケーションのすべての Pod を停止します。

   2. 以下の curl コマンドを実行するか、ブラウザーでルートのホスト名にアクセスします。

      $ curl -vk <route_hostname>

3. 404 カスタム http エラーコード応答の場合:

   1. 存在しないルートまたは正しくないルートにアクセスします。

   2. 以下の curl コマンドを実行するか、ブラウザーでルートのホスト名にアクセスします。

      $ curl -vk <route_hostname>

4. errorfile 属性が haproxy.config ファイルで適切にあるかどうかを確認します。

   $ oc -n openshift-ingress rsh <router> cat /var/lib/haproxy/conf/haproxy.config | grep errorfile

手順

1. 以下の PtpConfig CR を作成してから、YAML を ordinary-clock-ptp-config.yaml ファイルに保存します。

   apiVersion: ptp.openshift.io/v1
   kind: PtpConfig
   metadata:
     name: ordinary-clock-ptp-config                       1
     namespace: openshift-ptp
   spec:
     profile:                                              2
     - name: "<profile_name>"                              3
       interface: ""<interface_name>"                      4
       ptp4lOpts: "-2 -s --summary_interval -4"            5
       phc2sysOpts: "-a -r -n 24"                          6
       ptp4lConf: |                                        7
        [global]
         #
         # Default Data Set
         #
         twoStepFlag                        1
         slaveOnly                          0
         priority1                          128
         priority2                          128
         domainNumber                       24
         #utc_offset                        37
         clockClass                         248
         clockAccuracy                      0xFE
         offsetScaledLogVariance            0xFFFF
         free_running                       0
         freq_est_interval                  1
         dscp_event                         0
         dscp_general                       0
         dataset_comparison                 G.8275.x
         G.8275.defaultDS.localPriority     128
         #
         # Port Data Set
         #
         logAnnounceInterval               -3
         logSyncInterval                   -4
         logMinDelayReqInterval            -4
         logMinPdelayReqInterval           -4
         announceReceiptTimeout             3
         syncReceiptTimeout                 0
         delayAsymmetry                     0
         fault_reset_interval               4
         neighborPropDelayThresh            20000000
         masterOnly                         0
         G.8275.portDS.localPriority        128
         #
         # Run time options
         #
         assume_two_step                    0
         logging_level                      6
         path_trace_enabled                 0
         follow_up_info                     0
         hybrid_e2e                         0
         inhibit_multicast_service          0
         net_sync_monitor                   0
         tc_spanning_tree                   0
         tx_timestamp_timeout               10             8
         unicast_listen                     0
         unicast_master_table               0
         unicast_req_duration               3600
         use_syslog                         1
         verbose                            0
         summary_interval                   0
         kernel_leap                        1
         check_fup_sync                     0
         #
         # Servo Options
         #
         pi_proportional_const              0.0
         pi_integral_const                  0.0
         pi_proportional_scale              0.0
         pi_proportional_exponent          -0.3
         pi_proportional_norm_max           0.7
         pi_integral_scale                  0.0
         pi_integral_exponent               0.4
         pi_integral_norm_max               0.3
         step_threshold                     2.0
         first_step_threshold               0.00002
         max_frequency                      900000000
         clock_servo                        pi
         sanity_freq_limit                  200000000
         ntpshm_segment                     0
         #
         # Transport options
         #
         transportSpecific                  0x0
         ptp_dst_mac                        01:1B:19:00:00:00
         p2p_dst_mac                        01:80:C2:00:00:0E
         udp_ttl                            1
         udp6_scope                         0x0E
         uds_address                        /var/run/ptp4l
         #
         # Default interface options
         #
         clock_type                         OC
         network_transport                  L2
         delay_mechanism                    E2E
         time_stamping                      hardware
         tsproc_mode                        filter
         delay_filter                       moving_median
         delay_filter_length                10
         egressLatency                      0
         ingressLatency                     0
         boundary_clock_jbod                0              9
         #
         # Clock description
         #
         productDescription                 ;;
         revisionData                       ;;
         manufacturerIdentity               00:00:00
         userDescription                    ;
         timeSource                         0xA0
       ptpSchedulingPolicy:                 SCHED_OTHER    10
       ptpSchedulingPriority:               10             11
     ptpClockThreshold:                                    12
       holdOverTimeout:                     5
       maxOffsetThreshold:                  100
       minOffsetThreshold:                 -100
     recommend:                                            13
     - profile: "profile1"                                 14
       priority: 0                                         15
       match:                                              16
       - nodeLabel: "node-role.kubernetes.io/worker"       17
         nodeName: "compute-0.example.com"                 18

   1

   PtpConfig CR の名前。

   2

   1 つ以上の profile オブジェクトの配列を指定します。

   3

   プロファイルオブジェクトに一意の名前を指定します。

   4

   ptp4l サービスで使用するネットワークインターフェイスを指定します (例: ens787f1)。

   5

   ptp4l サービスのシステム設定オプションを指定します。たとえば、-2 で IEEE 802.3 ネットワークトランスポートを選択します。ネットワークインターフェイス名とサービス設定ファイルが自動的に追加されるため、オプションには、ネットワークインターフェイス名 -i <interface> およびサービス設定ファイル -f /etc/ptp4l.conf を含めないでください。このインターフェイスで PTP 高速イベントを使用するには、--summary_interval -4 を追加します。

   6

   phc2sys サービスのシステム設定オプションを指定します。このフィールドが空の場合、PTP Operator は phc2sys サービスを開始しません。Intel Columbiaville 800 Series NIC の場合、phc2sysOpts オプションを -a -r -m -n 24 -N 8 -R 16 に設定します。-m はメッセージを stdout に出力します。linuxptp-daemon DaemonSet はログを解析し、Prometheus メトリックを生成します。

   7

   デフォルトの /etc/ptp4l.conf ファイルを置き換える設定が含まれる文字列を指定します。デフォルト設定を使用するには、フィールドを空のままにします。

   8

   Intel Columbiaville 800 Series NIC の場合、tx_timestamp_timeout を 50 に設定します。

   9

   Intel Columbiaville 800 Series NIC の場合、boundary_clock_jbod を 0 に設定します。

   10

   ptp4l と phc2sys プロセスのスケジューリングポリシー。デフォルト値は SCHED_OTHER です。FIFO スケジューリングをサポートするシステムでは、SCHED_FIFO を使用してください。

   11

   ptp SchedulingPolicy が SCHED_FIFO に設定されている場合に、ptp4l および phc2sys プロセスの FIFO の優先度を設定するために使用される 1-65 の整数値。ptpSchedulingPriority フィールドは、ptpSchedulingPolicy が SCHED_OTHER に設定されている場合は使用されません。

   12

   オプション:ptpClockThreshold スタンザが存在しない場合は、ptpClockThreshold フィールドにデフォルト値が使用されます。スタンザは、デフォルトの ptpClockThreshold 値を示します。ptpClockThreshold 値は、PTP マスタークロックが PTP イベントが発生する前に切断されてからの期間を設定します。holdOverTimeout は、PTP マスタークロックが切断されたときに、PTP クロックイベントの状態が FREERUN に変わるまでの時間値 (秒単位) です。maxOffsetThreshold および minOffsetThreshold 設定は、CLOCK_REALTIME (phc2sys) またはマスターオフセット (ptp4l) の値と比較するナノ秒単位のオフセット値を設定します。ptp4l または phc2sys のオフセット値がこの範囲外の場合、PTP クロックの状態が FREERUN に設定されます。オフセット値がこの範囲内にある場合、PTP クロックの状態が LOCKED に設定されます。

   13

   profile がノードに適用される方法を定義する 1 つ以上の recommend オブジェクトの配列を指定します。

   14

   profile セクションに定義される profile オブジェクト名を指定します。

   15

   通常のクロックの priority を 0 に設定します。

   16

   match ルールを、nodeLabel または nodeName で指定します。

   17

   oc get nodes --show-labels コマンドを使用して、ノードオブジェクトのnode.LabelsのkeyでnodeLabelを指定します。

   18

   oc get nodesコマンドを使用して、ノードオブジェクトのnode.NameでnodeNameを指定します。

2. 次のコマンドを実行して、 PtpConfig CR を作成します。

   $ oc create -f ordinary-clock-ptp-config.yaml

検証

1. PtpConfig プロファイルがノードに適用されていることを確認します。

   1. 以下のコマンドを実行して、openshift-ptp namespace の Pod の一覧を取得します。

      $ oc get pods -n openshift-ptp -o wide

      出力例

      NAME                            READY   STATUS    RESTARTS   AGE   IP               NODE
      linuxptp-daemon-4xkbb           1/1     Running   0          43m   10.1.196.24      compute-0.example.com
      linuxptp-daemon-tdspf           1/1     Running   0          43m   10.1.196.25      compute-1.example.com
      ptp-operator-657bbb64c8-2f8sj   1/1     Running   0          43m   10.129.0.61      control-plane-1.example.com

   2. プロファイルが正しいことを確認します。PtpConfig プロファイルで指定したノードに対応する linuxptp デーモンのログを検査します。以下のコマンドを実行します。

      $ oc logs linuxptp-daemon-4xkbb -n openshift-ptp -c linuxptp-daemon-container

      出力例

      I1115 09:41:17.117596 4143292 daemon.go:107] in applyNodePTPProfile
      I1115 09:41:17.117604 4143292 daemon.go:109] updating NodePTPProfile to:
      I1115 09:41:17.117607 4143292 daemon.go:110] ------------------------------------
      I1115 09:41:17.117612 4143292 daemon.go:102] Profile Name: profile1
      I1115 09:41:17.117616 4143292 daemon.go:102] Interface: ens787f1
      I1115 09:41:17.117620 4143292 daemon.go:102] Ptp4lOpts: -2 -s --summary_interval -4
      I1115 09:41:17.117623 4143292 daemon.go:102] Phc2sysOpts: -a -r -n 24
      I1115 09:41:17.117626 4143292 daemon.go:116] ------------------------------------

手順

1. 以下の PtpConfig CR を作成してから、YAML を boundary-clock-ptp-config.yaml ファイルに保存します。

   apiVersion: ptp.openshift.io/v1
   kind: PtpConfig
   metadata:
     name: boundary-clock-ptp-config                     1
     namespace: openshift-ptp
   spec:
     profile:                                            2
     - name: "<profile_name>"                            3
       ptp4lOpts: "-2 --summary_interval -4"             4
       ptp4lConf: |                                      5
         [ens1f0]                                        6
         masterOnly 0
         [ens1f3]                                        7
         masterOnly 1
         [global]
         #
         # Default Data Set
         #
         twoStepFlag                       1
         #slaveOnly                        1
         priority1                         128
         priority2                         128
         domainNumber                      24
         #utc_offset                       37
         clockClass                        248
         clockAccuracy                     0xFE
         offsetScaledLogVariance           0xFFFF
         free_running                      0
         freq_est_interval                 1
         dscp_event                        0
         dscp_general                      0
         dataset_comparison                G.8275.x
         G.8275.defaultDS.localPriority    128
         #
         # Port Data Set
         #
         logAnnounceInterval              -3
         logSyncInterval                  -4
         logMinDelayReqInterval           -4
         logMinPdelayReqInterval          -4
         announceReceiptTimeout            3
         syncReceiptTimeout                0
         delayAsymmetry                    0
         fault_reset_interval              4
         neighborPropDelayThresh           20000000
         masterOnly                        0
         G.8275.portDS.localPriority       128
         #
         # Runtime options
         #
         assume_two_step                   0
         logging_level                     6
         path_trace_enabled                0
         follow_up_info                    0
         hybrid_e2e                        0
         inhibit_multicast_service         0
         net_sync_monitor                  0
         tc_spanning_tree                  0
         tx_timestamp_timeout              10            8
         unicast_listen                    0
         unicast_master_table              0
         unicast_req_duration              3600
         use_syslog                        1
         verbose                           0
         summary_interval                 -4
         kernel_leap                       1
         check_fup_sync                    0
         #
         # Servo Options
         #
         pi_proportional_const             0.0
         pi_integral_const                 0.0
         pi_proportional_scale             0.0
         pi_proportional_exponent         -0.3
         pi_proportional_norm_max          0.7
         pi_integral_scale                 0.0
         pi_integral_exponent              0.4
         pi_integral_norm_max              0.3
         step_threshold                    2.0
         first_step_threshold              0.00002
         max_frequency                     900000000
         clock_servo                       pi
         sanity_freq_limit                 200000000
         ntpshm_segment                    0
         #
         # Transport options
         #
         transportSpecific                 0x0
         ptp_dst_mac                       01:1B:19:00:00:00
         p2p_dst_mac                       01:80:C2:00:00:0E
         udp_ttl                           1
         udp6_scope                        0x0E
         uds_address                       /var/run/ptp4l
         #
         # Default interface options
         #
         clock_type                        BC
         network_transport                 L2
         delay_mechanism                   E2E
         time_stamping                     hardware
         tsproc_mode                       filter
         delay_filter                      moving_median
         delay_filter_length               10
         egressLatency                     0
         ingressLatency                    0
         boundary_clock_jbod               0             9
         #
         # Clock description
         #
         productDescription                ;;
         revisionData                      ;;
         manufacturerIdentity              00:00:00
         userDescription                   ;
         timeSource                        0xA0
       phc2sysOpts:                        "-a -r -n 24" 10
       ptpSchedulingPolicy:                SCHED_OTHER   11
       ptpSchedulingPriority:              10            12
     ptpClockThreshold:                                  13
       holdOverTimeout:                    5
       maxOffsetThreshold:                 100
       minOffsetThreshold:                -100
     recommend:                                          14
     - profile: "<profile_name>"                         15
       priority: 10                                      16
       match:                                            17
       - nodeLabel: "<node_label>"                       18
         nodeName: "<node_name>"                         19

   1

   PtpConfig CR の名前。

   2

   1 つ以上の profile オブジェクトの配列を指定します。

   3

   プロファイルオブジェクトを一意に識別するプロファイルオブジェクトの名前を指定します。

   4

   ptp4l サービスのシステム設定オプションを指定します。ネットワークインターフェイス名とサービス設定ファイルが自動的に追加されるため、オプションには、ネットワークインターフェイス名 -i <interface> およびサービス設定ファイル -f /etc/ptp4l.conf を含めないでください。

   5

   ptp4l を境界クロックとして起動するために必要な設定を指定します。たとえば、ens1f0 はグランドマスタークロックから同期し、ens1f3 は接続されたデバイスを同期します。

   6

   同期クロックを受信するインターフェイス。

   7

   Synchronization クロックを送信するインターフェイス。

   8

   Intel Columbiaville 800 Series NIC の場合、tx_timestamp_timeout を 50 に設定します。

   9

   Intel Columbiaville 800 Series NIC の場合、boundary_clock_jbod が 0 に設定されていることを確認します。Intel Fortville X710 シリーズ NIC の場合、boundary_clock_jbod が 1 に設定されていることを確認します。

   10

   phc2sys サービスのシステム設定オプションを指定します。このフィールドが空の場合、PTP Operator は phc2sys サービスを開始しません。

   11

   ptp4l と phc2sys プロセスのスケジューリングポリシー。デフォルト値は SCHED_OTHER です。FIFO スケジューリングをサポートするシステムでは、SCHED_FIFO を使用してください。

   12

   ptp SchedulingPolicy が SCHED_FIFO に設定されている場合に、ptp4l および phc2sys プロセスの FIFO の優先度を設定するために使用される 1-65 の整数値。ptpSchedulingPriority フィールドは、ptpSchedulingPolicy が SCHED_OTHER に設定されている場合は使用されません。

   13

   オプション:ptpClockThresholdスタンザが存在しない場合には、ptpClockThresholdフィールドにデフォルト値が使用されます。スタンザはデフォルトの ptpClockThreshold値を示します。ptpClockThreshold 値は、PTP マスタークロックが切断されてから PTP イベントが発生するまでの時間を設定します。holdOverTimeout は、PTP マスタークロックが切断されたときに、PTP クロックイベントの状態が FREERUN に変わるまでの時間値 (秒単位) です。maxOffsetThreshold および minOffsetThreshold 設定は、CLOCK_REALTIME (phc2sys) またはマスターオフセット (ptp4l) の値と比較するナノ秒単位のオフセット値を設定します。ptp4l または phc2sys のオフセット値がこの範囲外の場合、PTP クロックの状態が FREERUN に設定されます。オフセット値がこの範囲内にある場合、PTP クロックの状態が LOCKED に設定されます。

   14

   profile がノードに適用される方法を定義する 1 つ以上の recommend オブジェクトの配列を指定します。

   15

   profile セクションに定義される profile オブジェクト名を指定します。

   16

   0 から 99 までの整数値で priority を指定します。数値が大きいほど優先度が低くなるため、99 の優先度は 10 よりも低くなります。ノードが match フィールドで定義されるルールに基づいて複数のプロファイルに一致する場合、優先順位の高いプロファイルがそのノードに適用されます。

   17

   match ルールを、nodeLabel または nodeName で指定します。

   18

   oc get nodes --show-labels コマンドを使用して、ノードオブジェクトのnode.LabelsのkeyでnodeLabelを指定します。例: node-role.kubernetes.io/worker。

   19

   oc get nodesコマンドを使用して、ノードオブジェクトのnode.NameでnodeNameを指定します。例: node-role.kubernetes.io/worker。例: compute-0.example.com。

2. 以下のコマンドを実行して CR を作成します。

   $ oc create -f boundary-clock-ptp-config.yaml

検証

1. PtpConfig プロファイルがノードに適用されていることを確認します。

   1. 以下のコマンドを実行して、openshift-ptp namespace の Pod の一覧を取得します。

      $ oc get pods -n openshift-ptp -o wide

      出力例

      NAME                            READY   STATUS    RESTARTS   AGE   IP               NODE
      linuxptp-daemon-4xkbb           1/1     Running   0          43m   10.1.196.24      compute-0.example.com
      linuxptp-daemon-tdspf           1/1     Running   0          43m   10.1.196.25      compute-1.example.com
      ptp-operator-657bbb64c8-2f8sj   1/1     Running   0          43m   10.129.0.61      control-plane-1.example.com

   2. プロファイルが正しいことを確認します。PtpConfig プロファイルで指定したノードに対応する linuxptp デーモンのログを検査します。以下のコマンドを実行します。

      $ oc logs linuxptp-daemon-4xkbb -n openshift-ptp -c linuxptp-daemon-container

      出力例

      I1115 09:41:17.117596 4143292 daemon.go:107] in applyNodePTPProfile
      I1115 09:41:17.117604 4143292 daemon.go:109] updating NodePTPProfile to:
      I1115 09:41:17.117607 4143292 daemon.go:110] ------------------------------------
      I1115 09:41:17.117612 4143292 daemon.go:102] Profile Name: profile1
      I1115 09:41:17.117616 4143292 daemon.go:102] Interface:
      I1115 09:41:17.117620 4143292 daemon.go:102] Ptp4lOpts: -2 --summary_interval -4
      I1115 09:41:17.117623 4143292 daemon.go:102] Phc2sysOpts: -a -r -n 24
      I1115 09:41:17.117626 4143292 daemon.go:116] ------------------------------------

手順

1. linuxptp サービスを境界クロックとして設定の参照 CR を各 CR の基礎として使用して、NIC ごとに 1 つずつ、2 つの個別の PtpConfigCR を作成します。以下に例を示します。

   1. phc2sysOpts の値を指定して、boundary-clock-ptp-config-nic1.yaml を作成します。

      apiVersion: ptp.openshift.io/v1
      kind: PtpConfig
      metadata:
        name: boundary-clock-ptp-config-nic1
        namespace: openshift-ptp
      spec:
        profile:
        - name: "profile1"
          ptp4lOpts: "-2 --summary_interval -4"
          ptp4lConf: | 1
            [ens5f1]
            masterOnly 1
            [ens5f0]
            masterOnly 0
          ...
          phc2sysOpts: "-a -r -m -n 24 -N 8 -R 16" 2

      1

      ptp4l を境界クロックとして開始するために必要なインターフェイスを指定します。たとえば、ens5f0 はグランドマスタークロックから同期し、ens5f1 は接続された機器から同期します。

      2

      phc2sysOpts の値が必要です。-m はメッセージを stdout に出力します。linuxptp-daemon DaemonSet はログを解析し、Prometheus メトリックを生成します。

   2. boundary-clock-ptp-config-nic2.yaml を作成し、phc2sysOpts フィールドを完全に削除して、2 番目の NIC の phc2sys サービスを無効にします。

      apiVersion: ptp.openshift.io/v1
      kind: PtpConfig
      metadata:
        name: boundary-clock-ptp-config-nic2
        namespace: openshift-ptp
      spec:
        profile:
        - name: "profile2"
          ptp4lOpts: "-2 --summary_interval -4"
          ptp4lConf: | 1
            [ens7f1]
            masterOnly 1
            [ens7f0]
            masterOnly 0
      ...

      1

      2 番目の NIC の境界クロックとして ptp4l を開始するために必要なインターフェイスを指定します。

      注記

      2 番目の NIC で phc2sys サービスを無効にするには、2 番目の PtpConfig CR から phc2sysOpts フィールドを完全に削除する必要があります。

2. 次のコマンドを実行して、デュアル NIC PtpConfigCR を作成します。

   1. 1 番目の NIC の PTP を設定する CR を作成します。

      $ oc create -f boundary-clock-ptp-config-nic1.yaml

   2. 2 番目の NIC の PTP を設定する CR を作成します。

      $ oc create -f boundary-clock-ptp-config-nic2.yaml

手順

1. Ptp Config CR プロファイルを編集します。

   $ oc edit PtpConfig -n openshift-ptp

2. ptp Scheduling Policy と ptp Scheduling Priority フィールドを変更します。

   apiVersion: ptp.openshift.io/v1
   kind: PtpConfig
   metadata:
     name: <ptp_config_name>
     namespace: openshift-ptp
   ...
   spec:
     profile:
     - name: "profile1"
   ...
       ptpSchedulingPolicy: SCHED_FIFO 1
       ptpSchedulingPriority: 10 2

   1

   ptp4l と phc2sys プロセスのスケジューリングポリシー。FIFO スケジューリングをサポートするシステムでは、SCHED_FIFO を使用してください。

   2

   必須。ptp4l および phc2sys プロセスの FIFO 優先度の設定に使用する 1～65 の整数値を設定します。

3. 保存して終了すると、Ptp ConfigCR に変更が適用されます。

検証

1. Ptp ConfigCR が適用された linuxptp-daemon Pod と対応するノードの名前を取得します。

   $ oc get pods -n openshift-ptp -o wide

   出力例

   NAME                            READY   STATUS    RESTARTS   AGE     IP            NODE
   linuxptp-daemon-gmv2n           3/3     Running   0          1d17h   10.1.196.24   compute-0.example.com
   linuxptp-daemon-lgm55           3/3     Running   0          1d17h   10.1.196.25   compute-1.example.com
   ptp-operator-3r4dcvf7f4-zndk7   1/1     Running   0          1d7h    10.129.0.61   control-plane-1.example.com

2. ptp4l プロセスが、更新された chrtFIFO 優先度で実行されていることを確認します。

   $ oc -n openshift-ptp logs linuxptp-daemon-lgm55 -c linuxptp-daemon-container|grep chrt

   出力例

   I1216 19:24:57.091872 1600715 daemon.go:285] /bin/chrt -f 65 /usr/sbin/ptp4l -f /var/run/ptp4l.0.config -2  --summary_interval -4 -m

1. DU アプリケーションはサブスクリプションを要求: DU は API リクエストを cloud-event-proxy サイドカーに送信し、PTP イベントサブスクリプションを作成します。cloud-event-proxy サイドカーは、サブスクリプションリソースを作成します。
2. cloud-event-proxy サイドカーは、サブスクリプションを作成: イベントリソースは cloud-event-proxy サイドカーによって永続化されます。cloud-event-proxy サイドカーコンテナーは、ID と URL の場所で確認応答を送信し、保存されたサブスクリプションリソースにアクセスします。サイドカーは、サブスクリプションに指定されたリソースの AMQ メッセージングリスナープロトコルを作成します。
3. DU アプリケーションは PTP イベント通知を受受け取る: cloud-event-proxy サイドカーコンテナーは、リソース修飾子で指定されたアドレスをリッスンします。DU イベントのコンシューマーはメッセージを処理し、これをサブスクリプションで指定した返信 URL に渡します。
4. cloud-event-proxy サイドカーは、PTP イベントを検証し、これを DU アプリケーションに送信: cloud-event-proxy サイドカーはイベントを受信し、クラウドイベントオブジェクトをアンラップデータを取得し、イベントを返す URL を取得して DU コンシューマーアプリケーションに返します。
5. DU アプリケーションは PTP イベントを使用: DU アプリケーションイベントコンシューマーは PTP イベントを受信して処理します。

検証

1. AMQ Interconnect Operator が利用可能で、必要な Pod が実行していることを確認します。

   $ oc get pods -n amq-interconnect

   出力例

   NAME                                    READY   STATUS    RESTARTS   AGE
   amq-interconnect-645db76c76-k8ghs       1/1     Running   0          23h
   interconnect-operator-5cb5fc7cc-4v7qm   1/1     Running   0          23h

2. 必要な linuxptp-daemon PTP イベントプロデューサー Pod が openshift-ptp namespace で実行していることを確認します。

   $ oc get pods -n openshift-ptp

   出力例

   NAME                     READY   STATUS    RESTARTS       AGE
   linuxptp-daemon-2t78p    3/3     Running   0              12h
   linuxptp-daemon-k8n88    3/3     Running   0              12h

手順

1. デフォルトの PTP Operator 設定を変更して、PTP 高速イベントを有効にします。

   1. 次の YAML をptp-operatorconfig.yamlファイルに保存します。

      apiVersion: ptp.openshift.io/v1
      kind: PtpOperatorConfig
      metadata:
        name: default
        namespace: openshift-ptp
      spec:
        daemonNodeSelector:
          node-role.kubernetes.io/worker: ""
        ptpEventConfig:
          enableEventPublisher: true 1
          transportHost: amqp://<instance_name>.<namespace>.svc.cluster.local 2

      1

      enableEventPublisher を true に設定して、PTP 高速イベント通知を有効にします。

      2

      transportHost を、設定した AMQ ルーターに設定します。<instance_name> および <namespace> は AMQ Interconnect ルーターインスタンス名および namespace に対応します (例: amqp://amq-interconnect.amq-interconnect.svc.cluster.local)。

   2. PtpOperatorConfig CR を更新します。

      $ oc apply -f ptp-operatorconfig.yaml

2. PTP 対応インターフェイスの PtpConfig カスタムリソースを作成し、ptpClockThreshold および ptp4lOpts に必要な値を設定します。次の YAML は、PtpConfig CR で設定する必要のある値 (必須) を示しています。

   spec:
     profile:
     - name: "profile1"
       interface: "enp5s0f0"
       ptp4lOpts: "-2 -s --summary_interval -4" 1
       phc2sysOpts: "-a -r -m -n 24 -N 8 -R 16" 2
       ptp4lConf: "" 3
     ptpClockThreshold: 4
       holdOverTimeout: 5
       maxOffsetThreshold: 100
       minOffsetThreshold: -100

   1

   --summary_interval -4を追加して、PTP 高速イベントを使用します。

   2

   phc2sysOpts の値が必要です。-m はメッセージを stdout に出力します。linuxptp-daemon DaemonSet はログを解析し、Prometheus メトリックを生成します。

   3

   デフォルトの /etc/ptp4l.conf ファイルを置き換える設定が含まれる文字列を指定します。デフォルト設定を使用するには、フィールドを空のままにします。

   4

   オプション:ptpClockThreshold スタンザが存在しない場合は、ptpClockThreshold フィールドにデフォルト値が使用されます。スタンザは、デフォルトの ptpClockThreshold 値を示します。ptpClockThreshold 値は、PTP マスタークロックが PTP イベントが発生する前に切断されてからの期間を設定します。holdOverTimeout は、PTP マスタークロックが切断されたときに、PTP クロックイベントの状態が FREERUN に変わるまでの時間値 (秒単位) です。maxOffsetThreshold および minOffsetThreshold 設定は、CLOCK_REALTIME (phc2sys) またはマスターオフセット (ptp4l) の値と比較するナノ秒単位のオフセット値を設定します。ptp4l または phc2sys のオフセット値がこの範囲外の場合、PTP クロックの状態が FREERUN に設定されます。オフセット値がこの範囲内にある場合、PTP クロックの状態が LOCKED に設定されます。

手順

1. アクティブな linuxptp-daemon Pod の一覧を取得します。

   $ oc get pods -n openshift-ptp

   出力例

   NAME                    READY   STATUS    RESTARTS   AGE
   linuxptp-daemon-2t78p   3/3     Running   0          8h
   linuxptp-daemon-k8n88   3/3     Running   0          8h

2. 以下のコマンドを実行して、必要な cloud-event-proxy コンテナーのメトリクスにアクセスします。

   $ oc exec -it <linuxptp-daemon> -n openshift-ptp -c cloud-event-proxy -- curl 127.0.0.1:9091/metrics

   ここでは、以下のようになります。

   <linuxptp-daemon>

   問い合わせる Pod を指定します (例: linuxptp-daemon-2t78p)。

   出力例

   # HELP cne_amqp_events_published Metric to get number of events published by the transport
   # TYPE cne_amqp_events_published gauge
   cne_amqp_events_published{address="/cluster/node/compute-1.example.com/ptp/status",status="success"} 1041
   # HELP cne_amqp_events_received Metric to get number of events received  by the transport
   # TYPE cne_amqp_events_received gauge
   cne_amqp_events_received{address="/cluster/node/compute-1.example.com/ptp",status="success"} 1019
   # HELP cne_amqp_receiver Metric to get number of receiver created
   # TYPE cne_amqp_receiver gauge
   cne_amqp_receiver{address="/cluster/node/mock",status="active"} 1
   cne_amqp_receiver{address="/cluster/node/compute-1.example.com/ptp",status="active"} 1
   cne_amqp_receiver{address="/cluster/node/compute-1.example.com/redfish/event",status="active"}
   ...

手順

1. 以下のコマンドを実行して、cloud-event-proxy サイドカーコンテナーから利用可能な PTP メトリクスの一覧を返します。

   $ oc exec -it <linuxptp_daemon_pod> -n openshift-ptp -c cloud-event-proxy -- curl 127.0.0.1:9091/metrics

   ここでは、以下のようになります。

   <linuxptp_daemon_pod>

   問い合わせる Pod を指定します (例: linuxptp-daemon-2t78p)。

2. 返されるメトリクスの一覧から問い合わせる PTP メトリクスの名前 (例: cne_amqp_events_received) をコピーします。
3. OpenShift Container Platform Web コンソールで、Observe → Metrics をクリックします。
4. PTP メトリクスを Expression フィールドに貼り付け、Run queries をクリックします。

1. インストールプランの名前を確認してください。

   $ oc -n external-dns-operator get sub external-dns-operator -o yaml | yq '.status.installplan.name'

   出力例

   install-zcvlr

2. インストールプランのステータスを確認します。インストールプランのステータスは Complete でなければなりません。

   $ oc -n external-dns-operator get ip <install_plan_name> -o yaml | yq .status.phase'

   出力例

   Complete

3. oc get コマンドを使用して Deployment ステータスを表示します。

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

   出力例

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

手順

1. 外部 DNS Operator のログを表示します。

   $ oc logs -n external-dns-operator deployment/external-dns-operator -c external-dns-operator

手順

1. OpenShift Container Platform Web コンソールで、Operators → OperatorHub をクリックします。
2. 外部 DNS Operatorをクリックします。Filter by keyword のテキストボックスまたはフィルターリストを使用して、Operator のリストから外部 DNS Operator を検索できます。
3. external-dns-operator namespace を選択します。
4. External DNS Operator ページで Install をクリックします。

5. Install Operator ページで、次のオプションを選択していることを確認してください。

   1. チャネルを stable-v1.0 として更新している。
   2. インストールモードに A specific name on the cluster を選択している。
   3. namespace をexternal-dns-operatorとしてインストールしている。namespace external-dns-operator が存在しない場合は、Operator のインストール中に作成されます。
   4. 承認ストラテジー を Automatic または Manual として選択している。承認ストラテジーはデフォルトで Automatic に設定されます。
   5. Install をクリックします。

手順

1. ユーザーを確認してください。ユーザーは、 kube-systemnamespace にアクセスできる必要があります。クレデンシャルがない場合は、 kube-systemnamespace からクレデンシャルを取得すると、クラウドプロバイダークライアントを使用できます。

   $ oc whoami

   出力例

   system:admin

2. kube-systemnamespace に存在する aws-creds シークレットから値を取得します。

   $ export AWS_ACCESS_KEY_ID=$(oc get secrets aws-creds -n kube-system  --template={{.data.aws_access_key_id}} | base64 -d)
   $ export AWS_SECRET_ACCESS_KEY=$(oc get secrets aws-creds -n kube-system  --template={{.data.aws_secret_access_key}} | base64 -d)

3. ルートを取得して、ドメインを確認します。

   $ oc get routes --all-namespaces | grep console

   出力例

   openshift-console          console             console-openshift-console.apps.testextdnsoperator.apacshift.support                       console             https   reencrypt/Redirect     None
   openshift-console          downloads           downloads-openshift-console.apps.testextdnsoperator.apacshift.support                     downloads           http    edge/Redirect          None

4. DNS ゾーンのリストを取得して、以前に検出されたルートのドメインに対応するものを検索します。

   $ aws route53 list-hosted-zones | grep testextdnsoperator.apacshift.support

   出力例

   HOSTEDZONES	terraform	/hostedzone/Z02355203TNN1XXXX1J6O	testextdnsoperator.apacshift.support.	5

5. route ソースの ExternalDNS リソースを作成します。

   apiVersion: externaldns.olm.openshift.io/v1alpha1
   kind: ExternalDNS
   metadata:
     name: sample-aws 1
   spec:
     domains:
     - filterType: Include   2
       matchType: Exact   3
       name: testextdnsoperator.apacshift.support 4
       provider:
         type: AWS 5
       source:  6
         type: OpenShiftRoute 7
         openshiftRouteOptions:
           routerName: default 8
   EOF

   1

   外部 DNS リソースの名前を定義します。

   2

   デフォルトでは、すべてのホストゾーンがターゲット候補として選択されます。必要なホストゾーンを追加できます。

   3

   ターゲットゾーンのドメインは、(正規表現の一致とは対照的に) 完全一致である必要があります。

   4

   更新するゾーンのドメインを正確に指定します。ルートのホスト名は、指定されたドメインのサブドメインである必要があります。

   5

   AWS Route53DNSプロバイダーを定義します。

   6

   DNS レコードのソースのオプションを定義します。

   7

   以前に指定された DNS プロバイダーで作成される DNS レコードのソースとして OpenShift route リソースを定義します。

   8

   ソースが OpenShiftRoute の場合に、OpenShift Ingress コントローラー名を指定できます。外部 DNS Operator は、CNAME レコードの作成時に、そのルーターの正規のホスト名をターゲットとして選択します。

6. 次のコマンドを使用して、OCP ルート用に作成されたレコードを確認します。

   $ aws route53 list-resource-record-sets --hosted-zone-id Z02355203TNN1XXXX1J6O --query "ResourceRecordSets[?Type == 'CNAME']" | grep console

手順

1. ユーザーを確認してください。ユーザーは、 kube-systemnamespace にアクセスできる必要があります。クレデンシャルがない場合は、 kube-systemnamespace からクレデンシャルを取得すると、クラウドプロバイダークライアントを使用できます。

   $ oc whoami

   出力例

   system:admin

2. kube-system namespace に存在する azure-credentials シークレットから値を取得します。

   $ CLIENT_ID=$(oc get secrets azure-credentials  -n kube-system  --template={{.data.azure_client_id}} | base64 -d)
   $ CLIENT_SECRET=$(oc get secrets azure-credentials  -n kube-system  --template={{.data.azure_client_secret}} | base64 -d)
   $ RESOURCE_GROUP=$(oc get secrets azure-credentials  -n kube-system  --template={{.data.azure_resourcegroup}} | base64 -d)
   $ SUBSCRIPTION_ID=$(oc get secrets azure-credentials  -n kube-system  --template={{.data.azure_subscription_id}} | base64 -d)
   $ TENANT_ID=$(oc get secrets azure-credentials  -n kube-system  --template={{.data.azure_tenant_id}} | base64 -d)

3. base64 でデコードされた値を使用して azure にログインします。

   $ az login --service-principal -u "${CLIENT_ID}" -p "${CLIENT_SECRET}" --tenant "${TENANT_ID}"

4. ルートを取得して、ドメインを確認します。

   $ oc get routes --all-namespaces | grep console

   出力例

   openshift-console          console             console-openshift-console.apps.test.azure.example.com                       console             https   reencrypt/Redirect     None
   openshift-console          downloads           downloads-openshift-console.apps.test.azure.example.com                     downloads           http    edge/Redirect          None

5. DNS ゾーンのリストを取得して、以前に検出されたルートのドメインに対応するものを検索します。

   $ az network dns zone list --resource-group "${RESOURCE_GROUP}"

6. route ソースの ExternalDNS リソースを作成します。

   apiVersion: externaldns.olm.openshift.io/v1alpha1
   kind: ExternalDNS
   metadata:
     name: sample-azure 1
   spec:
     zones:
     - "/subscriptions/1234567890/resourceGroups/test-azure-xxxxx-rg/providers/Microsoft.Network/dnszones/test.azure.example.com" 2
     provider:
       type: Azure 3
     source:
       openshiftRouteOptions: 4
         routerName: default 5
       type: OpenShiftRoute 6
   EOF

   1

   外部 DNS CR の名前を指定します。

   2

   ゾーン ID を定義します。

   3

   Azure DNS プロバイダーを定義します。

   4

   DNS レコードのソースのオプションを定義できます。

   5

   ソースが OpenShiftRoute の場合、OpenShift Ingress コントローラー名を指定できます。外部 DNS は、CNAME レコードの作成時に、そのルーターの正規のホスト名をターゲットとして選択します。

   6

   以前に指定された DNS プロバイダーで作成される DNS レコードのソースとして OpenShift route リソースを定義します。

7. 次のコマンドを使用して、OCP ルート用に作成されたレコードを確認します。

   $ az network dns record-set list -g "${RESOURCE_GROUP}"  -z test.azure.example.com | grep console

   注記

   プライベート Azure DNS のプライベートホストゾーンにレコードを作成するには、ゾーンの下にプライベートゾーンを指定する必要があります。ゾーンは、ExternalDNSコンテナー引数でプロバイダータイプをazure-private-dnsに設定します。

手順

1. ユーザーを確認してください。ユーザーは、 kube-systemnamespace にアクセスできる必要があります。クレデンシャルがない場合は、 kube-systemnamespace からクレデンシャルを取得すると、クラウドプロバイダークライアントを使用できます。

   $ oc whoami

   出力例

   system:admin

2. 次のコマンドを実行して、encoded-gcloud.json ファイルの gcp-credentials シークレットの service_account.json の値をコピーします。

   $ oc get secret gcp-credentials -n kube-system --template='{{$v := index .data "service_account.json"}}{{$v}}' | base64 -d - > decoded-gcloud.json

3. Google のクレデンシャルをエクスポートします。

   $ export GOOGLE_CREDENTIALS=decoded-gcloud.json

4. 次のコマンドを使用して、アカウントをアクティブ化します。

   $ gcloud auth activate-service-account  <client_email as per decoded-gcloud.json> --key-file=decoded-gcloud.json

5. プロジェクトを設定します。

   $ gcloud config set project <project_id as per decoded-gcloud.json>

6. ルートを取得して、ドメインを確認します。

   $ oc get routes --all-namespaces | grep console

   出力例

   openshift-console          console             console-openshift-console.apps.test.gcp.example.com                       console             https   reencrypt/Redirect     None
   openshift-console          downloads           downloads-openshift-console.apps.test.gcp.example.com                     downloads           http    edge/Redirect          None

7. 管理対象ゾーンのリストを取得して、以前に検出されたルートのドメインに対応するゾーンを見つけます。

   $ gcloud dns managed-zones list | grep test.gcp.example.com
   qe-cvs4g-private-zone test.gcp.example.com

8. route ソースの ExternalDNS リソースを作成します。

   apiVersion: externaldns.olm.openshift.io/v1alpha1
   kind: ExternalDNS
   metadata:
     name: sample-gcp 1
   spec:
     domains:
       - filterType: Include 2
         matchType: Exact 3
         name: test.gcp.example.com 4
     provider:
       type: GCP 5
     source:
       openshiftRouteOptions: 6
         routerName: default 7
       type: OpenShiftRoute 8
   EOF

   1

   外部 DNS CR の名前を指定します。

   2

   デフォルトでは、すべてのホストゾーンがターゲット候補として選択されます。必要なホストゾーンを追加できます。

   3

   ターゲットゾーンのドメインは、(正規表現の一致とは対照的に) 完全一致である必要があります。

   4

   更新するゾーンのドメインを正確に指定します。ルートのホスト名は、指定されたドメインのサブドメインである必要があります。

   5

   Google Cloud DNS プロバイダーを定義します。

   6

   DNS レコードのソースのオプションを定義できます。

   7

   ソースが OpenShiftRoute の場合、OpenShift Ingress コントローラー名を指定できます。外部 DNS は、CNAME レコードの作成時に、そのルーターの正規のホスト名をターゲットとして選択します。

   8

   以前に指定された DNS プロバイダーで作成される DNS レコードのソースとして OpenShift route リソースを定義します。

9. 次のコマンドを使用して、OCP ルート用に作成されたレコードを確認します。

   $ gcloud dns record-sets list --zone=qe-cvs4g-private-zone | grep console