네트워킹

프로세스

1. Operators → OperatorHub를 선택합니다.
2. 모든 항목 아래의 검색 필드에 nmstate를 입력하고 Enter를 클릭하여 Kubernetes NMState Operator를 검색합니다.
3. Kubernetes NMState Operator 검색 결과를 클릭합니다.
4. 설치를 클릭하여 Operator 설치 창을 엽니다.
5. 설치를 클릭하여 Operator를 설치합니다.
6. Operator 설치가 완료되면 Operator 보기를 클릭합니다.
7. 제공된 API 아래에서 인스턴스 생성을 클릭하여 kubernetes-nmstate의 인스턴스 생성을 위해 대화 상자를 엽니다.

8. 대화 상자의 이름 필드에서 인스턴스 이름이 nmstate인지 확인합니다.

   참고

   이름 제한은 알려진 문제입니다. 인스턴스는 전체 클러스터에 대한 단일 생성입니다.

9. 기본 설정을 수락하고 만들기를 클릭하여 인스턴스를 만듭니다.

프로세스

1. nmstate Operator 네임스페이스를 생성합니다.

   $ cat << EOF | oc apply -f -
   apiVersion: v1
   kind: Namespace
   metadata:
     name: openshift-nmstate
   spec:
     finalizers:
     - kubernetes
   EOF

   Copy to Clipboard Toggle word wrap

2. OperatorGroup 을 생성합니다.

   $ cat << EOF | oc apply -f -
   apiVersion: operators.coreos.com/v1
   kind: OperatorGroup
   metadata:
     name: openshift-nmstate
     namespace: openshift-nmstate
   spec:
     targetNamespaces:
     - openshift-nmstate
   EOF

   Copy to Clipboard Toggle word wrap

3. nmstate Operator에 가입합니다.

   $ cat << EOF| oc apply -f -
   apiVersion: operators.coreos.com/v1alpha1
   kind: Subscription
   metadata:
     name: kubernetes-nmstate-operator
     namespace: openshift-nmstate
   spec:
     channel: stable
     installPlanApproval: Automatic
     name: kubernetes-nmstate-operator
     source: redhat-operators
     sourceNamespace: openshift-marketplace
   EOF

   Copy to Clipboard Toggle word wrap

4. nmstate Operator 배포의 ClusterServiceVersion (CSV) 상태를 Succeeded:과 일치하는지 확인합니다.

   $ oc get clusterserviceversion -n openshift-nmstate \
    -o custom-columns=Name:.metadata.name,Phase:.status.phase

   Copy to Clipboard Toggle word wrap

5. nmstate Operator 인스턴스를 생성합니다.

   $ cat << EOF | oc apply -f -
   apiVersion: nmstate.io/v1
   kind: NMState
   metadata:
     name: nmstate
   EOF

   Copy to Clipboard Toggle word wrap

6. DNS 연결 문제로 인해 클러스터에 DNS 상태 점검 프로브에 문제가 있는 경우 NMState CRD에 다음 DNS 호스트 이름을 추가하여 이러한 문제를 해결할 수 있는 상태 점검에 빌드할 수 있습니다.

   apiVersion: nmstate.io/v1
   kind: NMState
   metadata:
     name: nmstate
   spec:
     probeConfiguration:
       dns:
         host: redhat.com
   # ...

   Copy to Clipboard Toggle word wrap

   1. 다음 명령을 실행하여 DNS 호스트 이름 구성을 클러스터 네트워크에 적용합니다. < filename> 을 CRD 파일의 이름으로 교체해야 합니다.

      $ oc apply -f <filename>.yaml

      Copy to Clipboard Toggle word wrap

   2. 다음 명령을 실행하여 리소스가 Available 조건에 도달할 때까지 nmstate CRD를 모니터링합니다. 이 설정된 최대 대기 시간 내에 Available 조건이 충족되지 않으면 명령이 시간 초과되고 오류 메시지를 생성하도록 --timeout 옵션의 값을 설정해야 합니다.

      $ oc wait --for=condition=Available nmstate/nmstate --timeout=600s

      Copy to Clipboard Toggle word wrap

검증

