Server Load Balancer:NGINX Ingress から ALB Ingress への移行

移行プロセス

ドメイン名を NGINX Ingress と ALB Ingress の両方に解決させ、DNS の重みを段階的に調整することで、トラフィックをシームレスに移行します。以下の図にそのプロセスを示します。移行例で詳細な手順を後述します。

DNS ベースのトラフィック移行は、ゼロダウンタイム移行の一つのアプローチです。このプロセスは参考用です。

移行例

以下の例では、具体的な操作を交えて移行手順を説明します。

ある企業が、クラスター内で NGINX Ingress コントローラーを実行しているとします。このコントローラーのインターネット向け LoadBalancer タイプの Service は、インターネット向けの Classic Load Balancer (CLB) インスタンスを自動的にプロビジョニングします。DNS は www.example.net をこの CLB に解決し、CLB がリクエストをバックエンドの Pod に転送します。

ステップ 1：ALB Ingress の設定

NGINX Ingress がパフォーマンス要件を満たせなくなり、運用保守コストも高騰しています。そこで、この企業は移行ツールを使用して NGINX Ingress の設定を ALB Ingress に変換し、より低い重みで ALB Ingress を DNS に追加します。

ステップ 2：ALB Ingress へのトラフィックの段階的な移行

ALB Ingress が期待どおりに動作することを確認した後、ALB Ingress の DNS の重みを増やし、より多くのトラフィックが経由するようにします。

ステップ 3：NGINX Ingress リソースの削除

すべてのトラフィックが ALB Ingress に移行された後、NGINX Ingress の DNS エントリを削除し、NGINX Ingress リソースを削除し、NGINX Ingress コントローラーアドオンをアンインストールします。

前提条件

kubectl クライアントが ACK クラスターに接続されていること。詳細については、「kubectl を使用して ACK クラスターに接続する」をご参照ください。

ステップ 1：ALB Ingress の設定

1. Container Service for Kubernetes (ACK) コンソールにログインし、移行を実行するクラスターに ALB Ingress コントローラーアドオンをインストールします。Container Compute Service コンソールにログインし、移行を実行するクラスターに ALB Ingress コントローラーアドオンをインストールします。 移行ツールは AlbConfig、IngressClass、Ingress リソースを自動的に変換するため、アドオンをインストールする際は、[ALB インスタンス] で [なし] を選択してください。

   重要

   ACK 専用クラスターで ALB Ingress を介してサービスにアクセスするには、サービスをデプロイする前に ALB Ingress コントローラーに権限を付与する必要があります。ACK 専用クラスターで ALB Ingress コントローラーに権限を付与する。

2. 以下の内容で `ingress2albconfig.yaml` という名前のファイルを作成します。

   apiVersion: batch/v1
   kind: Job
   metadata:
     name: ingress2albconfig
     namespace: default
   spec:
     template:
       spec:
         containers:
         - name: ingress2albconfig
           image: registry-cn-hangzhou.ack.aliyuncs.com/acs/ingress2albconfig:0.0.2
           command: ["/bin/ingress2albconfig", "print", "-A"]
         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

3. 次のコマンドを実行して Job を開始します。この Job は、既存の NGINX Ingress 設定を AlbConfig、IngressClass、Ingress などのリソースに変換し、結果を Pod のログに出力します。

   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

4. Job に属する Pod を表示します。

   kubectl get pod -l job-name=ingress2albconfig

   想定される出力：

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

5. Pod のログを表示します。

   kubectl logs ingress2albconfig-vw*** # 前のステップで取得した Pod 名に置き換えてください。

   想定される出力。これらのリソースをクラスターにデプロイして、ALB Ingress を設定します。

   apiVersion: alibabacloud.com/v1
   kind: AlbConfig
   metadata:
     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:
     name: from-nginx
   spec:
     controller: ingress.k8s.alibabacloud/alb
     parameters:
       apiGroup: alibabacloud.com
       kind: AlbConfig
       name: from-nginx
   ---
   apiVersion: networking.k8s.io/v1
   kind: Ingress
   metadata:
     annotations:
       alb.ingress.kubernetes.io/listen-ports: '[{"HTTP":80}]'
     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: {}

ステップ 2：ALB Ingress へのトラフィックの段階的な移行

ステップ 3：NGINX Ingress リソースの削除

NGINX Ingress へのすべての永続的な接続が閉じられ、新しいトラフィックが到達しなくなった後、ビジネスに適した期間システムを監視してから、冗長なリソースを解放します。

1. Alibaba Cloud DNS コンソールから NGINX Ingress 関連の DNS エントリを削除します。

2. NGINX Ingress コントローラーアドオンをアンインストールします。

   1. ACK コンソールにログインします。

   2. クラスターリスト ページで、対象クラスターの名前をクリックします。左側のナビゲーションウィンドウで、ネットワーク > Ingress を選択します。

   3. NGINX Ingress を見つけます。アクション 列で、 > 削除 を選択します。表示されるダイアログボックスで、削除する をクリックします。

   4. 左側のナビゲーションウィンドウで アドオン管理 を選択します。ネットワーク タブをクリックします。NGINX Ingress controller カードで、アンインストール をクリックします。

   5. 表示されるダイアログボックスで、OK をクリックします。

      アドオンをアンインストールすると、NGINX Ingress コントローラーが使用していた CLB インスタンスが自動的に解放され、料金は発生しなくなります。

3. Container Compute Service コンソールにログインします。左側のナビゲーションウィンドウで、[アプリケーション] > [Helm] をクリックし、NGINX Ingress コントローラーアドオンをアンインストールします。

関連ドキュメント

• AlbConfig を使用した ALB インスタンスの設定

• 暗号化通信のための HTTPS 証明書の設定

• ALB Ingress のアノテーション