6.4. 외부 DNS Operator

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. 다음 명령을 실행하여 external-dns-operator 배포의 상태를 확인합니다.

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

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

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

프로세스

1. Namespace 오브젝트를 생성합니다.

   1. Namespace 오브젝트를 정의하는 YAML 파일을 생성합니다.

      namespace.yaml 파일 예

      apiVersion: v1
      kind: Namespace
      metadata:
        name: external-dns-operator

   2. 다음 명령을 실행하여 Namespace 오브젝트를 생성합니다.

      $ oc apply -f namespace.yaml

2. OperatorGroup 오브젝트를 생성합니다.

   1. OperatorGroup 오브젝트를 정의하는 YAML 파일을 생성합니다.

      operatorgroup.yaml 파일 예

      apiVersion: operators.coreos.com/v1
      kind: OperatorGroup
      metadata:
        name: external-dns-operator
        namespace: external-dns-operator
      spec:
        upgradeStrategy: Default
        targetNamespaces:
        - external-dns-operator

   2. 다음 명령을 실행하여 OperatorGroup 오브젝트를 생성합니다.

      $ oc apply -f operatorgroup.yaml

3. Subscription 오브젝트를 생성합니다.

   1. Subscription 오브젝트를 정의하는 YAML 파일을 생성합니다.

      subscription.yaml 파일의 예

      apiVersion: operators.coreos.com/v1alpha1
      kind: Subscription
      metadata:
        name: external-dns-operator
        namespace: external-dns-operator
      spec:
        channel: stable-v1
        installPlanApproval: Automatic
        name: external-dns-operator
        source: redhat-operators
        sourceNamespace: openshift-marketplace

   2. 다음 명령을 실행하여 Subscription 오브젝트를 생성합니다.

      $ oc apply -f subscription.yaml

검증

1. 다음 명령을 실행하여 서브스크립션에서 설치 계획의 이름을 가져옵니다.

   $ oc -n external-dns-operator \
       get subscription external-dns-operator \
       --template='{{.status.installplan.name}}{{"\n"}}'

2. 다음 명령을 실행하여 설치 계획의 상태가 Complete 인지 확인합니다.

   $ oc -n external-dns-operator \
       get ip <install_plan_name> \
       --template='{{.status.phase}}{{"\n"}}'

3. 다음 명령을 실행하여 external-dns-operator Pod의 상태가 Running 인지 확인합니다.

   $ oc -n external-dns-operator get pod

   출력 예

   NAME                                     READY   STATUS    RESTARTS   AGE
   external-dns-operator-5584585fd7-5lwqm   2/2     Running   0          11m

4. 다음 명령을 실행하여 서브스크립션의 카탈로그 소스가 redhat-operators 인지 확인합니다.

   $ oc -n external-dns-operator get subscription

   출력 예

   NAME                    PACKAGE                 SOURCE             CHANNEL
   external-dns-operator   external-dns-operator   redhat-operators   stable-v1

5. 다음 명령을 실행하여 external-dns-operator 버전을 확인합니다.

   $ oc -n external-dns-operator get csv

   출력 예

   NAME                           DISPLAY                VERSION   REPLACES   PHASE
   external-dns-operator.v<1.y.z>   ExternalDNS Operator   <1.y.z>                Succeeded

프로세스

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

   $ oc whoami

   출력 예

   system:admin

2. kube-system 네임스페이스에 있는 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. 경로 소스에 대한 ExternalDNS 리소스를 생성합니다.

   $ cat <<EOF | oc create -f -
   apiVersion: externaldns.olm.openshift.io/v1beta1
   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. 계정 B가 다음 명령을 실행하여 계정 A의 Route 53 호스팅 영역에 액세스할 수 있도록 만든 IAM 역할의 역할 ARN을 가져옵니다.

   $ aws --profile account-a iam get-role --role-name user-rol1 | head -1

   출력 예

   ROLE	arn:aws:iam::1234567890123:role/user-rol1	2023-09-14T17:21:54+00:00	3600	/	AROA3SGB2ZRKRT5NISNJN	user-rol1

