2.4. AWS Load Balancer Operator のインストール

手順

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

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