1. 다음 명령을 입력하여 NMState Operator의 모든 Pod 상태가 Running 인지 확인합니다.

   $ oc get pod -n openshift-nmstate

   Copy to Clipboard Toggle word wrap

프로세스

1. OperatorHub에서 AWS Load Balancer Operator를 온디맨드로 배포하려면 다음 명령을 실행하여 Subscription 오브젝트를 생성합니다.

   $ oc -n aws-load-balancer-operator get sub aws-load-balancer-operator --template='{{.status.installplan.name}}{{"\n"}}'

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

3. 다음 명령을 실행하여 aws-load-balancer-operator-controller-manager 배포의 상태를 확인합니다.

   $ oc get -n aws-load-balancer-operator deployment/aws-load-balancer-operator-controller-manager

   Copy to Clipboard Toggle word wrap

   출력 예

   NAME                                           READY     UP-TO-DATE   AVAILABLE   AGE
   aws-load-balancer-operator-controller-manager  1/1       1            1           23h

   Copy to Clipboard Toggle word wrap

프로세스

1. 다음 명령을 실행하여 aws-load-balancer-operator 프로젝트를 생성합니다.

   $ oc new-project aws-load-balancer-operator

   Copy to Clipboard Toggle word wrap

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

   $ cat <<EOF | oc apply -f -
   apiVersion: operators.coreos.com/v1
   kind: OperatorGroup
   metadata:
     name: aws-load-balancer-operator
     namespace: aws-load-balancer-operator
   spec:
     targetNamespaces: []
   EOF

   Copy to Clipboard Toggle word wrap

3. 다음 명령을 실행하여 서브스크립션 오브젝트를 생성합니다.

   $ cat <<EOF | oc apply -f -
   apiVersion: operators.coreos.com/v1alpha1
   kind: Subscription
   metadata:
     name: aws-load-balancer-operator
     namespace: aws-load-balancer-operator
   spec:
     channel: stable-v1
     name: aws-load-balancer-operator
     source: redhat-operators
     sourceNamespace: openshift-marketplace
     config:
       env:
       - name: ROLEARN
         value: "<albo_role_arn>" 

   1

   
   EOF

   Copy to Clipboard Toggle word wrap

   1

   CredentialsRequest 에서 AWS Load Balancer Operator의 AWS 인증 정보를 프로비저닝하는 데 사용할 ARN 역할을 지정합니다. < albo_role_arn >의 예는 arn:aws:iam::<aws_account_number>:role/albo-operator 입니다.

   참고

   AWS Load Balancer Operator는 사용 가능 상태로 이동하기 전에 보안이 생성될 때까지 기다립니다.

프로세스

1. OpenShift Container Platform 웹 콘솔에서 Operators → OperatorHub 로 이동합니다.
2. AWS Load Balancer Operator 를 선택합니다. 키워드로 필터링 텍스트 상자를 사용하거나 필터 목록을 사용하여 Operator 목록에서 AWS Load Balancer Operator를 검색할 수 있습니다.
3. aws-load-balancer-operator 네임스페이스를 선택합니다.

4. Operator 설치 페이지에서 다음 옵션을 선택합니다.

   1. 채널을 stable-v1 로 업데이트합니다.
   2. 클러스터의 모든 네임스페이스(기본값) 로 설치 모드입니다.
   3. 설치된 네임스페이스 에서 aws-load-balancer-operator. aws-load-balancer-operator 네임스페이스가 없으면 Operator 설치 중에 생성됩니다.
   4. 자동 또는 수동으로 승인 업데이트를 선택합니다. 기본적으로 업데이트 승인은 자동으로 설정됩니다. 자동 업데이트를 선택하면 OLM(Operator Lifecycle Manager)이 개입 없이 Operator의 실행 중인 인스턴스를 자동으로 업그레이드합니다. 수동 업데이트를 선택하면 OLM에서 업데이트 요청을 생성합니다. 클러스터 관리자는 Operator가 새 버전으로 업데이트되도록 업데이트 요청을 수동으로 승인해야 합니다.
5. 설치를 클릭합니다.

