ネットワーク Operator

手順

1. Ecosystem → Software Catalog を選択します。
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

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

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

4. nmstate Operator デプロイメントの ClusterServiceVersion (CSV) ステータスが Succeeded であることを確認します。

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

5. nmstate Operator のインスタンスを作成します。

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

6. DNS 接続の問題が原因でクラスターで DNS ヘルスチェックプローブに問題がある場合は、次の DNS ホスト名設定を NMState CRD に追加して、これらの問題を解決できるヘルスチェックを組み込むことができます。

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

   1. 次のコマンドを実行して、DNS ホスト名の設定をクラスターネットワークに適用します。<filename> は、CRD ファイルの名前に置き換えます。

      $ oc apply -f <filename>.yaml

   2. 次のコマンドを実行して、リソースが Available 条件に達するまで nmstate CRD を監視します。--timeout オプションの値を設定して、設定した最大待機時間内に Available 条件が満たされなかった場合にコマンドがタイムアウトし、エラーメッセージが生成されるようにします。

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

検証

1. 次のコマンドを入力して、NMState Operator のすべての Pod のステータスが Running であることを確認します。

   $ oc get pod -n openshift-nmstate

手順

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. ソフトウェアカタログからオンデマンドで AWS Load Balancer Operator をデプロイするには、次のコマンドを実行して Subscription オブジェクトを作成します。

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

2. 次のコマンドを実行して、インストールプランのステータスが Complete になっているか確認します。

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

3. 次のコマンドを実行して、aws-load-balancer-operator-controller-manager デプロイメントのステータスを表示します。

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

   出力例

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

手順

1. 次のコマンドを実行して、aws-load-balancer-operator プロジェクトを作成します。

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

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

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>"
   EOF

   ここでは、以下のようになります。

   <albo_role_arn>

   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 コンソールで、Ecosystem → Software Catalog に移動します。
2. AWS Load Balancer Operator を選択します。キーワードによるフィルタリング テキストボックスまたはフィルターリストを使用して、Operator のリストから AWS Load Balancer Operator を検索できます。
3. aws-load-balancer-operator namespace を選択します。

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

   1. チャネルを更新する オプションでは、stable-v1 を選択してください。
   2. インストールモードの オプションでは、クラスター上のすべての名前空間 (デフォルト) を選択します。
   3. インストール済み名前空間 必要に応じて、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
      # ...

   2. 次のコマンドを実行して、Namespace オブジェクトを作成します。

      $ oc apply -f namespace.yaml

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

   2. 以下のコマンドを実行して OperatorGroup オブジェクトを作成します。

      $ oc apply -f operatorgroup.yaml

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

   2. 以下のコマンドを実行して Subscription オブジェクトを作成します。

      $ oc apply -f subscription.yaml

検証

1. サブスクリプションからインストールプランの名前を取得します。

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

2. インストールプランのステータスを確認します。

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

   出力は Complete でなければなりません。

手順

1. AWSLoadBalancerController オブジェクトを定義する YAML ファイルを作成します。

   sample-aws-lb.yaml ファイルの例

   apiVersion: networking.olm.openshift.io/v1
   kind: AWSLoadBalancerController
   metadata:
     name: cluster
   spec:
     subnetTagging: Auto
     additionalResourceTags:
     - key: example.org/security-scope
       value: staging
     ingressClass: alb
     config:
       replicas: 2
     enabledAddons:
       - AWSWAFv2

   ここでは、以下のようになります。

   kind

   AWSLoadBalancerController オブジェクトを指定します。

   metadata.name

   AWS Load Balancer Controller の名前を指定します。Operator は、このインスタンス名を関連するすべてのリソースの接尾辞として追加します。

   仕様サブネットタグ付け

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

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

   spec.additionalResourceTags

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

   ingressClass

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

   config.replicas

   AWS Load Balancer Controller のレプリカの数を指定します。

   有効なアドオン

   AWS Load Balancer Controller のアドオンとしてアノテーションを指定します。

   AWSWAFv2

   alb.ingress.kubernetes.io/wafv2-acl-arn アノテーションの有効化を指定します。

