1. tls.crt 및 tls.key 파일을 사용하여 openshift-ingress 네임스페이스에 사용자 정의 인증서를 포함하는 Secret 리소스를 만듭니다.

   $ 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 컨트롤러를 세 개의 복제본으로 확장할 수 있습니다.

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

   1

   다른 양의 복제본이 필요한 경우 replicas 값을 변경합니다.

프로세스

1. 다음 예제와 같이 <name>-ingress-controller.yam 파일에 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

   컨트롤러가 게시한 애플리케이션의 domain을 지정합니다.

   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 파일을 편집합니다.

      Global에 대한 clientAccess 구성 샘플

        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. 클러스터의 기본 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.hostNetwork.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 클러스터 리소스를 편집합니다.

      $ oc edit ingresses.config/cluster -o yaml

   2. YAML 파일을 편집합니다.

      test.example.com에 대한 샘플 appsDomain 구성

      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 인프라의 도메인입니다. 기본 접두사인 앱 대신 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 컨트롤러의 httpCompression 필드를 구성합니다.

   1. 다음 명령을 사용하여 IngressController 리소스를 편집합니다.

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

   2. spec 에서 httpCompression policy 필드를 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. 이름별로 my-custom-error-code-pages 구성 맵을 참조하도록 Ingress 컨트롤러를 패치합니다.

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

   Ingress Operator는 my-custom-error-code-pages 구성 맵을 openshift-config 네임스페이스에서 openshift-ingress 네임스페이스로 복사합니다. Operator는 openshift-ingress 네임스페이스에서 <your_ingresscontroller_name>-errorpages 패턴에 따라 구성 맵의 이름을 지정합니다.

3. 복사본을 표시합니다.

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

   출력 예

   NAME                       DATA   AGE
   default-errorpages         2      25s  1

   1

   default Ingress 컨트롤러 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

   하나 이상의 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 시리즈 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 시리즈 NIC의 경우 tx_timestamp_timeout 을 50 으로 설정합니다.

   9

   Intel Columbiaville 800 시리즈 NIC의 경우 boundary_clock_jbod 를 0 으로 설정합니다.

   10

   ptp4l 및 phc2sys 프로세스에 대한 스케줄링 정책입니다. 기본값은 E gressIP_OTHER 입니다. FIFO 예약을 지원하는 시스템에서 jq_FIFO 를 사용합니다.

   11

   ptpSchedulingPolicy 가ECDHE _FIFO로 설정된 경우 ptp4l 및 phc2sys 프로세스의 FIFO 우선 순위를 설정하는 데 사용되는 1-65의 정수 값입니다. ptpSchedulingPriority 필드는 ptpSchedulingPolicy 가ECDHE _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

   프로필을 노드에 적용하는 방법에 대한 규칙을 정의하는 하나 이상의 recommend 오브젝트 배열을 지정합니다.

   14

   profile 섹션에 정의된 profile 오브젝트 이름을 지정합니다.

   15

   일반 시계의 우선 순위를 0 으로 설정합니다.

   16

   nodeLabel 또는 nodeName으로 일치 규칙을 지정합니다.

   17

   oc get nodes --show-labels 명령을 사용하여 노드 오브젝트에서 node.Labels 키를 사용하여 nodeLabel 을 지정합니다.

   18

   oc get nodes 명령을 사용하여 노드 오브젝트에서 node.Name 으로 nodeName 을 지정합니다.

2. 다음 명령을 실행하여 PtpConfig CR을 생성합니다.

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

검증