프로세스

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

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

      namespace.yaml 파일 예

      apiVersion: v1
      kind: Namespace
      metadata:
        name: aws-load-balancer-operator

      Copy to Clipboard Toggle word wrap

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

      $ oc apply -f namespace.yaml

      Copy to Clipboard Toggle word wrap

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

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

      operatorgroup.yaml 파일 예

      apiVersion: operators.coreos.com/v1
      kind: OperatorGroup
      metadata:
        name: aws-lb-operatorgroup
        namespace: aws-load-balancer-operator
      spec:
        upgradeStrategy: Default

      Copy to Clipboard Toggle word wrap

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

      $ oc apply -f operatorgroup.yaml

      Copy to Clipboard Toggle word wrap

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

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

      subscription.yaml 파일의 예

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

      Copy to Clipboard Toggle word wrap

   2. 다음 명령을 실행하여 서브스크립션 오브젝트를 생성합니다.

      $ oc apply -f subscription.yaml

      Copy to Clipboard Toggle word wrap

검증

1. 서브스크립션에서 설치 계획의 이름을 가져옵니다.

   $ oc -n aws-load-balancer-operator \
     get subscription aws-load-balancer-operator \
     --template='{{.status.installplan.name}}{{"\n"}}'

   Copy to Clipboard Toggle word wrap

2. 설치 계획의 상태를 확인합니다.

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

   Copy to Clipboard Toggle word wrap

   출력은 Complete 여야 합니다.

프로세스

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

   sample-aws-lb.yaml 파일 예

   apiVersion: networking.olm.openshift.io/v1
   kind: AWSLoadBalancerController 

   1

   
   metadata:
     name: cluster 

   2

   
   spec:
     subnetTagging: Auto 

   3

   
     additionalResourceTags: 

   4

   
     - key: example.org/security-scope
       value: staging
     ingressClass: alb 

   5

   
     config:
       replicas: 2 

   6

   
     enabledAddons: 

   7

   
       - AWSWAFv2 

   8

   Copy to Clipboard Toggle word wrap

   1

   AWSLoadBalancerController 개체를 정의합니다.

   2

   AWS Load Balancer 컨트롤러 이름을 정의합니다. 이 인스턴스 이름은 모든 관련 리소스에 접미사로 추가됩니다.

   3

   AWS Load Balancer Controller의 서브넷 태그 지정 방법을 구성합니다. 다음 값이 유효합니다.

   • Auto: AWS Load Balancer Operator는 클러스터에 속하는 서브넷을 결정하고 적절하게 태그를 지정합니다. 내부 서브넷 태그가 내부 서브넷에 없으면 Operator에서 역할을 올바르게 확인할 수 없습니다.
   • Manual: 적절한 역할 태그를 사용하여 클러스터에 속한 서브넷에 수동으로 태그를 지정합니다. 사용자 제공 인프라에 클러스터를 설치한 경우 이 옵션을 사용합니다.

   4

   AWS 리소스를 프로비저닝할 때 AWS Load Balancer 컨트롤러에서 사용하는 태그를 정의합니다.

   5

   수신 클래스 이름을 정의합니다. 기본값은 alb 입니다.

   6

   AWS Load Balancer 컨트롤러의 복제본 수를 지정합니다.

   7

   AWS Load Balancer Controller의 애드온으로 주석을 지정합니다.

   8

   alb.ingress.kubernetes.io/wafv2-acl-arn 주석을 활성화합니다.

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

   $ oc create -f sample-aws-lb.yaml

   Copy to Clipboard Toggle word wrap

3. Deployment 리소스를 정의하는 YAML 파일을 생성합니다.

   sample-aws-lb.yaml 파일 예

   apiVersion: apps/v1
   kind: Deployment 

   1

   
   metadata:
     name: <echoserver> 

   2

   
     namespace: echoserver
   spec:
     selector:
       matchLabels:
         app: echoserver
     replicas: 3 

   3

   
     template:
       metadata:
         labels:
           app: echoserver
       spec:
         containers:
           - image: openshift/origin-node
             command:
              - "/bin/socat"
             args:
               - TCP4-LISTEN:8080,reuseaddr,fork
               - EXEC:'/bin/bash -c \"printf \\\"HTTP/1.0 200 OK\r\n\r\n\\\"; sed -e \\\"/^\r/q\\\"\"'
             imagePullPolicy: Always
             name: echoserver
             ports:
               - containerPort: 8080

   Copy to Clipboard Toggle word wrap

   1

   배포 리소스를 정의합니다.

   2

   배포 이름을 지정합니다.

   3

   배포의 복제본 수를 지정합니다.