2. 次のコマンドを実行して、AWSLoadBalancerController オブジェクトを作成します。

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

3. Deployment リソースを定義する YAML ファイルを作成します。

   sample-aws-lb.yaml ファイルの例

   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: <echoserver>
     namespace: echoserver
   spec:
     selector:
       matchLabels:
         app: echoserver
     replicas: 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

   ここでは、以下のようになります。

   kind

   デプロイメントリソースを指定します。

   metadata.name

   デプロイメント名を指定します。

   spec.replicas

   デプロイメントのレプリカの数を指定します。

4. Service リソースを定義する YAML ファイルを作成します。

   service-albo.yaml ファイルの例

   apiVersion: v1
   kind: Service
   metadata:
     name: <echoserver>
     namespace: echoserver
   spec:
     ports:
       - port: 80
         targetPort: 8080
         protocol: TCP
     type: NodePort
     selector:
       app: echoserver

   ここでは、以下のようになります。

   apiVersion

   サービスリソースを指定します。

   metadata.name

   サービス名を指定します。

5. Ingress リソースを定義する YAML ファイルを作成します。

   Ingress-albo.yaml ファイルの例

   apiVersion: networking.k8s.io/v1
   kind: Ingress
   metadata:
     name: <name>
     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>
                   port:
                     number: 80

   ここでは、以下のようになります。

   metadata.name

   Ingress リソースの名前を指定します。

   service.name

   サービス名を指定します。

手順

1. 次のコマンドを実行して、aws-load-balancer-operator namespace に認証局 (CA) バンドルを含める config map を作成します。

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

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

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"}]}}}'

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"

   出力例

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

5. オプション: config-map が変更されるたびに、次のコマンドを実行して、AWS Load Balancer Operator のデプロイを再開します。

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

手順

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
   # ...

   ここでは、以下のようになります。

   spec.ingressClass

   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>
     annotations:
       alb.ingress.kubernetes.io/scheme: internet-facing
       alb.ingress.kubernetes.io/certificate-arn: arn:aws:acm:us-west-2:xxxxx
   spec:
     ingressClassName: tls-termination
     rules:
     - host: example.com
       http:
           paths:
             - path: /
               pathType: Exact
               backend:
                 service:
                   name: <example_service>
                   port:
                     number: 80
   # ...

   ここでは、以下のようになります。

   metadata.name

   Ingress 名を指定します。

   annotations.alb.ingress.kubernetes.io/scheme

   Ingress 用のロードバランサーをプロビジョニングするコントローラーを指定します。プロビジョニングは、インターネット経由でロードバランサーにアクセスするためのパブリックサブネットで行われます。

   annotations.alb.ingress.kubernetes.io/certificate-arn

   ロードバランサーにアタッチする証明書の Amazon Resource Name (ARN) を指定します。

   spec.ingressClassName

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

   ルールホスト

   トラフィックルーティングのドメインを指定します。

   バックエンドサービス

   トラフィックルーティングに使用するサービスを指定します。

手順

1. 次のように、IngressClassParams リソースの YAML ファイル (例: sample-single-lb-params.yaml) を作成します。

   apiVersion: elbv2.k8s.aws/v1beta1
   kind: IngressClassParams
   metadata:
     name: single-lb-params
   spec:
     group:
       name: single-lb

   ここでは、以下のようになります。

   apiVersion

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

   metadata.name

   IngressClassParams リソース名を指定します。

   仕様グループ名

   IngressGroup リソース名を指定します。このクラスのすべての Ingress リソースは、この IngressGroup に属します。

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

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

3. 次のように、IngressClass リソースの YAML ファイル (例: sample-single-lb-class.yaml) を作成します。

   apiVersion: networking.k8s.io/v1
   kind: IngressClass
   metadata:
     name: single-lb
   spec:
     controller: ingress.k8s.aws/alb
     parameters:
       apiGroup: elbv2.k8s.aws
       kind: IngressClassParams
       name: single-lb-params

   ここでは、以下のようになります。

   apiVersion

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

   metadata.name

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

   仕様コントローラー

   コントローラー名を指定します。ingress.k8s.aws/alb という値は、このクラスのすべての Ingress リソースを AWS Load Balancer Controller によって管理することを意味します。

   パラメーター.apiGroup

   IngressClassParams リソースの API グループを指定します。

   パラメーターの種類

   IngressClassParams リソースのリソースタイプを指定します。

   パラメーター名

   IngressClassParams リソース名を指定します。

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

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

