Server Load Balancer:自己管理型 NGINX Ingress から ALB Ingress への移行に関するベストプラクティス

移行プロセス

ドメイン名を NGINX Ingress と ALB Ingress に解決し、Ingress の重みを段階的に調整します。これにより、ビジネスに対して透過的な移行が保証されます。以下の図は、Alibaba Cloud DNS を使用したトラフィック移行の手順を示しています。各ステップの詳細については、「移行例」をご参照ください。

移行例

この例では、移行プロセスを説明します。

ある企業が ACK クラスターに NGINX Ingress コントローラーをインストールし、コントローラー用にインターネット向けの LoadBalancer タイプの Service を設定しました。コントローラーは自動的にインターネット向けの Classic Load Balancer (CLB) インスタンスに関連付けられます。この企業は、ドメイン名 www.example.net を CLB インスタンスにマッピングするための DNS レコードを設定しました。このドメイン名宛のリクエストは CLB インスタンスに解決され、CLB インスタンスはリクエストをバックエンド Pod に転送します。

ステップ 1：ALB Ingress の設定

ビジネスの発展に伴い、NGINX Ingress のパフォーマンスがビジネス要件を満たせなくなりました。また、NGINX Ingress は高い運用保守コストも発生させます。この企業は、ネットワークトラフィックを NGINX Ingress から ALB Ingress に移行したいと考えています。移行プロセス中、企業は ACK が提供する移行ツールを使用して NGINX Ingress の設定を ALB Ingress の設定に変換し、ALB Ingress を DNS 解決設定に追加します。DNS 解決設定では、ALB Ingress は NGINX Ingress よりも低い優先度を持ちます。

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

企業がテストを実行し、ALB Ingress が期待どおりにトラフィックを転送できることを確認した後、ALB Ingress の DNS レコードの重みを増やして、より多くのトラフィックを ALB Ingress に向けます。

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

すべてのトラフィックが ALB Ingress に移行された後、企業は NGINX Ingress に関連する DNS 設定を削除し、NGINX Ingress に関連するリソースをリリースし、NGINX Ingress コントローラーをアンインストールします。企業がステップ 1 からステップ 3 を完了すると、すべてのネットワークトラフィックが NGINX Ingress から ALB Ingress に移行されます。この移行プロセスはユーザーに対して透過的です。

前提条件

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

ステップ 1：ALB Ingress の設定

1. ACK コンソールにログインし、移行したいクラスターに ALB Ingress コントローラーをインストールします。詳細については、「ALB Ingress コントローラーの管理」をご参照ください。移行ツールが AlbConfig、IngressClass、および Ingress を自動的に変換するため、[ALB インスタンス] を [なし] に設定します。

   重要

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

2. ingress2albconfig.yaml という名前の 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

3. 次のコードを実行して Job を実行します。Job は NGINX Ingress コントローラーの設定を自動的に AlbConfig、IngressClass、および Ingress の設定に変換し、その設定を出力します。設定はログで確認できます。

   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 名に置き換えてください。

   次のコードは想定される出力を示しています。kubectl を使用してリソースをクラスターにデプロイすると、ALB 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: {}

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

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

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 インスタンスは、NGINX Ingress コントローラーとともにリリースされます。リリースされたリソースに対しては、もはや課金されません。

関連ドキュメント

• ALB は複数の設定方法をサポートしています。詳細については、「AlbConfig を使用した ALB インスタンスの設定」をご参照ください。

• ALB Ingress で HTTPS を有効にする方法の詳細については、「HTTPS による暗号化通信のための証明書の設定」をご参照ください。

• ALB Ingress がサポートするアノテーションの詳細については、「ALB Ingress 設定ディクショナリ」をご参照ください。