Server Load Balancer:セルフマネージド Nginx Ingress から ALB Ingress への移行に関するベストプラクティス

ALB Ingress コントローラーのインストール

1. ACK コンソールACK コンソールにログオンし、対象のクラスターに ALB Ingress コントローラーをインストールします。 詳細については、「ALB Ingress コントローラーの管理」をご参照ください。 プロンプトが表示されたら、[ALB Instance] を [None] に設定します。 移行ツールは AlbConfig、IngressClass、および Ingress を自動的に変換します。ALB インスタンスを事前に作成しないでください。

   重要

   ACK 専用クラスターの場合、サービスをデプロイする前に ALB Ingress コントローラーにアクセス権限を付与します。詳細については、「ACK 専用クラスターに ALB Ingress コントローラーへのアクセスを許可する」をご参照ください。

移行ツールの実行

1. 次の内容で ingress2albconfig.yaml という名前のファイルを作成します。

   apiVersion: batch/v1
   kind: Job
   metadata:
     name: ingress2albconfig
     namespace: default
   spec:
     template:
       spec:
         containers:
         - name: ingress2albconfig
           image: registry.cn-hangzhou.aliyuncs.com/acs/ingress2albconfig:latest
           command: ["/bin/ingress2albconfig", "print"]
         restartPolicy: Never
         serviceAccount: ingress2albconfig
         serviceAccountName: ingress2albconfig
     backoffLimit: 4
   ---
   apiVersion: rbac.authorization.k8s.io/v1
   kind: ClusterRole
   metadata:
     name: system:ingress2albconfig
   rules:
   - apiGroups:
     - networking.k8s.io
     resources:
     - ingresses
     - ingressclasses
     verbs:
     - get
     - list
     - watch
     - update
     - create
     - patch
   ---
   apiVersion: v1
   kind: ServiceAccount
   metadata:
     name: ingress2albconfig
     namespace: default
   ---
   kind: ClusterRoleBinding
   apiVersion: rbac.authorization.k8s.io/v1
   metadata:
     name: system:ingress2albconfig
   roleRef:
     apiGroup: rbac.authorization.k8s.io
     kind: ClusterRole
     name: system:ingress2albconfig
   subjects:
     - kind: ServiceAccount
       name: ingress2albconfig
       namespace: default

2. マニフェストを適用してジョブを実行します。

   kubectl apply -f ingress2albconfig.yaml

   予想される出力:

   job.batch/ingress2albconfig created
   clusterrole.rbac.authorization.k8s.io/system:ingress2albconfig created
   serviceaccount/ingress2albconfig created
   clusterrolebinding.rbac.authorization.k8s.io/system:ingress2albconfig created

3. ジョブの Pod 名を取得します。

   kubectl get pod -l job-name=ingress2albconfig

   予想される出力:

   NAME                      READY   STATUS      RESTARTS   AGE
   ingress2albconfig-vw***   0/1     Completed   0          16m

4. Pod ログで変換された構成を表示します。

   重要

   このツールは NGINX アノテーションを ALB アノテーションに自動的に変換しますが、アノテーション変換リファレンスにリストされているサポートされているアノテーションのみが対象です。このリストにない NGINX アノテーションは黙って破棄されます。変換された Ingress を注意深く確認し、続行する前に不足している動作を手動で再構成してください。

   kubectl logs ingress2albconfig-vw***   # 前のステップの Pod 名に置き換えます。

   出力には、生成された AlbConfig、IngressClass、および Ingress リソースが含まれます：

   apiVersion: alibabacloud.com/v1
   kind: AlbConfig
   metadata:
     creationTimestamp: null
     name: from_nginx
   spec:
     config:
       accessLogConfig: {}
       edition: Standard
       name: from_nginx
       tags:
       - key: converted/ingress2albconfig
         value: "true"
       zoneMappings:
       - vSwitchId: vsw-xxx   # ご利用の VPC 内の vSwitch の ID に置き換えます。
       - vSwitchId: vsw-xxx   # ご利用の VPC 内の vSwitch の ID に置き換えます。
     listeners:
     - port: 80
       protocol: HTTP
   ---
   apiVersion: networking.k8s.io/v1
   kind: IngressClass
   metadata:
     creationTimestamp: null
     name: from_nginx
   spec:
     controller: ingress.k8s.alibabacloud/alb
     parameters:
       apiGroup: alibabacloud.com
       kind: AlbConfig
       name: from_nginx
       scope: null
   ---
   apiVersion: networking.k8s.io/v1
   kind: Ingress
   metadata:
     annotations:
       alb.ingress.kubernetes.io/listen-ports: '[{"HTTP":80}]'
     creationTimestamp: null
     name: from_ingress1
     namespace: default
   spec:
     ingressClassName: from_nginx
     rules:
     - http:
         paths:
         - backend:
             service:
               name: nginx-svc-g1msr
               port:
                 number: 80
           path: /
           pathType: Prefix
   status:
     loadBalancer: {}

