Microservices Engine:Nginx Ingress から MSE Ingress への移行

前提条件

• Container Service クラスターに Nginx Ingress Controller がデプロイされていること。

• 利用可能な Cloud Native Gateway があること。ない場合は、「MSE Cloud Native Gateway の作成」をご参照ください。

注意事項

• 移行プロセスでは Ingress 設定はコピーされません。代わりに、既存の Ingress リソースへの変更をリアルタイムで監視・解析することで、MSE Ingress が設定を再利用できるようにします。

• 移行中、Ingress 設定に加えた変更は Nginx Ingress Controller と MSE Ingress の両方に反映されます。

• 移行完了後も、使用中の Ingress 設定は削除しないでください。移行によって、MSE Ingress は既存および将来の Ingress 設定を監視・解析できるようになるだけです。

• 移行後も、既存および将来の Ingress 設定は、元の IngressClass に関連付けられたままである必要があります。たとえば、ある Ingress リソースが以前に spec で ingressClassName: nginx を指定していた場合、移行後もその指定を維持する必要があります。

移行方法

移行ワークフロー

Cloud Native Gateway は、ルーティング設定の移行とトラフィックのシフトを段階的にガイドするクラウド移行ツールを提供します。

ステップ 1：ルーティングルールの移行

1. MSE コンソール にログインします。上部のナビゲーションバーで、リージョンを選択します。

2. 左側メニューで、[Cloud Native Gateway] > クラウド移行 を選択します。

3. クラウド移行 ページで、タスクの作成 をクリックします。

4. 移行設定の作成 パネルで、パラメーターを設定します。

   Cloud Native Gateway は、選択されたコンテナークラスター内で、ソース IngressClass に関連付けられているすべての Ingress リソースを監視し、それらのドメイン名とルーティング設定を適用します。

   重要

   ターゲットの Cloud Native Gateway が、既に別の IngressClass を使用してこのコンテナークラスターに関連付けられている場合、移行は許可されません。ここで指定する IngressClass が、クラスターに既に設定されているものと一致することを確認してください。

   パラメーター	説明
   [クラウドネイティブゲートウェイ インスタンス]	移行先の Cloud Native Gateway を選択します。ゲートウェイのバージョンは 1.2.22 以降である必要があります。
   [Container Service ACK/]ACK Serverless cluster	移行する Nginx Ingress を含む Container Service クラスターを選択します。Cloud Native Gateway とコンテナークラスターが同じ VPC にあることを確認してください。
   [ソース IngressClass]	移行したい Ingress リソースに関連付けられた IngressClass を指定します。 説明 指定できる IngressClass は 1 つだけです。 このパラメーターを空のままにすると、IngressClass は無視され、ゲートウェイはクラスター内のすべての Ingress リソースを監視します。
   Description	最大 64 文字で説明を入力します。

5. 次へ をクリックします。

   Cloud Native Gateway は、選択されたコンテナークラスター内で、ソース IngressClass に関連付けられているすべての Ingress リソースへの変更を自動的に監視します。その後、これらのリソースからドメイン名とルーティング設定を適用します。

   1. ソースコンテナークラスターに httpbin という名前の Ingress があるとします。

   2. Cloud Native Gateway コンソールでは、ソースクラスターの Ingress がターゲットゲートウェイに自動的に同期され、対応するドメインとルーティング設定が作成されることがわかります。[Routing Settings] の詳細ページは次のように表示されます：

      1. 設定ウィザード：

         1. サービスソースの追加

            K8s、Nacos、Zookeeper、SAE、EDAS、Function Compute (FC) をサービスソースとして使用できます。現在の VPC から既存のリソースを追加し、そこから登録済みのサービスを選択できます。

            [サービスソースの追加] ボタン

         2. バックエンドサービスの関連付け

            リクエストをバックエンドサービスに分散します。このサービスは、サービスソースから動的に検出することも、静的なアドレスやドメイン名で指定することもできます。

            [バックエンドサービスの関連付け] ボタン

         3. ドメイン名のバインド

            複数のドメイン管理を提供します。ドメイン名をバインドすることで、プロトコル、証明書、ルーティング設定を異なるドメインに関連付けることができます。

            [ドメイン名のバインド] ボタン

         4. ルートの作成

            ルートには、ドメイン名、パス、メソッド、リクエストパラメーター、リクエストヘッダーに基づくマッチングルールが含まれます。ユーザーがルートにアクセスすると、リクエストは対応するバックエンドサービスに転送されます。

            [ルートの作成] ボタン

      2. リストカラム：ルート名、ステータス、WAF 保護、ソース、ルート条件、関連ドメイン名、宛先サービスタイプ、宛先サービス、およびアクション。

ステップ 2：ルートの検証

監視対象の Ingress アノテーションの互換性を確認します。

• 互換性のない Ingress アノテーションがない場合は、次のステップに進みます。

• 互換性のない Ingress アノテーションが見つかった場合は、チケットを起票 して解決策を依頼できます。

  重要

  • アノテーション nginx.ingress.kubernetes.io/service-weight の値が "" の場合は無視できます。このアノテーションは、以前のバージョンの Container Service コンソールによってデフォルトで追加されるもので、効果はありません。

  • 移行中は、使用中の互換性のないアノテーションを削除しないでください。これらのアノテーションは Nginx Ingress Controller によって引き続き解析され、ビジネストラフィックに影響を与えます。Ingress リソースに拡張 MSE アノテーションを追加することで、MSE Ingress で同じ機能を実現できます。すべてのトラフィックが MSE Ingress に移行された後、必要に応じて互換性のないアノテーションを削除できます。

ステップ 3：シフト方法の選択

トラフィックシフト前のテスト

本番トラフィックをシフトする前に、ローカルテストを実行します。ローカルの hosts ファイルを変更して、ビジネスドメイン名が Cloud Native Gateway SLB に解決されるようにします。cURL や Postman などのツールを使用して、すべてのトラフィックが期待どおりに動作することを確認します。

シフト方法の選択

apiVersion: v1
kind: Service
metadata:
  annotations:
    service.beta.kubernetes.io/alibaba-cloud-loadbalancer-id: lb-bp1lc0huzf0o1ks333yo1
    service.beta.kubernetes.io/alibaba-cloud-loadbalancer-weight: '100'
    service.beta.kubernetes.io/alibaba-cloud-loadbalancer-vgroup-port: 'rsp-bp1uybv6iy50i:80,rsp-bp10s0ndrfvdt:443'
  creationTimestamp: '2023-11-29T07:14:40Z'
  finalizers:
    - service.k8s.alibaba/resources
  labels:
    app: nginx-ingress-lb
    service.beta.kubernetes.io/hash: 39a51bd97b88f6eaf232da33434ce2fe44ae094b7b4d2b9bb9126eb7
    service.k8s.alibaba/loadbalancer-id: lb-bp1lc0huzf0o1ks333yo1
  managedFields:
    - apiVersion: v1
      fieldsType: FieldsV1
      fieldsV1:
        'f:metadata':
          'f:annotations':
            .: {}
            'f:kubectl.kubernetes.io/last-applied-configuration': {}
            'f:service.beta.kubernetes.io/alibaba-cloud-loadbalancer-connection-drain': {}
            'f:service.beta.kubernetes.io/alibaba-cloud-loadbalancer-connection-drain-timeout': {}
            'f:service.beta.kubernetes.io/alibaba-cloud-loadbalancer-instance-charge-type': {}
            'f:service.beta.kubernetes.io/alibaba-cloud-loadbalancer-resource-group-id': {}
          'f:labels':
            .: {}
            'f:app': {}