1. PtpConfig 프로필이 노드에 적용되었는지 확인합니다.

   1. 다음 명령을 실행하여 openshift-ptp 네임스페이스에서 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

   하나 이상의 profile 오브젝트의 배열을 지정합니다.

   3

   프로파일 오브젝트를 고유하게 식별하는 프로파일 오브젝트의 이름을 지정합니다.

   4

   ptp4l 서비스에 대한 시스템 구성 옵션을 지정합니다. 옵션은 네트워크 인터페이스 이름과 서비스 구성 파일이 자동으로 추가되므로 네트워크 인터페이스 이름 -i <interface> 및 서비스 구성 파일 -f /etc/ptp4l.conf를 포함하지 않아야 합니다.

   5

   ptp4l을 경계 클록으로 시작하는 데 필요한 구성을 지정합니다. 예를 들어 ens1f0 은 그랜드 마스터 클록에서 동기화되고 ens1f3은 연결된 장치를 동기화합니다.

   6

   동기화 클럭을 수신하는 인터페이스입니다.

   7

   동기화 클럭을 전송하는 인터페이스입니다.

   8

   Intel Columbiaville 800 시리즈 NIC의 경우 tx_timestamp_timeout 을 50 으로 설정합니다.

   9

   Intel Columbiaville 800 시리즈 NIC의 경우 boundary_clock_jbod 가 0 으로 설정되어 있는지 확인합니다. Intel Fortville X710 시리즈 NIC의 경우 boundary_clock_jbod 가 1 로 설정되어 있는지 확인합니다.

   10

   phc2sys 서비스에 대한 시스템 구성 옵션을 지정합니다. 이 필드가 비어 있으면 PTP Operator에서 phc2sys 서비스를 시작하지 않습니다.

   11

   ptp4l 및 phc2sys 프로세스에 대한 스케줄링 정책입니다. 기본값은 E gressIP_OTHER 입니다. FIFO 예약을 지원하는 시스템에서 jq_FIFO 를 사용합니다.

   12

   ptpSchedulingPolicy 가ECDHE _FIFO로 설정된 경우 ptp4l 및 phc2sys 프로세스의 FIFO 우선 순위를 설정하는 데 사용되는 1-65의 정수 값입니다. ptpSchedulingPriority 필드는 ptpSchedulingPolicy 가ECDHE _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

   프로필을 노드에 적용하는 방법에 대한 규칙을 정의하는 하나 이상의 recommend 오브젝트 배열을 지정합니다.

   15

   profile 섹션에 정의된 profile 오브젝트 이름을 지정합니다.

   16

   0에서 99 사이의 정수 값으로 priority를 지정합니다. 숫자가 클수록 우선순위가 낮으므로 우선순위 99는 우선순위 10보다 낮습니다. match 필드에 정의된 규칙에 따라 여러 프로필과 노드를 일치시킬 수 있는 경우 우선 순위가 높은 프로필이 해당 노드에 적용됩니다.

   17

   nodeLabel 또는 nodeName으로 일치 규칙을 지정합니다.

   18

   oc get nodes --show-labels 명령을 사용하여 노드 오브젝트에서 node.Labels 키를 사용하여 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 네임스페이스에서 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. 각 CR의 기반으로 linuxptp 서비스를 경계 클럭으로 구성"의 참조 CR을 사용하여 각 NIC에 대해 별도의 PtpConfig CR을 생성합니다. 예를 들면 다음과 같습니다.

   1. boundary-clock-ptp-config-nic1.yaml 을 생성하여 phc2sysOpts 값을 지정합니다.

      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 필드를 완전히 제거하여 두 번째 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

      두 번째 NIC에서 ptp4l 을 경계 클럭으로 시작하는 데 필요한 인터페이스를 지정합니다.

      참고

      두 번째 NIC에서 phc2sysOpts 필드를 완전히 제거하려면 두 번째 PtpConfig CR에서 phc2sys 서비스를 비활성화해야 합니다.

2. 다음 명령을 실행하여 듀얼 NIC PtpConfig CR을 생성합니다.

   1. 첫 번째 NIC에 대해 PTP를 구성하는 CR을 생성합니다.

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

   2. 두 번째 NIC에 대해 PTP를 구성하는 CR을 생성합니다.

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

절차

1. PtpConfig CR 프로파일을 편집합니다.

   $ oc edit PtpConfig -n openshift-ptp

2. ptpSchedulingPolicy 및 ptpSchedulingPriority 필드를 변경합니다.

   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 예약을 지원하는 시스템에서 jq_FIFO 를 사용합니다.

   2

   필수 항목입니다. ptp4l 및 phc2sys 프로세스에 대해 FIFO 우선 순위를 구성하는 데 사용되는 정수 값 1-65를 설정합니다.

3. PtpConfig CR에 변경 사항을 적용하고 저장하려면 저장하고 종료합니다.

검증