5. 変換されたリソースをクラスターに適用して、ALB Ingress を作成します。

アノテーション変換リファレンス

次の NGINX Ingress アノテーションは、ALB Ingress の同等物に自動的に変換されます。ここにリストされていないアノテーションは変換されません。ALB で同等の動作が必要な場合は、手動で構成してください。

CLB インスタンスの一時ドメインの構成

1. Alibaba Cloud DNS コンソールにログインします。

2. [権威あるDNS解決] ページで、ドメイン名 www.example.net を見つけてクリックします。

3. [DNS 設定] ページで、[DNS レコードの追加] をクリックします。[DNS レコードの追加] パネルで、以下のパラメーターを設定し、[OK] をクリックします。

   パラメーター	値
   レコードタイプ	CNAME
   ホスト名	www
   DNS リクエストソース	Default
   レコード値	web0.example.net (一時ドメイン)
   TTL	Default

4. www.example.net を CLB IP アドレスに対応付ける既存の A レコードを見つけます。「操作」列で [変更] をクリックします。

5. [DNS レコードの変更] パネルで、[ホスト名] を web0 に変更し、[OK] をクリックします。この変更後、www.example.net は CNAME を使用して web0.example.net に解決され、web0.example.net は A レコードを使用して CLB IP に解決されます。

ALB インスタンスの CNAME レコードの追加

1. ALB インスタンスのドメイン名を取得します。

   kubectl get albconfig

   予想される出力:

   NAME         ALBID                    DNSNAME                                               PORT&PROTOCOL   CERTID   AGE
   from_nginx   alb-a8mmh2tqbmrm11****   alb-a8mmh2tqbmrm11****.cn-hangzhou.alb.aliyuncs.com                            20m

   DNSNAME 列の値 (alb-a8mmh2tqbmrm11****.cn-hangzhou.alb.aliyuncs.com) が ALB インスタンスのドメイン名です。

2. [DNS 設定] ページで、[DNS レコードの追加] をクリックします。[DNS レコードの追加] パネルで、次のパラメーターを設定し、[OK] をクリックします。

   パラメーター	値
   レコードの種類	CNAME
   ホスト名	www
   DNS リクエストのソース	Default
   値を記録	前のステップで取得した ALB インスタンスのドメイン名
   TTL	Default

重みの構成とトラフィックのシフト

1. [ドメイン名解決] ページで、左側のナビゲーションウィンドウで [重み設定] をクリックします。

2. 「加重ラウンドロビン」ページで、「操作」列の「重みを有効化」をクリックし、次に「重みを設定」をクリックします。

3. 初期重みを設定します。CLB は 100、ALB は 0 です。

   

4. CLB の重みを徐々に減らし、ALB の重みを増やします。調整後、ご利用のサービスに影響がないことを確認してください。

5. Service Pod を実行中のワーカーノードにログインし、dig コマンドを複数回実行して、トラフィックの分散を確認します：

6. ALB の動作に問題がないことを確認したら、CLB の重みを 0、ALB の重みを 100 に設定します。

ご利用の DNS プロバイダーが重み付けされた CNAME レコードをサポートしていない場合は、この代替トラフィック切り替えアプローチを使用してください。