2. 다음 명령을 실행하여 계정 A의 인증 정보에 사용할 개인 호스팅 영역을 찾습니다.

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

   출력 예

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

3. 다음 명령을 실행하여 ExternalDNS 오브젝트를 생성합니다.

   $ cat <<EOF | oc create -f -
   apiVersion: externaldns.olm.openshift.io/v1beta1
   kind: ExternalDNS
   metadata:
     name: sample-aws
   spec:
     domains:
     - filterType: Include
       matchType: Exact
       name: testextdnsoperator.apacshift.support
     provider:
       type: AWS
       aws:
         assumeRole:
           arn: arn:aws:iam::12345678901234:role/user-rol1 1
     source:
       type: OpenShiftRoute
       openshiftRouteOptions:
         routerName: default
   EOF

   1

   계정 A에서 DNS 레코드를 생성하도록 역할 ARN을 지정합니다.

4. 다음 명령을 사용하여 OCP(OpenShift Container Platform) 경로에 대해 생성된 레코드를 확인합니다.

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

프로세스

1. 다음 명령을 실행하여 클라우드 공급자 클라이언트를 사용하도록 kube-system 네임스페이스에서 인증 정보를 가져옵니다.

   $ 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)

2. 다음 명령을 실행하여 Azure에 로그인합니다.

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

3. 다음 명령을 실행하여 경로 목록을 가져옵니다.

   $ 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

4. 다음 명령을 실행하여 DNS 영역 목록을 가져옵니다.

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

5. ExternalDNS 오브젝트를 정의하는 YAML 파일(예: external-dns-sample-azure.yaml )을 생성합니다.

   Example external-dns-sample-azure.yaml file

   apiVersion: externaldns.olm.openshift.io/v1beta1
   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

   1

   외부 DNS 이름을 지정합니다.

   2

   영역 ID를 정의합니다.

   3

   공급자 유형을 정의합니다.

   4

   DNS 레코드 소스에 대한 옵션을 정의할 수 있습니다.

   5

   소스 유형이 OpenShiftRoute 인 경우 OpenShift Ingress 컨트롤러 이름을 전달할 수 있습니다. 외부 DNS는 CNAME 레코드를 생성하는 동안 해당 라우터의 정식 호스트 이름을 대상으로 선택합니다.

   6

   경로 리소스를 Azure DNS 레코드의 소스로 정의합니다.

6. 다음 명령을 실행하여 OpenShift Container Platform 경로에 대해 생성된 DNS 레코드를 확인합니다.

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

   참고

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

프로세스

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

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

2. 다음 명령을 실행하여 Google 인증 정보를 내보냅니다.

   $ export GOOGLE_CREDENTIALS=decoded-gcloud.json

3. 다음 명령을 사용하여 계정을 활성화합니다.

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

4. 다음 명령을 실행하여 프로젝트를 설정합니다.

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

5. 다음 명령을 실행하여 경로 목록을 가져옵니다.

   $ 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

6. 다음 명령을 실행하여 관리 영역 목록을 가져옵니다.

   $ gcloud dns managed-zones list | grep test.gcp.example.com

   출력 예

   qe-cvs4g-private-zone test.gcp.example.com