4. Service 리소스를 정의하는 YAML 파일을 생성합니다.

   service-albo.yaml 파일 예

   apiVersion: v1
   kind: Service 

   1

   
   metadata:
     name: <echoserver> 

   2

   
     namespace: echoserver
   spec:
     ports:
       - port: 80
         targetPort: 8080
         protocol: TCP
     type: NodePort
     selector:
       app: echoserver

   Copy to Clipboard Toggle word wrap

   1

   서비스 리소스를 정의합니다.

   2

   서비스 이름을 지정합니다.

5. Ingress 리소스를 정의하는 YAML 파일을 생성합니다.

   ingress-albo.yaml 파일 예

   apiVersion: networking.k8s.io/v1
   kind: Ingress
   metadata:
     name: <name> 

   1

   
     namespace: echoserver
     annotations:
       alb.ingress.kubernetes.io/scheme: internet-facing
       alb.ingress.kubernetes.io/target-type: instance
   spec:
     ingressClassName: alb
     rules:
       - http:
           paths:
             - path: /
               pathType: Exact
               backend:
                 service:
                   name: <echoserver> 

   2

   
                   port:
                     number: 80

   Copy to Clipboard Toggle word wrap

   1

   Ingress 리소스의 이름을 지정합니다.

   2

   서비스 이름을 지정합니다.

1. 다음 명령을 실행하여 aws-load-balancer-operator 네임스페이스에 CA(인증 기관) 번들을 포함할 구성 맵을 생성합니다.

   $ oc -n aws-load-balancer-operator create configmap trusted-ca

   Copy to Clipboard Toggle word wrap

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

   $ oc -n aws-load-balancer-operator label cm trusted-ca config.openshift.io/inject-trusted-cabundle=true

   Copy to Clipboard Toggle word wrap

3. 다음 명령을 실행하여 AWS Load Balancer Operator 서브스크립션을 업데이트하여 AWS Load Balancer Operator 배포의 구성 맵에 액세스합니다.

   $ oc -n aws-load-balancer-operator patch subscription aws-load-balancer-operator --type='merge' -p '{"spec":{"config":{"env":[{"name":"TRUSTED_CA_CONFIGMAP_NAME","value":"trusted-ca"}],"volumes":[{"name":"trusted-ca","configMap":{"name":"trusted-ca"}}],"volumeMounts":[{"name":"trusted-ca","mountPath":"/etc/pki/tls/certs/albo-tls-ca-bundle.crt","subPath":"ca-bundle.crt"}]}}}'

   Copy to Clipboard Toggle word wrap

4. AWS Load Balancer Operator가 배포된 후 다음 명령을 실행하여 CA 번들이 aws-load-balancer-operator-controller-manager 배포에 추가되었는지 확인합니다.

   $ oc -n aws-load-balancer-operator exec deploy/aws-load-balancer-operator-controller-manager -c manager -- bash -c "ls -l /etc/pki/tls/certs/albo-tls-ca-bundle.crt; printenv TRUSTED_CA_CONFIGMAP_NAME"

   Copy to Clipboard Toggle word wrap

   출력 예

   -rw-r--r--. 1 root 1000690000 5875 Jan 11 12:25 /etc/pki/tls/certs/albo-tls-ca-bundle.crt
   trusted-ca

   Copy to Clipboard Toggle word wrap

5. 선택 사항: 다음 명령을 실행하여 구성 맵이 변경될 때마다 AWS Load Balancer Operator 배포를 다시 시작합니다.

   $ oc -n aws-load-balancer-operator rollout restart deployment/aws-load-balancer-operator-controller-manager

   Copy to Clipboard Toggle word wrap

프로세스