5. 次のように、AWSLoadBalancerController リソース YAML ファイル (例: sample-single-lb.yaml) を作成します。

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

   ここでは、以下のようになります。

   spec.ingressClass

   IngressClass リソースの名前を指定します。

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

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

7. 次のように、Ingress リソースの YAML ファイル (例: sample-multiple-ingress.yaml) を作成します。

   apiVersion: networking.k8s.io/v1
   kind: Ingress
   metadata:
     name: example-1
     annotations:
       alb.ingress.kubernetes.io/scheme: internet-facing
       alb.ingress.kubernetes.io/group.order: "1"
       alb.ingress.kubernetes.io/target-type: instance
   spec:
     ingressClassName: single-lb
     rules:
     - host: example.com
       http:
           paths:
           - path: /blog
             pathType: Prefix
             backend:
               service:
                 name: example-1
                 port:
                   number: 80
   ---
   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

   ここでは、以下のようになります。

   metadata.name

   Ingress 名を指定します。

   alb.ingress.kubernetes.io/scheme

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

   alb.ingress.kubernetes.io/group.order

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

   alb.ingress.kubernetes.io/target-type

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

   spec.ingressClassName

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

   ルールホスト

   リクエストルーティングに使用するドメイン名を指定します。

   http.paths.path

   サービスへのルーティングに必要なパスを指定します。

   バックエンドサービス名

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

   ポート番号

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

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

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

手順

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

2. OperatorGroup CR を作成するには、以下のコマンドを実行します。

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

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

4. Operator がインストールされていることを確認するには、以下のコマンドを入力します。

   $ oc get ip -n bpfman

   出力例

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

5. Operator のバージョンを確認するには、次のコマンドを入力します。

   $ oc get csv -n bpfman

   出力例

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

手順

1. eBPF Manager Operator をインストールします。

   1. OpenShift Container Platform Web コンソールで、Ecosystem → Software Catalog をクリックします。
   2. 利用可能な Operator のリストから eBPF Manager Operator を選択し、コミュニティー Operator を表示する ように求められたら、Continue をクリックします。
   3. Install をクリックします。
   4. Install Operator ページの Installed Namespace で、Operator recommended Namespace を選択します。
   5. Install をクリックします。

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

   1. Ecosystem → 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

2. サンプル eBPF アプリケーションをデプロイするには、次のコマンドを実行します。

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

   出力例

   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

3. eBPF サンプルアプリケーションが正常にデプロイされたことを確認するには、次のコマンドを実行します。

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

   出力例

   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

4. サンプル XDP プログラムが実行していることを確認するには、次のコマンドを実行します。

   $ oc get xdpprogram go-xdp-counter-example

   出力例

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

5. XDP プログラムがデータを収集していることを確認するには、次のコマンドを実行します。

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

   <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
   ...

手順

1. 次のコマンドを実行して、install-zcvlr などのインストールプランの名前を確認します。

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

2. 次のコマンドを実行して、インストールプランのステータスが Complete になっているか確認します。

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

3. 次のコマンドを実行して、external-dns-operator デプロイメントのステータスを表示します。

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

   出力例

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

手順

1. OpenShift Container Platform Web コンソールで、Ecosystem → Software Catalog をクリックします。
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 を選択します。名前空間 external-dns-operator が 存在しない場合、Operator は Operator のインストール中に作成されます。
   4. Approval Strategy で Automatic または Manual を選択します。承認ストラテジーはデフォルトで 自動 に設定されています。

   5. Install をクリックします。

      Automatic (自動) 更新を選択した場合、Operator Lifecycle Manager (OLM) は介入なしに、Operator の実行中のインスタンスを自動的にアップグレードします。

      Manual 更新を選択した場合、OLM は更新要求を作成します。クラスター管理者は、Operator が新規バージョンに更新されるように更新要求を手動で承認する必要があります。