7. ExternalDNS 오브젝트를 정의하는 YAML 파일(예: external-dns-sample-gcp.yaml )을 생성합니다.

   external-dns-sample-gcp.yaml 파일 예

   apiVersion: externaldns.olm.openshift.io/v1beta1
   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

   1

   외부 DNS 이름을 지정합니다.

   2

   기본적으로 모든 호스팅 영역은 잠재적 대상으로 선택됩니다. 호스팅 영역을 포함할 수 있습니다.

   3

   대상의 도메인은 name 키로 정의된 문자열과 일치해야 합니다.

   4

   업데이트할 영역의 정확한 도메인을 지정합니다. 경로의 호스트 이름은 지정된 도메인의 하위 도메인이어야 합니다.

   5

   공급자 유형을 정의합니다.

   6

   DNS 레코드 소스에 대한 옵션을 정의할 수 있습니다.

   7

   소스 유형이 OpenShiftRoute 인 경우 OpenShift Ingress 컨트롤러 이름을 전달할 수 있습니다. 외부 DNS는 CNAME 레코드를 생성하는 동안 해당 라우터의 정식 호스트 이름을 대상으로 선택합니다.

   8

   경로 리소스를 GCP DNS 레코드의 소스로 정의합니다.

8. 다음 명령을 실행하여 OpenShift Container Platform 경로에 대해 생성된 DNS 레코드를 확인합니다.

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

프로세스

1. 다음 명령을 실행하여 Infoblox 인증 정보를 사용하여 보안 오브젝트를 생성합니다.

   $ oc -n external-dns-operator create secret generic infoblox-credentials --from-literal=EXTERNAL_DNS_INFOBLOX_WAPI_USERNAME=<infoblox_username> --from-literal=EXTERNAL_DNS_INFOBLOX_WAPI_PASSWORD=<infoblox_password>

2. 다음 명령을 실행하여 경로 목록을 가져옵니다.

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

   출력 예

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

3. ExternalDNS 오브젝트를 정의하는 YAML 파일(예: external-dns-sample-infoblox.yaml )을 생성합니다.

   external-dns-sample-infoblox.yaml 파일의 예

   apiVersion: externaldns.olm.openshift.io/v1beta1
   kind: ExternalDNS
   metadata:
     name: sample-infoblox 1
   spec:
     provider:
       type: Infoblox 2
       infoblox:
         credentials:
           name: infoblox-credentials
         gridHost: ${INFOBLOX_GRID_PUBLIC_IP}
         wapiPort: 443
         wapiVersion: "2.3.1"
     domains:
     - filterType: Include
       matchType: Exact
       name: test.example.com
     source:
       type: OpenShiftRoute 3
       openshiftRouteOptions:
         routerName: default 4

   1

   외부 DNS 이름을 지정합니다.

   2

   공급자 유형을 정의합니다.

   3

   DNS 레코드 소스에 대한 옵션을 정의할 수 있습니다.

   4

   소스 유형이 OpenShiftRoute 인 경우 OpenShift Ingress 컨트롤러 이름을 전달할 수 있습니다. 외부 DNS는 CNAME 레코드를 생성하는 동안 해당 라우터의 정식 호스트 이름을 대상으로 선택합니다.

4. 다음 명령을 실행하여 Infoblox에서 ExternalDNS 리소스를 만듭니다.

   $ oc create -f external-dns-sample-infoblox.yaml

5. Infoblox UI에서 콘솔 경로에 대해 생성된 DNS 레코드를 확인합니다.

   1. 데이터 관리 DNS 영역을 클릭합니다.
   2. 영역 이름을 선택합니다.

프로세스

1. 다음 명령을 실행하여 external-dns-operator 네임스페이스에 CA 번들을 포함할 구성 맵을 생성합니다.

   $ oc -n external-dns-operator create configmap trusted-ca

2. 신뢰할 수 있는 CA 번들을 구성 맵에 삽입하려면 다음 명령을 실행하여 config.openshift.io/inject-trusted-cabundle=true 레이블을 구성 맵에 추가합니다.

   $ oc -n external-dns-operator label cm trusted-ca config.openshift.io/inject-trusted-cabundle=true

3. 다음 명령을 실행하여 외부 DNS Operator의 서브스크립션을 업데이트합니다.

   $ oc -n external-dns-operator patch subscription external-dns-operator --type='json' -p='[{"op": "add", "path": "/spec/config", "value":{"env":[{"name":"TRUSTED_CA_CONFIGMAP_NAME","value":"trusted-ca"}]}}]'