1. AWSLoadBalancerController 리소스를 정의하는 YAML 파일을 생성합니다.

   add-tls-termination-albc.yaml 파일 예

   apiVersion: networking.olm.openshift.io/v1
   kind: AWSLoadBalancerController
   metadata:
     name: cluster
   spec:
     subnetTagging: Auto
     ingressClass: tls-termination 

   1

   Copy to Clipboard Toggle word wrap

   1

   수신 클래스 이름을 정의합니다. Ingress 클래스가 클러스터에 없으면 AWS Load Balancer 컨트롤러가 하나를 생성합니다. spec.controller 가 ingress.k8s.aws/alb 로 설정된 경우 AWS Load Balancer 컨트롤러는 추가 ingress 클래스 값을 조정합니다.

2. Ingress 리소스를 정의하는 YAML 파일을 생성합니다.

   add-tls-termination-ingress.yaml 파일의 예

   apiVersion: networking.k8s.io/v1
   kind: Ingress
   metadata:
     name: <example> 

   1

   
     annotations:
       alb.ingress.kubernetes.io/scheme: internet-facing 

   2

   
       alb.ingress.kubernetes.io/certificate-arn: arn:aws:acm:us-west-2:xxxxx 

   3

   
   spec:
     ingressClassName: tls-termination 

   4

   
     rules:
     - host: example.com 

   5

   
       http:
           paths:
             - path: /
               pathType: Exact
               backend:
                 service:
                   name: <example_service> 

   6

   
                   port:
                     number: 80

   Copy to Clipboard Toggle word wrap

   1

   수신 이름을 지정합니다.

   2

   컨트롤러는 공용 서브넷에서 Ingress의 로드 밸런서를 프로비저닝하여 인터넷을 통해 로드 밸런서에 액세스합니다.

   3

   로드 밸런서에 연결하는 인증서의 ARM(Amazon Resource Name)입니다.

   4

   수신 클래스 이름을 정의합니다.

   5

   트래픽 라우팅의 도메인을 정의합니다.

   6

   트래픽 라우팅에 대한 서비스를 정의합니다.

프로세스

1. 다음과 같이 IngressClassParams 리소스 YAML 파일을 생성합니다(예: sample-single-lb-params.yaml ).

   apiVersion: elbv2.k8s.aws/v1beta1 

   1

   
   kind: IngressClassParams
   metadata:
     name: single-lb-params 

   2

   
   spec:
     group:
       name: single-lb 

   3

   Copy to Clipboard Toggle word wrap

   1

   IngressClassParams 리소스의 API 그룹 및 버전을 정의합니다.

   2

   IngressClassParams 리소스 이름을 지정합니다.

   3

   IngressGroup 리소스 이름을 지정합니다. 이 클래스의 모든 Ingress 리소스는 이 IngressGroup 에 속합니다.

2. 다음 명령을 실행하여 IngressClassParams 리소스를 생성합니다.

   $ oc create -f sample-single-lb-params.yaml

   Copy to Clipboard Toggle word wrap

3. 다음과 같이 IngressClass 리소스 YAML 파일을 생성합니다(예: sample-single-lb-class.yaml ).

   apiVersion: networking.k8s.io/v1 

   1

   
   kind: IngressClass
   metadata:
     name: single-lb 

   2

   
   spec:
     controller: ingress.k8s.aws/alb 

   3

   
     parameters:
       apiGroup: elbv2.k8s.aws 

   4

   
       kind: IngressClassParams 

   5

   
       name: single-lb-params 

   6

   Copy to Clipboard Toggle word wrap

   1

   IngressClass 리소스의 API 그룹 및 버전을 정의합니다.

   2

   Ingress 클래스 이름을 지정합니다.

   3

   컨트롤러 이름을 정의합니다. ingress.k8s.aws/alb 값은 이 클래스의 모든 수신 리소스가 AWS Load Balancer 컨트롤러에서 관리해야 함을 나타냅니다.

   4

   IngressClassParams 리소스의 API 그룹을 정의합니다.

   5

   IngressClassParams 리소스의 리소스 유형을 정의합니다.

   6

   IngressClassParams 리소스 이름을 정의합니다.

4. 다음 명령을 실행하여 IngressClass 리소스를 생성합니다.

   $ oc create -f sample-single-lb-class.yaml

   Copy to Clipboard Toggle word wrap