手順

1. Namespace オブジェクトを作成します。

   1. Namespace オブジェクトを定義する YAML ファイルを作成します。

      namespace.yaml ファイルの例

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

   2. 次のコマンドを実行して、Namespace オブジェクトを作成します。

      $ oc apply -f namespace.yaml

2. OperatorGroup オブジェクトを作成します。

   1. OperatorGroup オブジェクトを定義する YAML ファイルを作成します。

      operatorgroup.yaml ファイルの例

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

   2. 以下のコマンドを実行して OperatorGroup オブジェクトを作成します。

      $ oc apply -f operatorgroup.yaml

3. Subscription オブジェクトを作成します。

   1. Subscription オブジェクトを定義する YAML ファイルを作成します。

      subscription.yaml ファイルの例

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

   2. 以下のコマンドを実行して Subscription オブジェクトを作成します。

      $ oc apply -f subscription.yaml

検証

1. 次のコマンドを実行して、サブスクリプションからインストールプランの名前を取得します。

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

2. 次のコマンドを実行して、インストールプランのステータスが Complete であることを確認します。

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

3. 次のコマンドを実行して、external-dns-operator Pod のステータスが Running であることを確認します。

   $ oc -n external-dns-operator get pod

   出力例

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

4. 次のコマンドを実行して、サブスクリプションのカタログソースが redhat-operators であることを確認します。

   $ oc -n external-dns-operator get subscription

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

   $ oc -n external-dns-operator get csv

手順

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

   $ oc whoami

2. kube-system 名前空間に存在する aws-creds シークレットから値を取得します。

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

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

3. ルートを取得して、ドメインを確認します。

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

   出力例

   openshift-console          console             console-openshift-console.apps.testextdnsoperator.apacshift.support                       console             https   reencrypt/Redirect     None
   openshift-console          downloads           downloads-openshift-console.apps.testextdnsoperator.apacshift.support                     downloads           http    edge/Redirect          None

4. DNS ゾーンのリストを取得し、以前にクエリーしたルートのドメインに対応する DNS ゾーンを見つけます。

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

   出力例

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

5. ルート ソースの 外部 DNS CR を作成します。

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

   ここでは、以下のようになります。

   metadata.name

   外部 DNS リソースの名前を指定します。

   仕様ドメイン

   デフォルトでは、すべてのホストゾーンがターゲット候補として選択されます。必要なホストゾーンを追加できます。

   ドメインのマッチタイプ

   対象ゾーンのドメインとの一致が完全に一致する必要があることを指定します。正規表現による一致ではなく、完全一致。

   ドメイン名

   更新するゾーンの正確なドメインを指定します。ルートのホスト名は、指定されたドメインのサブドメインである必要があります。

   プロバイダータイプ

   AWS Route53 DNS プロバイダーを指定します。

   source

   DNS レコードのソースに関するオプションを指定します。

   ソースタイプ

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

   openshiftRouteOptions.routerName

   ソースが OpenShiftRoute の場合に、OpenShift Ingress Controller 名を指定できます。External DNS Operator は、CNAME レコードを作成する際に、そのルーターの正規ホスト名をターゲットとして選択します。

6. 以下のコマンドを使用して、OpenShift Container Platform ルート用に作成されたレコードを確認してください。

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

手順

1. 次のコマンドを実行して、アカウント B からアカウント A の Route 53 ホストゾーンにアクセスできるように作成した IAM ロールのロール ARN を取得します。

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

   出力例

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

2. 次のコマンドを実行して、アカウント A の認証情報で使用するプライベートホストゾーンを特定します。

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

   出力例

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

3. 次のコマンドを実行して、ExternalDNS オブジェクトを作成します。

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

   ここでは、以下のようになります。

   arn

   アカウント A に DNS レコードを作成するロール ARN を指定します。

4. 以下のコマンドを入力して、OpenShift Container Platform ルート用に作成されたレコードを確認してください。

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

手順

