네트워킹 운영자

프로세스

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 연산자 네임스페이스를 만듭니다.

   $ 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 운영자 구독:

   $ 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 연산자의 인스턴스를 생성합니다.

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

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

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

      $ oc apply -f <filename>.yaml

      Copy to Clipboard Toggle word wrap

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

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

      Copy to Clipboard Toggle word wrap

검증

1. 다음 명령을 입력하여 NMState Operator의 모든 포드가 Running 상태인지 확인하세요.

   $ oc get pod -n openshift-nmstate

   Copy to Clipboard Toggle word wrap

프로세스

1. OpenShift Container Platform 웹 콘솔에서 개발자 관점에서 메트릭을 보려면 다음 작업을 완료하세요.

   1. 관찰을 클릭하세요.
   2. 특정 프로젝트의 지표를 보려면 프로젝트 목록에서 프로젝트를 선택하세요. 예를 들어, openshift-nmstate .
   3. 메트릭 탭을 클릭합니다.

   4. 플롯의 메트릭을 시각화하려면 쿼리 선택 목록에서 쿼리를 선택하거나 'PromQL 표시'를 선택하여 선택한 쿼리를 기반으로 사용자 지정 PromQL 쿼리를 만듭니다.

      참고

      개발자 역할로는 한 번에 하나의 쿼리만 실행할 수 있습니다.

2. 관리자 권한으로 OpenShift Container Platform 웹 콘솔에서 메트릭을 보려면 다음 작업을 완료하세요.

   1. 관찰 → 지표를 클릭합니다.
   2. 표현식 필드에 kubernetes_nmstate_features_applied를 입력합니다.
   3. 쿼리 추가를 클릭한 다음 쿼리 실행을 클릭합니다.

3. 시각화된 지표를 살펴보려면 다음 작업 중 하나를 수행하세요.

   1. 플롯을 확대하고 시간 범위를 변경하려면 다음 작업 중 하나를 수행하세요.

      • 시간 범위를 시각적으로 선택하려면 플롯을 수평으로 클릭하고 드래그하세요.
      • 시간 범위를 선택하려면 콘솔의 왼쪽 상단에 있는 메뉴를 사용하세요.
   2. 시간 범위를 재설정하려면 확대/축소 재설정을 선택합니다.
   3. 특정 시점의 모든 쿼리에 대한 출력을 표시하려면 해당 시점의 플롯에 마우스 커서를 올려놓으세요. 쿼리 출력은 팝업 상자에 표시됩니다.

프로세스

1. OperatorHub에서 AWS Load Balancer Operator를 주문형으로 배포하려면 다음 명령을 실행하여 구독 객체를 만듭니다.

   $ oc -n aws-load-balancer-operator get sub 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

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

   AWS Load Balancer Operator에 대한 AWS 자격 증명을 프로비저닝하기 위해 CredentialsRequest 에서 사용할 ARN 역할을 지정합니다. <albo_role_arn> 의 예는 arn:aws:iam::<aws_account_number>:role/albo-operator 입니다.

   참고

   AWS 로드 밸런서 운영자는 비밀이 생성될 때까지 기다린 후 사용 가능 상태로 전환합니다.

프로세스

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

4. 설치 운영자 페이지에서 다음 옵션을 선택하세요.

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

프로세스

1. 네임스페이스 객체를 만듭니다.

   1. 네임스페이스 객체를 정의하는 YAML 파일을 만듭니다.

      namespace.yaml 파일 예

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

      Copy to Clipboard Toggle word wrap

   2. 다음 명령을 실행하여 네임스페이스 객체를 만듭니다.

      $ 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. 구독 객체를 정의하는 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

   출력은 완료 되어야 합니다.

프로세스

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 Controller 이름을 정의합니다. 이 인스턴스 이름은 모든 관련 리소스에 접미사로 추가됩니다.

   3

   AWS Load Balancer Controller에 대한 서브넷 태그 지정 방법을 구성합니다. 유효한 값은 다음과 같습니다.

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

   4

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

   5

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

   6

   AWS Load Balancer Controller의 복제본 수를 지정합니다.

   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. 배포 리소스를 정의하는 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. 서비스 리소스를 정의하는 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

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

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

   컨트롤러는 인터넷을 통해 로드 밸런서에 액세스할 수 있도록 공용 서브넷에서 로드 밸런서의 수신을 프로비저닝합니다.

   3

   로드 밸런서에 첨부하는 인증서의 Amazon 리소스 이름(ARN)입니다.

   4

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

   5

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

   6

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

