Networking Operator

프로세스

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

   출력 예

   Name                                                          Phase
   kubernetes-nmstate-operator.4.18.0-202210210157  Succeeded

   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. NMState Operator의 모든 Pod가 Running 상태인지 확인합니다.

   $ oc get pod -n openshift-nmstate

   Copy to Clipboard Toggle word wrap

   출력 예

   Name                                      Ready   Status   Restarts  Age
   pod/nmstate-handler-wn55p                 1/1     Running  0         77s
   pod/nmstate-operator-f6bb869b6-v5m92      1/1     Running  0         4m51s
   ...

   Copy to Clipboard Toggle word wrap

프로세스

1. OpenShift Container Platform 웹 콘솔의 개발자 화면에서 메트릭을 보려면 다음 작업을 완료합니다.

   1. 모니터링 을 클릭합니다.
   2. 특정 프로젝트의 메트릭을 보려면 Project: 목록에서 프로젝트를 선택합니다. 예를 들면 openshift-nmstate 입니다.
   3. 지표 탭을 클릭합니다.

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

      참고

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

2. OpenShift Container Platform 웹 콘솔의 관리자 관점에서 메트릭을 보려면 다음 작업을 완료합니다.

   1. 모니터링 → 메트릭 을 클릭합니다.
   2. Expression 필드에 kubernetes_nmstate_features_applied 를 입력합니다.
   3. 쿼리 추가를 클릭한 다음 쿼리 실행을 클릭합니다.

3. 시각화된 메트릭을 살펴보려면 다음 작업을 수행합니다.

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

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

프로세스

1. 다음 명령을 실행하여 Subscription 오브젝트를 생성하여 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

   출력 예

   install-zlfbt

   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

   출력 예

   Complete

   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. 다음 명령을 실행하여 Subscription 오브젝트를 생성합니다.

   $ 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. 다음 명령을 실행하여 Subscription 오브젝트를 생성합니다.

      $ 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. 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 Manager Operator를 구독합니다.

   1. eBPF Manager Operator에 대한 서브스크립션 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 Manager Operator를 설치합니다.

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

2. eBPF Manager Operator가 설치되었는지 확인합니다.

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

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

      참고

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

      Operator에 InstallSucceeded 상태가 없는 경우 다음 단계를 사용하여 문제를 해결합니다.

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

프로세스

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
   
   2024/08/13 15:20:09 19284 packets received
   2024/08/13 15:20:09 99638680 bytes received
   
   2024/08/13 15:20:12 23522 packets received
   2024/08/13 15:20:12 105666062 bytes received
   
   2024/08/13 15:20:15 27276 packets received
   2024/08/13 15:20:15 112028608 bytes received
   
   2024/08/13 15:20:18 29470 packets received
   2024/08/13 15:20:18 112732299 bytes received
   
   2024/08/13 15:20:21 32588 packets received
   2024/08/13 15:20:21 113813781 bytes received

   Copy to Clipboard Toggle word wrap

1. 다음 명령을 실행하여 설치 계획의 이름을 확인합니다.

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

   Copy to Clipboard Toggle word wrap

   출력 예

   install-zcvlr

   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

   출력 예

   Complete

   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. 다음 명령을 실행하여 Subscription 오브젝트를 생성합니다.

      $ 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

   출력 예

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

   Copy to Clipboard Toggle word wrap

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

   $ oc -n external-dns-operator get csv

   Copy to Clipboard Toggle word wrap

   출력 예

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

   Copy to Clipboard Toggle word wrap