1. クラウドプロバイダークライアントを使用するために、次のコマンドを実行して kube-system namespace から認証情報を取得します。

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

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

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

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

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

2. 次のコマンドを実行して、Azure にログインします。

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

3. 次のコマンドを実行して、ルートのリストを取得します。

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

   出力例

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

4. DNS ゾーンのリストを取得します。

   1. パブリック DNS ゾーンの場合は、次のコマンドを入力してください。

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

   2. プライベート DNS ゾーンの場合は、次のコマンドを入力してください。

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

5. ExternalDNS オブジェクトを定義する YAML ファイル (例: external-dns-sample-azure.yaml) を作成します。

   external-dns-sample-azure.yaml ファイルの例

   apiVersion: externaldns.olm.openshift.io/v1beta1
   kind: ExternalDNS
   metadata:
     name: sample-azure
   spec:
     zones:
     - "/subscriptions/1234567890/resourceGroups/test-azure-xxxxx-rg/providers/Microsoft.Network/dnszones/test.azure.example.com"
     provider:
       type: Azure
     source:
       openshiftRouteOptions:
         routerName: default
       type: OpenShiftRoute
   # ...

   ここでは、以下のようになります。

   metadata.name

   外部 DNS 名を指定します。

   仕様ゾーン

   ゾーン ID を指定します。プライベート DNS ゾーンの場合は、dnszones を privateDnsZones に変更します。

   プロバイダータイプ

   プロバイダーの種類を指定します。

   source.openshiftRouteOptions

   DNS レコードのソースに関するオプションを指定します。

   routerName

   ソースタイプが OpenShiftRoute の場合、OpenShift Ingress Controller 名を渡すことができます。External DNS Operator は、CNAME レコードを作成する際に、そのルーターの正規ホスト名をターゲットとして選択します。

   ソースタイプ

   Azure DNS レコードのソースとして、ルート リソースを指定します。

トラブルシューティング

1. ルートに対して作成されたレコードを確認します。

   1. パブリック DNS ゾーンの場合は、次のコマンドを入力してください。

      $ az network dns record-set list -g "${RESOURCE_GROUP}" -z "${ZONE_NAME}" | grep console

   2. プライベート DNS ゾーンの場合は、次のコマンドを入力してください。

      $ az network private-dns record-set list -g "${RESOURCE_GROUP}" -z "${ZONE_NAME}" | grep console

手順

1. 次のコマンドを実行して、encoded-gcloud.json ファイル内の gcp-credentials シークレットをコピーします。

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

2. 次のコマンドを実行して、Google の認証情報をエクスポートします。

   $ export GOOGLE_CREDENTIALS=decoded-gcloud.json

3. 次のコマンドを使用して、アカウントをアクティブ化します。

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

4. 次のコマンドを実行して、プロジェクトを設定します。

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

5. 次のコマンドを実行して、ルートのリストを取得します。

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

   出力例

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

6. 次のコマンドを実行して、qe-cvs4g-private-zone test.gcp.example.com などのマネージドゾーンのリストを取得します。

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

7. ExternalDNS オブジェクトを定義する YAML ファイル (例: external-dns-sample-gcp.yaml) を作成します。

   external-dns-sample-gcp.yaml ファイルの例

   apiVersion: externaldns.olm.openshift.io/v1beta1
   kind: ExternalDNS
   metadata:
     name: sample-gcp
   spec:
     domains:
       - filterType: Include
         matchType: Exact
         name: test.gcp.example.com
     provider:
       type: GCP
     source:
       openshiftRouteOptions:
         routerName: default
       type: OpenShiftRoute
   # ...

   ここでは、以下のようになります。

   metadata.name

   外部 DNS 名を指定します。

   spec.domains.filterType

   デフォルトでは、すべてのホストされたゾーンがターゲット候補として選択されます。ホストされたゾーンを含めることができます。

   spec.domains.matchType

   名前 キーで定義された文字列と一致する必要があるターゲットのドメインを指定します。

   仕様ドメイン名

   更新するゾーンの正確なドメインを指定します。ルートのホスト名は、指定されたドメインのサブドメインである必要があります。

   仕様プロバイダータイプ

   プロバイダーの種類を指定します。

   source.openshiftRouteOptions

   DNS レコードのソースに関するオプションを指定します。

   openshiftRouteOptions.routerName

   ソースタイプが OpenShiftRoute の場合、OpenShift Ingress Controller 名を渡すことができます。外部 DNS は、CNAME レコードを作成する際に、そのルーターの正規ホスト名をターゲットとして選択します。

   type

   ルート リソースを、Google Cloud DNS レコードのソースとして指定します。