1. linuxptp-daemon Pod의 이름과 PtpConfig CR이 적용된 해당 노드를 가져옵니다.

   $ 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 프로세스가 업데이트된 chrt FIFO 우선 순위로 실행되고 있는지 확인합니다.

   $ 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 네임스페이스에서 실행되고 있는지 확인합니다.

   $ 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

      < instance_name > 및 < namespace >가 AMQ Interconnect 라우터 인스턴스 이름과 네임스페이스(예: amqp://amq-interconnect.amq-interconnect.svc.cluster.local)에 해당합니다.

   2. PtpOperatorConfig CR을 업데이트합니다.

      $ oc apply -f ptp-operatorconfig.yaml

2. PTP 지원 인터페이스에 대한 PtpConfig CR(사용자 정의 리소스)을 생성하고 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

   PTP 빠른 이벤트를 사용하려면 --summary_interval -4 를 추가합니다.

   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 웹 콘솔에서 모니터링 → 메트릭을 클릭합니다.
4. PTP 메트릭을 표현식 필드에 붙여넣고 쿼리 실행을 클릭합니다.

1. 설치 계획의 이름을 확인합니다.

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

   출력 예

   install-zcvlr

2. 설치 계획의 상태를 확인하면 설치 계획의 상태가 완료 여야 합니다.

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

   출력 예

   Complete

3. oc get 명령을 사용하여 배포 상태를 확인합니다.

   $ 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 웹 콘솔에서 Operators → OperatorHub 를 클릭합니다.
2. External DNS Operator 를 클릭합니다. 키워드로 텍스트 상자 또는 필터 목록을 사용하여 Operator 목록에서 외부 DNS Operator를 검색할 수 있습니다.
3. external-dns-operator 네임스페이스를 선택합니다.
4. 외부 DNS Operator 페이지에서 설치를 클릭합니다.

5. Operator 설치 페이지에서 다음 옵션을 선택했는지 확인합니다.

   1. 채널을 stable-v1.0 으로 업데이트합니다.
   2. 클러스터의 특정 이름으로 설치 모드.
   3. 설치된 네임스페이스를 external-dns-operator 로 . external-dns-operator 네임스페이스가 없는 경우 Operator 설치 중에 생성됩니다.
   4. 승인 전략을 자동 또는 수동으로 선택합니다. 승인 전략은 기본적으로 자동으로 설정됩니다.
   5. 설치를 클릭합니다.

프로세스

1. 사용자를 확인합니다. 사용자는 kube-system 네임스페이스에 액세스할 수 있어야 합니다. 인증 정보가 없는 경우 kube-system 네임스페이스에서 인증 정보를 가져와서 클라우드 공급자 클라이언트를 사용할 수 있습니다.

   $ oc whoami

   출력 예

   system:admin

2. kube-system 네임스페이스에 있는 aws-creds secret에서 값을 가져옵니다.

   $ 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. 경로 소스를 위한 ExternalDNS 리소스를 생성합니다.

   $ cat <<EOF | oc create -f -
   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 Route53 DNS 공급자를 정의합니다.

   6

   DNS 레코드 소스에 대한 옵션을 정의합니다.

   7

   OpenShift 경로 리소스를 이전에 지정된 DNS 공급자에서 생성되는 DNS 레코드의 소스로 정의합니다.

   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-system 네임스페이스에 액세스할 수 있어야 합니다. 인증 정보가 없는 경우 kube-system 네임스페이스에서 인증 정보를 가져와서 클라우드 공급자 클라이언트를 사용할 수 있습니다.

   $ oc whoami

   출력 예

   system:admin

2. kube-system 네임스페이스에 있는 azure-credentials secret에서 값을 가져옵니다.

   $ 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. 경로 소스를 위한 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

   OpenShift 경로 리소스를 이전에 지정된 DNS 공급자에서 생성되는 DNS 레코드의 소스로 정의합니다.

7. 다음 명령을 사용하여 OCP 경로에 대해 생성된 레코드를 확인합니다.

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

   참고

   프라이빗 Azure dns의 프라이빗 호스팅 영역에 레코드를 생성하려면 ExternalDNS 컨테이너 args에서 공급자 유형을 azure-private-dns 로 채우는 영역 아래의 프라이빗 영역을 지정해야 합니다.

절차

1. 사용자를 확인합니다. 사용자는 kube-system 네임스페이스에 액세스할 수 있어야 합니다. 인증 정보가 없는 경우 kube-system 네임스페이스에서 인증 정보를 가져와서 클라우드 공급자 클라이언트를 사용할 수 있습니다.

   $ oc whoami

   출력 예

   system:admin

2. 다음 명령을 실행하여 encoded-gcloud.json 파일에서 service_account.json의 service_account.json 값을 gcp-credentials 시크릿에 복사합니다.

   $ 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. 경로 소스를 위한 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

   OpenShift 경로 리소스를 이전에 지정된 DNS 공급자에서 생성되는 DNS 레코드의 소스로 정의합니다.

9. 다음 명령을 사용하여 OCP 경로에 대해 생성된 레코드를 확인합니다.

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