ネットワーク Operator

手順

1. Operators → OperatorHub を選択します。
2. All Items の下の検索フィールドに、nmstate と入力し、Enter をクリックして Kubernetes NMState Operator を検索します。
3. Kubernetes NMState Operator の検索結果をクリックします。
4. Install をクリックして、Install Operator ウィンドウを開きます。
5. Install をクリックして Operator をインストールします。
6. Operator のインストールが完了したら、View Operator をクリックします。
7. Provided APIs で Create Instance をクリックし、kubernetes-nmstate のインスタンスを作成するダイアログボックスを開きます。

8. ダイアログボックスの Name フィールドで、インスタンスの名前が nmstate であることを確認します。

   注記

   名前の制限は既知の問題です。インスタンスはクラスター全体のシングルトンです。

9. デフォルト設定を受け入れ、Create をクリックしてインスタンスを作成します。

手順

1. nmstate Operator namespace を作成します。

   $ 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 ヘルスチェックプローブに問題がある場合は、次の 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 ホスト名の設定をクラスターネットワークに適用します。<filename> は、CRD ファイルの名前に置き換えます。

      $ oc apply -f <filename>.yaml

      Copy to Clipboard Toggle word wrap

手順

1. OpenShift Container Platform Web コンソールの Developer パースペクティブからメトリクスを表示する場合は、次のタスクを実行します。

   1. Observe をクリックします。
   2. 特定のプロジェクトのメトリクスを表示するには、Project: リストでプロジェクトを選択します。たとえば、openshift-nmstate です。
   3. Metrics タブをクリックします。

   4. プロット上のメトリクスを視覚化するには、Select query リストからクエリーを選択するか、Show PromQL を選択して、選択したクエリーに基づいてカスタム PromQL クエリーを作成します。

      注記

      開発者ロールでは 1 度に 1 つのクエリーのみ実行できます。

2. 管理者として OpenShift Container Platform Web コンソールでメトリクスを表示する場合は、以下のタスクを実行します。

   1. Observe → Metrics をクリックします。
   2. Expression フィールドに kubernetes_nmstate_features_applied と入力します。
   3. Add query をクリックし、Run queries をクリックします。

3. 視覚化されたメトリクスを調べるには、次のいずれかのタスクを実行します。

   1. プロットを拡大して時間範囲を変更するには、次のいずれかのタスクを実行します。

      • 時間範囲を視覚的に選択するには、プロットをクリックして水平にドラッグします。
      • 時間範囲を選択するには、コンソールの左上にあるメニューを使用します。
   2. 時間の範囲をリセットするには、Reset zoom を選択します。
   3. 特定の時点におけるすべてのクエリーの出力を表示するには、その時点でプロット上にマウスカーソルを置きます。クエリー出力がポップアップボックスに表示されます。

手順

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. 以下のコマンドを実行して 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

   AWS Load Balancer Operator の AWS 認証情報をプロビジョニングするために CredentialsRequest で使用する ARN ロールを指定します。<albo_role_arn> の例は、arn:aws:iam::<aws_account_number>:role/albo-operator です。

   注記

   AWS Load Balancer Operator は、シークレットが作成されるまで待機してから、Available ステータスに移行します。

手順

1. OpenShift Container Platform Web コンソールで、Operators → OperatorHub に移動します。
2. AWS Load Balancer Operator を選択します。Filter by keyword テキストボックスを使用するか、フィルターリストを使用して、Operator のリストから AWS Load Balancer Operator を検索できます。
3. aws-load-balancer-operator namespace を選択します。

4. Install Operator ページで、次のオプションを選択します。

   1. Update the channel で stable-v1 を選択します。
   2. Installation mode で All namespaces on the cluster (default) を選択します。
   3. Installed Namespace で aws-load-balancer-operator を選択します。aws-load-balancer-operator namespace が存在しない場合は、Operator のインストール中に作成されます。
   4. Update approval で Automatic または Manual を選択します。デフォルトでは、Update approval は Automatic に設定されています。Automatic (自動) 更新を選択した場合、Operator Lifecycle Manager (OLM) は介入なしに、Operator の実行中のインスタンスを自動的にアップグレードします。手動更新を選択した場合、OLM は更新要求を作成します。クラスター管理者は、Operator を新規バージョンに更新できるように更新要求を手動で承認する必要があります。
5. Install をクリックします。

手順

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 Controller 名を定義します。このインスタンス名は、関連するすべてのリソースの接尾辞として追加されます。

   3

   AWS Load Balancer Controller のサブネットのタグ付け方法を設定します。次の値が有効です。

   • Auto: AWS Load Balancer Operator は、クラスターに属するサブネットを決定し、適切にタグ付けします。内部サブネットタグが内部サブネットに存在しない場合、Operator はロールを正しく判別できません。
   • Manual: クラスターに属するサブネットに適切なロールタグを手動でタグ付けします。ユーザー提供のインフラストラクチャーにクラスターをインストールした場合は、このオプションを使用します。

   4

   AWS Load Balancer Controller が AWS リソースをプロビジョニングするときに使用するタグを定義します。

   5

   Ingress クラス名を定義します。デフォルト値は alb です。

   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. 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 namespace に認証局 (CA) バンドルを含める config map を作成します。

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

   Copy to Clipboard Toggle word wrap