8. 次のコマンドを実行して、OpenShift Container Platform ルートに対して作成された DNS レコードを確認します。

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

手順

1. 次のコマンドを実行して、Infoblox クレデンシャルを使用して secret オブジェクトを作成します。

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

2. 次のコマンドを実行して、ルートのリストを取得します。

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

   出力例

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

3. ExternalDNS オブジェクトを定義する YAML ファイル (例: external-dns-sample-infoblox.yaml) を作成します。

   external-dns-sample-infoblox.yaml ファイルの例

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

   ここでは、以下のようになります。

   metadata.name

   外部 DNS 名を指定します。

   プロバイダータイプ

   プロバイダーの種類を指定します。

   ソースタイプ

   DNS レコードのソースに関するオプションを指定します。

   routerName

   ソースタイプが OpenShiftRoute の場合、OpenShift Ingress Controller 名を渡すことができます。外部 DNS は、CNAME レコードを作成する際に、そのルーターの正規ホスト名をターゲットとして選択します。

4. 次のコマンドを実行して、Infoblox に ExternalDNS リソースを作成します。

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

5. Infoblox UI から、console ルート用に作成された DNS レコードを確認します。

   1. Data Management → DNS → Zones をクリックします。
   2. ゾーン名を選択します。

手順

1. 次のコマンドを実行して、external-dns-operator namespace に CA バンドルを含める config map を作成します。

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

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

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

3. 次のコマンドを実行して、External DNS Operator のサブスクリプションを更新します。

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

手順

1. OpenShift Container Platform Web コンソールで、Ecosystem → Software Catalog に移動します。

2. キーワードを Filter by keyword ボックスに入力するか、目的の Operator までスクロールします。たとえば、metallb と入力して MetalLB Operator を見つけます。

   また、インフラストラクチャー機能 でオプションをフィルターすることもできます。たとえば、非接続環境 (ネットワークが制限された環境ともしても知られる) で機能する Operator を表示するには、Disconnected を選択します。

3. Install Operator ページで、デフォルトを受け入れて Install をクリックします。

検証

1. インストールが正常に行われたことを確認するには、以下を実行します。

   1. Ecosystem → Installed Operators ページに移動します。
   2. Operator が openshift-operators の namespace 内に設置されていることと、その状態が Succeeded となっていることを確認してください。

2. Operator が正常にインストールされない場合は、Operator のステータスを確認し、ログを確認してください。

   1. Ecosystem → Installed Operators ページに移動し、Status 列でエラーまたは失敗の有無を確認します。
   2. Workloads → Pods ページにナビゲートし、問題を報告している openshift-operators プロジェクトの Pod のログを確認します。

手順

1. 次のコマンドを入力して、MetalLB Operator の namespace を作成します。

   $ cat << EOF | oc apply -f -
   apiVersion: v1
   kind: Namespace
   metadata:
     name: metallb-system
   EOF

2. namespace に Operator グループのカスタムリソースを作成します。

   $ cat << EOF | oc apply -f -
   apiVersion: operators.coreos.com/v1
   kind: OperatorGroup
   metadata:
     name: metallb-operator
     namespace: metallb-system
   EOF

3. Operator グループが namespace にインストールされていることを確認します。

   $ oc get operatorgroup -n metallb-system

   出力例

   NAME               AGE
   metallb-operator   14m