5. 다음과 같이 AWSLoadBalancerController 리소스 YAML 파일을 생성합니다(예: sample-single-lb.yaml ).

   apiVersion: networking.olm.openshift.io/v1
   kind: AWSLoadBalancerController
   metadata:
     name: cluster
   spec:
     subnetTagging: Auto
     ingressClass: single-lb 

   1

   Copy to Clipboard Toggle word wrap

   1

   IngressClass 리소스의 이름을 정의합니다.

6. 다음 명령을 실행하여 AWSLoadBalancerController 리소스를 생성합니다.

   $ oc create -f sample-single-lb.yaml

   Copy to Clipboard Toggle word wrap

7. 다음과 같이 Ingress 리소스 YAML 파일(예: sample-multiple-ingress.yaml )을 생성합니다.

   apiVersion: networking.k8s.io/v1
   kind: Ingress
   metadata:
     name: example-1 

   1

   
     annotations:
       alb.ingress.kubernetes.io/scheme: internet-facing 

   2

   
       alb.ingress.kubernetes.io/group.order: "1" 

   3

   
       alb.ingress.kubernetes.io/target-type: instance 

   4

   
   spec:
     ingressClassName: single-lb 

   5

   
     rules:
     - host: example.com 

   6

   
       http:
           paths:
           - path: /blog 

   7

   
             pathType: Prefix
             backend:
               service:
                 name: example-1 

   8

   
                 port:
                   number: 80 

   9

   
   ---
   apiVersion: networking.k8s.io/v1
   kind: Ingress
   metadata:
     name: example-2
     annotations:
       alb.ingress.kubernetes.io/scheme: internet-facing
       alb.ingress.kubernetes.io/group.order: "2"
       alb.ingress.kubernetes.io/target-type: instance
   spec:
     ingressClassName: single-lb
     rules:
     - host: example.com
       http:
           paths:
           - path: /store
             pathType: Prefix
             backend:
               service:
                 name: example-2
                 port:
                   number: 80
   ---
   apiVersion: networking.k8s.io/v1
   kind: Ingress
   metadata:
     name: example-3
     annotations:
       alb.ingress.kubernetes.io/scheme: internet-facing
       alb.ingress.kubernetes.io/group.order: "3"
       alb.ingress.kubernetes.io/target-type: instance
   spec:
     ingressClassName: single-lb
     rules:
     - host: example.com
       http:
           paths:
           - path: /
             pathType: Prefix
             backend:
               service:
                 name: example-3
                 port:
                   number: 80

   Copy to Clipboard Toggle word wrap

   1

   수신 이름을 지정합니다.

   2

   인터넷에 액세스하기 위해 공용 서브넷에서 프로비저닝할 로드 밸런서를 나타냅니다.

   3

   로드 밸런서에서 요청을 수신할 때 여러 수신 리소스의 규칙과 일치하는 순서를 지정합니다.

   4

   로드 밸런서가 OpenShift Container Platform 노드를 대상으로 서비스에 도달하도록 지정합니다.

   5

   이 수신에 속하는 Ingress 클래스를 지정합니다.

   6

   요청 라우팅에 사용되는 도메인 이름을 정의합니다.

   7

   서비스로 라우팅해야 하는 경로를 정의합니다.

   8

   Ingress 리소스에 구성된 엔드포인트를 제공하는 서비스 이름을 정의합니다.

   9

   엔드포인트를 제공하는 서비스의 포트를 정의합니다.

8. 다음 명령을 실행하여 Ingress 리소스를 생성합니다.

   $ oc create -f sample-multiple-ingress.yaml

   Copy to Clipboard Toggle word wrap

1. 다음 명령을 실행하여 설치 계획의 이름(예: install-zcvlr )을 확인합니다.

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

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

3. 다음 명령을 실행하여 external-dns-operator 배포의 상태를 확인합니다.

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

   Copy to Clipboard Toggle word wrap

   출력 예

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

   Copy to Clipboard Toggle word wrap

프로세스

1. 다음 명령을 실행하여 외부 DNS Operator의 로그를 확인합니다.

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

   Copy to Clipboard Toggle word wrap