2. 信頼できる CA バンドルを config map に挿入するには、次のコマンドを実行して、config.openshift.io/inject-trusted-cabundle=true ラベルを config map に追加します。

   $ 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 デプロイメントの config map にアクセスできるように 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. オプション: config-map が変更されるたびに、次のコマンドを実行して、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 クラス名を定義します。クラスター内に Ingress クラスが存在しない場合は、AWS Load Balancer Controller によって作成されます。spec.controller が ingress.k8s.aws/alb に設定されている場合、AWS Load Balancer Controller は追加の 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

   Ingress 名を指定します。

   2

   コントローラーは、パブリックサブネット内の Ingress のロードバランサーをプロビジョニングし、インターネット経由でロードバランサーにアクセスします。

   3

   ロードバランサーに割り当てる証明書の Amazon Resource Name (ARN)。

   4

   Ingress クラス名を定義します。

   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

   API グループと IngressClass リソースのバージョンを定義します。

   2

   Ingress クラス名を指定します。

   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

   Ingress 名を指定します。

   2

   インターネットにアクセスするためにパブリックサブネットにプロビジョニングするロードバランサーを示します。

   3

   ロードバランサーで要求を受信したときに、複数の Ingress リソースからのルールをマッチする順序を指定します。

   4

   ロードバランサーがサービスに到達するために OpenShift Container Platform ノードをターゲットにすることを示します。

   5

   この Ingress に属する Ingress クラスを指定します。

   6

   要求のルーティングに使用するドメイン名を定義します。

   7

   サービスにルーティングする必要があるパスを定義します。

   8

   Ingress リソースで設定されたエンドポイントを提供するサービス名を定義します。

   9

   エンドポイントにサービスを提供するサービスのポートを定義します。

8. 次のコマンドを実行して Ingress リソースを作成します。

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

   Copy to Clipboard Toggle word wrap

手順

1. bpfman namespace を作成するには、次のコマンドを入力します。

   $ 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 の Subscription 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 Web コンソールで、Operators → OperatorHub をクリックします。
   2. 利用可能な Operator のリストから eBPF Manager Operator を選択し、コミュニティー Operator を表示する ように求められたら、Continue をクリックします。
   3. Install をクリックします。
   4. Install Operator ページの Installed Namespace で、Operator recommended Namespace を選択します。
   5. Install をクリックします。

2. eBPF Manager Operator が正常にインストールされていることを確認します。

   1. Operators → Installed Operators ページに移動します。

   2. eBPF Manager Operator が、Status が InstallSucceeded で openshift-ingress-node-firewall プロジェクトにリストされていることを確認します。

      注記

      インストール時に、Operator は Failed ステータスを表示する可能性があります。インストールが後に InstallSucceeded メッセージを出して正常に実行される場合は、Failed メッセージを無視できます。

      Operator の Status が InstallSucceeded でない場合は、次の手順を使用してトラブルシューティングを行います。

      • Operator Subscriptions および Install Plans タブで、Status の下の失敗またはエラーの有無を確認します。
      • Workloads → Pods ページに移動し、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
   ...

   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. 次のコマンドを実行して、External 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 Web コンソールで、Operators → OperatorHub をクリックします。
2. External DNS Operator をクリックします。Filter by keyword のテキストボックスまたはフィルターリストを使用して、Operator のリストから External DNS Operator を検索できます。
3. external-dns-operator namespace を選択します。
4. External DNS Operator ページで Install をクリックします。

5. Install Operator ページで、次のオプションを選択していることを確認してください。

   1. Update the channel で stable-v1.0 を選択します。
   2. Installation mode で A specific name on the cluster を選択します。
   3. Installed namespace で external-dns-operator を選択します。namespace external-dns-operator が存在しない場合は、Operator のインストール中に作成されます。
   4. Approval Strategy で Automatic または Manual を選択します。Approval Strategy はデフォルトで Automatic に設定されています。
   5. Install をクリックします。

手順

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

5. 次のコマンドを実行して、external-dns-operator のバージョンを確認します。

   $ oc -n external-dns-operator get csv

   Copy to Clipboard Toggle word wrap

手順

1. 次のコマンドを実行して、system:admin などのユーザープロファイルを確認します。ユーザープロファイルには、kube-system namespace へのアクセス権が必要です。認証情報がない場合は、次のコマンドを実行して、kube-system namespace から認証情報を取得し、クラウドプロバイダークライアントを使用できます。

   $ oc whoami

   Copy to Clipboard Toggle word wrap

2. kube-system namespace に存在する 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. route ソースの 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 Route53DNS プロバイダーを定義します。

   6

   DNS レコードのソースのオプションを定義します。

   7

   以前に指定された DNS プロバイダーで作成される DNS レコードのソースとして OpenShift route リソースを定義します。

   8

   ソースが OpenShiftRoute の場合に、OpenShift Ingress Controller 名を指定できます。External 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