프로세스

1. 다음과 같이 sample-single-lb-params.yaml 과 같은 IngressClassParams 리소스 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

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

   3

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

   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

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

   6

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

   7

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

   8

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

   9

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

8. 다음 명령을 실행하여 Ingress 리소스를 만듭니다.

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

   Copy to Clipboard Toggle word wrap

프로세스

1. bpfman 네임스페이스를 만들려면 다음 명령을 입력하세요.

   $ cat << EOF| oc create -f -
   apiVersion: v1
   kind: Namespace
   metadata:
     labels:
       pod-security.kubernetes.io/enforce: privileged
       pod-security.kubernetes.io/enforce-version: v1.24
     name: bpfman
   EOF

   Copy to Clipboard Toggle word wrap

2. OperatorGroup CR을 생성하려면 다음 명령을 입력합니다.

   $ cat << EOF| oc create -f -
   apiVersion: operators.coreos.com/v1
   kind: OperatorGroup
   metadata:
     name: bpfman-operators
     namespace: bpfman
   EOF

   Copy to Clipboard Toggle word wrap

3. eBPF 관리자 운영자를 구독하세요.

   1. eBPF 관리자 운영자에 대한 구독 CR을 생성하려면 다음 명령을 입력하세요.

      $ cat << EOF| oc create -f -
      apiVersion: operators.coreos.com/v1alpha1
      kind: Subscription
      metadata:
        name: bpfman-operator
        namespace: bpfman
      spec:
        name: bpfman-operator
        channel: alpha
        source: community-operators
        sourceNamespace: openshift-marketplace
      EOF

      Copy to Clipboard Toggle word wrap

4. Operator가 설치되었는지 확인하려면 다음 명령을 입력합니다.

   $ oc get ip -n bpfman

   Copy to Clipboard Toggle word wrap

   출력 예

   NAME            CSV                                 APPROVAL    APPROVED
   install-ppjxl   security-profiles-operator.v0.8.5   Automatic   true

   Copy to Clipboard Toggle word wrap

5. Operator 버전을 확인하려면 다음 명령을 입력하세요.

   $ oc get csv -n bpfman

   Copy to Clipboard Toggle word wrap

   출력 예

   NAME                                DISPLAY                      VERSION   REPLACES                            PHASE
   bpfman-operator.v0.5.0              eBPF Manager Operator              0.5.0     bpfman-operator.v0.4.2              Succeeded

   Copy to Clipboard Toggle word wrap

프로세스

1. eBPF 관리자 운영자를 설치하세요:

   1. OpenShift Container Platform 웹 콘솔에서 Operator → OperatorHub를 클릭합니다.
   2. 사용 가능한 운영자 목록에서 eBPF 관리자 운영자를 선택하고 커뮤니티 운영자 표시 여부를 묻는 메시지가 표시되면 계속을 클릭합니다.
   3. 설치를 클릭합니다.
   4. Operator 설치 페이지의 설치된 네임스페이스 에서 Operator 권장 네임스페이스를 선택합니다.
   5. 설치를 클릭합니다.

2. eBPF Manager Operator가 성공적으로 설치되었는지 확인하세요.

   1. Operator → 설치된 Operator 페이지로 이동합니다.

   2. eBPF Manager Operator가 openshift-ingress-node-firewall 프로젝트에 InstallSucceeded 상태 로 나열되어 있는지 확인하세요.

      참고

      설치 중에 Operator는 실패 상태를 표시할 수 있습니다. 나중에 InstallSucceeded 메시지와 함께 설치에 성공하면 이 실패 메시지를 무시할 수 있습니다.

      운영자의 상태가 InstallSucceeded가 아닌 경우 다음 단계에 따라 문제를 해결하세요.

      • Operator 서브스크립션 및 설치 계획 탭의 상태 아래에서 장애 또는 오류가 있는지 점검합니다.
      • 워크로드 → 포드 페이지로 이동하여 bpfman 프로젝트의 포드 로그를 확인하세요.

프로세스

1. 매니페스트를 다운로드하려면 다음 명령을 입력하세요.

   $ curl -L https://github.com/bpfman/bpfman/releases/download/v0.5.1/go-xdp-counter-install-selinux.yaml -o go-xdp-counter-install-selinux.yaml

   Copy to Clipboard Toggle word wrap

