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

移行プロセス

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

移行の例

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

会社がACKクラスターにNGINX Ingressコントローラーをインストールし、コントローラーにインターネット向けのLoadBalancerサービスを設定しました。 コントローラーは、インターネットに接続するClassic Load Balancer (CLB) インスタンスに自動的に関連付けられます。 同社は、ドメイン名www.example.netをCLBインスタンスにマップするようにDNSレコードを設定しました。 ドメイン名宛てのリクエストはCLBインスタンスに解決され、CLBインスタンスはリクエストをバックエンドポッドに転送します。

手順1: ALB Ingressの設定

ビジネスが発展するにつれて、NGINX Ingressのパフォーマンスはビジネス要件を満たすことができません。 NGINX Ingressは、高いO&Mコストも生み出します。 同社は、ネットワークトラフィックをNGINX IngressからALB Ingressに移行したいと考えています。 移行プロセス中、会社はACKが提供する移行ツールを使用してNGINX Ingress設定をALB Ingress設定に変換し、ALB IngressをDNS解決設定に追加します。 DNS解決構成では、ALB IngressはNGINX Ingressよりも低い優先度を有する。

ステップ2: トラフィックをALB Ingressに徐々に移行

会社がテストを実行し、ALB Ingressが予想通りにトラフィックを転送できることを検証した後、会社は、ALB Ingressへのより多くのトラフィックを許可するために、ALB IngressのDNSレコードの重みを増やします。

手順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を変換するため、Gateway SourceをNoneに設定します。

   重要

   ALB IngressからACK専用クラスターへのアクセスを許可するには、サービスをデプロイする前に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. 次のコードを実行してジョブを実行します。 ジョブは、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. ジョブが属するポッドを表示します。

   kubectl get pod -l job-name=ingress2albconfig

   期待される出力:

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

5. ポッドのログを表示します。

   kubectl logs ingress2albconfig-vw*** # Replace it with the Pod name obtained in the last step.

   次のコードは、期待される出力を示しています。 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 # Replace it with the ID of the vSwitch in the VPC.
       - vSwitchId: vsw-xxx # Replace it with the ID of the vSwitch in the VPC.
     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を見つけ、[操作] 列で /> [削除] を選択します。 表示されたメッセージボックスで [OK] をクリックします。

   4. 左側のナビゲーションウィンドウで、[操作] > [アドオン] を選択します。 [ネットワーキング] タブをクリックし、Nginx Ingress Controllerカードを見つけて、[アンインストール] をクリックします。

   5. 表示されたメッセージボックスで、[OK] をクリックします。

      説明

      NGINX Ingressコントローラーに関連付けられているCLBインスタンスは、NGINX Ingressコントローラーとともにリリースされます。 リリースされたリソースに対して課金されなくなりました。

関連ドキュメント

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

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

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