4. Subscription CR を作成します。

   1. Subscription CR を定義し、YAML ファイルを保存します (例: metallb-sub.yaml)。

      apiVersion: operators.coreos.com/v1alpha1
      kind: Subscription
      metadata:
        name: metallb-operator-sub
        namespace: metallb-system
      spec:
        channel: stable
        name: metallb-operator
        source: redhat-operators
        sourceNamespace: openshift-marketplace

      • spec.source パラメーターには、redhat-operators の 値を指定する必要があります。

   2. Subscription CR を作成するには、次のコマンドを実行します。

      $ oc create -f metallb-sub.yaml

5. オプション: BGP および BFD メトリックが Prometheus に表示されるようにするには、次のコマンドのように namespace にラベルを付けることができます。

   $ oc label ns metallb-system "openshift.io/cluster-monitoring=true"

1. インストール計画が namespace にあることを確認します。

   $ oc get installplan -n metallb-system

   出力例

   NAME            CSV                                   APPROVAL    APPROVED
   install-wzg94   metallb-operator.4.20.0-nnnnnnnnnnnn   Automatic   true

   注記

   Operator のインストールには数秒かかる場合があります。

2. Operator がインストールされていることを確認するには、次のコマンドを入力し、Operator に対して出力に Succeeded と表示されていることを確認します。

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

手順

1. MetalLB カスタムリソースの単一のインスタンスを作成します。

   $ cat << EOF | oc apply -f -
   apiVersion: metallb.io/v1beta1
   kind: MetalLB
   metadata:
     name: metallb
     namespace: metallb-system
   EOF

   • metdata.namespace パラメーターについては、Web コンソールを使用して MetalLB Operator をインストールした場合は、metallb-system を openshift-operators に置き換えてください。

1. コントローラーのデプロイメントが稼働していることを検証します。

   $ oc get deployment -n metallb-system controller

   出力例

   NAME         READY   UP-TO-DATE   AVAILABLE   AGE
   controller   1/1     1            1           11m

2. スピーカーに設定されているデーモンが実行されていることを検証します。

   $ oc get daemonset -n metallb-system speaker

   出力例

   NAME      DESIRED   CURRENT   READY   UP-TO-DATE   AVAILABLE   NODE SELECTOR            AGE
   speaker   6         6         6       6            6           kubernetes.io/os=linux   18m

   この出力例は、6 つの speaker Pod を示しています。クラスターの speaker Pod の数は出力例とは異なる場合があります。出力で各ノードの 1 つの Pod が表示されることを確認します。

手順

1. 次のコマンドを入力して、metallb-system namespace 内の metallb-operator サブスクリプションの YAML 定義を取得します。

   $ oc -n metallb-system get subscription metallb-operator -o yaml

2. installPlanApproval パラメーターを Manual に設定して、Subscription CR を編集します。

   apiVersion: operators.coreos.com/v1alpha1
   kind: Subscription
   metadata:
     name: metallb-operator
     namespace: metallb-system
   # ...
   spec:
      channel: stable
      installPlanApproval: Manual
      name: metallb-operator
      source: redhat-operators
      sourceNamespace: openshift-marketplace
   # ...

3. 次のコマンドを入力して、最新の OpenShift Container Platform 4.20 バージョンの MetalLB Operator を見つけます。

   $ oc -n metallb-system get csv

4. 次のコマンドを入力して、namespace に存在するインストールプランを確認します。

   $ oc -n metallb-system get installplan

   手動インストールプランとして install-tsz2g が表示された出力例

   NAME            CSV                                     APPROVAL    APPROVED
   install-shpmd   metallb-operator.v4.20.0-202502261233   Automatic   true
   install-tsz2g   metallb-operator.v4.20.0-202503102139   Manual      false

5. 次のコマンドを入力して、namespace に存在するインストールプランを編集します。<name_of_installplan> は、install-tsz2g などのインストールプランの名前に置き換えてください。

   $ oc edit installplan <name_of_installplan> -n metallb-system

   1. エディターでインストールプランを開いた状態で、spec.approval パラメーターを Manual に設定し、spec.approved パラメーターを true に設定します。

      注記

      インストールプランを編集すると、アップグレード操作が開始します。アップグレード操作中に oc -n metallb-system get csv コマンドを入力すると、出力に Replacing または Pending ステータスが表示される場合があります。