프로세스

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

      Copy to Clipboard Toggle word wrap

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

      $ oc apply -f namespace.yaml

      Copy to Clipboard Toggle word wrap

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

      Copy to Clipboard Toggle word wrap

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

      $ oc apply -f operatorgroup.yaml

      Copy to Clipboard Toggle word wrap

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

      Copy to Clipboard Toggle word wrap

   2. 다음 명령을 실행하여 서브스크립션 오브젝트를 생성합니다.

      $ oc apply -f subscription.yaml

      Copy to Clipboard Toggle word wrap

검증

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

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

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

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

   $ oc -n external-dns-operator get pod

   Copy to Clipboard Toggle word wrap

   출력 예

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

   Copy to Clipboard Toggle word wrap

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

   $ oc -n external-dns-operator get subscription

   Copy to Clipboard Toggle word wrap

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

   $ oc -n external-dns-operator get csv

   Copy to Clipboard Toggle word wrap

프로세스

1. 다음 명령을 실행하여 system:admin 과 같은 사용자 프로필을 확인합니다. 사용자 프로필은 kube-system 네임스페이스에 액세스할 수 있어야 합니다. 인증 정보가 없는 경우 kube-system 네임스페이스에서 인증 정보를 가져와서 다음 명령을 실행하여 클라우드 공급자 클라이언트를 사용할 수 있습니다.

   $ oc whoami

   Copy to Clipboard Toggle word wrap

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)

   Copy to Clipboard Toggle word wrap

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

   Copy to Clipboard Toggle word wrap

3. 경로를 가져와 도메인을 확인합니다.

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

   Copy to Clipboard Toggle word wrap

   출력 예

   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

   Copy to Clipboard Toggle word wrap

4. DNS 영역 목록을 가져오고 이전에 쿼리한 경로의 도메인에 해당하는 DNS 영역을 찾습니다.

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

   Copy to Clipboard Toggle word wrap

   출력 예

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

   Copy to Clipboard Toggle word wrap

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

   Copy to Clipboard Toggle word wrap

   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

   Copy to Clipboard Toggle word wrap

프로세스

1. 계정 B가 다음 명령을 실행하여 계정 A의 Route 53 호스팅 영역에 액세스할 수 있도록 만든 IAM 역할의 역할 ARN을 가져옵니다.

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

   Copy to Clipboard Toggle word wrap

   출력 예

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

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

   출력 예

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

   Copy to Clipboard Toggle word wrap

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

   Copy to Clipboard Toggle word wrap

   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

   Copy to Clipboard Toggle word wrap

프로세스

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

   $ CLIENT_ID=$(oc get secrets azure-credentials  -n kube-system  --template={{.data.azure_client_id}} | base64 -d)

   Copy to Clipboard Toggle word wrap

   $ CLIENT_SECRET=$(oc get secrets azure-credentials  -n kube-system  --template={{.data.azure_client_secret}} | base64 -d)

   Copy to Clipboard Toggle word wrap

   $ RESOURCE_GROUP=$(oc get secrets azure-credentials  -n kube-system  --template={{.data.azure_resourcegroup}} | base64 -d)

   Copy to Clipboard Toggle word wrap

   $ SUBSCRIPTION_ID=$(oc get secrets azure-credentials  -n kube-system  --template={{.data.azure_subscription_id}} | base64 -d)

   Copy to Clipboard Toggle word wrap

   $ TENANT_ID=$(oc get secrets azure-credentials  -n kube-system  --template={{.data.azure_tenant_id}} | base64 -d)

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

   출력 예

   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

   Copy to Clipboard Toggle word wrap

4. DNS 영역 목록을 가져옵니다.

   1. 다음 명령을 실행하여 퍼블릭 DNS 영역의 경우 다음을 수행합니다.

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

      Copy to Clipboard Toggle word wrap

   2. 다음 명령을 실행하여 프라이빗 DNS 영역의 경우 다음을 수행합니다.

      $ az network private-dns zone list -g "${RESOURCE_GROUP}"

      Copy to Clipboard Toggle word wrap

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

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

   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

   Copy to Clipboard Toggle word wrap

   1

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

   2

   영역 ID를 정의합니다. 프라이빗 DNS 영역의 경우 dnszones 를 privateDnsZones 로 변경합니다.

   3

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

   4

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

   5

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

   6

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