2. 샘플 eBPF 애플리케이션을 배포하려면 다음 명령을 입력하세요.

   $ oc create -f go-xdp-counter-install-selinux.yaml

   Copy to Clipboard Toggle word wrap

   출력 예

   namespace/go-xdp-counter created
   serviceaccount/bpfman-app-go-xdp-counter created
   clusterrolebinding.rbac.authorization.k8s.io/xdp-binding created
   daemonset.apps/go-xdp-counter-ds created
   xdpprogram.bpfman.io/go-xdp-counter-example created
   selinuxprofile.security-profiles-operator.x-k8s.io/bpfman-secure created

   Copy to Clipboard Toggle word wrap

3. eBPF 샘플 애플리케이션이 성공적으로 배포되었는지 확인하려면 다음 명령을 입력하세요.

   $ oc get all -o wide -n go-xdp-counter

   Copy to Clipboard Toggle word wrap

   출력 예

   NAME                          READY   STATUS    RESTARTS   AGE   IP             NODE                                 NOMINATED NODE   READINESS GATES
   pod/go-xdp-counter-ds-4m9cw   1/1     Running   0          44s   10.129.0.92    ci-ln-dcbq7d2-72292-ztrkp-master-1   <none>           <none>
   pod/go-xdp-counter-ds-7hzww   1/1     Running   0          44s   10.130.0.86    ci-ln-dcbq7d2-72292-ztrkp-master-2   <none>           <none>
   pod/go-xdp-counter-ds-qm9zx   1/1     Running   0          44s   10.128.0.101   ci-ln-dcbq7d2-72292-ztrkp-master-0   <none>           <none>
   
   NAME                               DESIRED   CURRENT   READY   UP-TO-DATE   AVAILABLE   NODE SELECTOR   AGE   CONTAINERS       IMAGES                                           SELECTOR
   daemonset.apps/go-xdp-counter-ds   3         3         3       3            3           <none>          44s   go-xdp-counter   quay.io/bpfman-userspace/go-xdp-counter:v0.5.0   name=go-xdp-counter

   Copy to Clipboard Toggle word wrap

4. 예제 XDP 프로그램이 실행 중인지 확인하려면 다음 명령을 입력하세요.

   $ oc get xdpprogram go-xdp-counter-example

   Copy to Clipboard Toggle word wrap

   출력 예

   NAME                     BPFFUNCTIONNAME   NODESELECTOR   STATUS
   go-xdp-counter-example   xdp_stats         {}             ReconcileSuccess

   Copy to Clipboard Toggle word wrap

5. XDP 프로그램이 데이터를 수집하고 있는지 확인하려면 다음 명령을 입력하세요.

   $ oc logs <pod_name> -n go-xdp-counter

   Copy to Clipboard Toggle word wrap

   <pod_name>을 go-xdp-counter-ds-4m9cw 와 같은 XDP 프로그램 Pod의 이름으로 바꾸세요.

   출력 예

   2024/08/13 15:20:06 15016 packets received
   2024/08/13 15:20:06 93581579 bytes received
   ...

   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. 다음 명령을 실행하여 설치 계획의 상태가 완료 인지 확인하세요.

   $ 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 운영자의 로그를 확인하세요.

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

   Copy to Clipboard Toggle word wrap

프로세스

1. OpenShift Container Platform 웹 콘솔에서 Operator → OperatorHub를 클릭합니다.
2. 외부 DNS 운영자를 클릭합니다. 키워드로 필터링 텍스트 상자나 필터 목록을 사용하여 운영자 목록에서 외부 DNS 운영자를 검색할 수 있습니다.
3. external-dns-operator 네임스페이스를 선택합니다.
4. 외부 DNS 운영자 페이지에서 설치를 클릭합니다.

5. 설치 운영자 페이지에서 다음 옵션을 선택했는지 확인하세요.

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

프로세스

1. 네임스페이스 객체를 만듭니다.

   1. 네임스페이스 객체를 정의하는 YAML 파일을 만듭니다.

      namespace.yaml 파일 예

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

      Copy to Clipboard Toggle word wrap

   2. 다음 명령을 실행하여 네임스페이스 객체를 만듭니다.

      $ 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. 구독 객체를 정의하는 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. 다음 명령을 실행하여 설치 계획의 상태가 완료 인지 확인하세요.

   $ 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의 상태가 실행 중인지 확인하세요.

   $ 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 secret에서 값을 가져옵니다.

   $ 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

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

   8

   소스가 OpenShiftRoute 인 경우 OpenShift Ingress Controller 이름을 전달할 수 있습니다. 외부 DNS 운영자는 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