Microservices Engine：從Nginx Ingress遷移到MSE Ingress

前提條件

• 已建立Container Service叢集，且部署了Nginx Ingress Controller。

• 已建立雲原生網關。如果您還沒有雲原生網關，請參見建立MSE雲原生網關。

注意事項

• 本文描述的遷移不是複製您的Ingress配置，而是讓您的Ingress配置被MSE Ingress複用，即時監聽已有的Ingress資源變化並解析。

• 遷移過程中，如果您的Ingress配置發生變化，會同時反映在Nginx Ingress Controller和MSE Ingress。

• 遷移完成之後，請不要隨意刪除線上正在使用的Ingress配置，遷移僅僅是讓現有的Ingress配置以及未來新添加的Ingress配置被MSE Ingress監聽並解析。

• 遷移完成之後，現有的Ingress配置以及未來新添加的Ingress配置仍然需要關聯之前使用的IngressClass。例如之前Ingress的spec中的ingressClassName為nginx，那麼在遷移之後，現有的Ingress配置以及未來新添加的Ingress配置的spec中的ingressClassName仍然需要是nginx。

遷移方式和原理介紹

遷移方案概述

雲原生網關提供了遷移上雲工具，您可以按照遷移工具的引導一步一步的完成路由配置的遷移及最終的流量切換。

步驟一：路由規則遷移

1. 登入MSE網關管理主控台，並在頂部功能表列選擇地區。

2. 在左側導覽列，選擇雲原生網關 > 迁移上云。

3. 在迁移上云頁面，單擊创建任务。

4. 在创建迁移配置面板，進行相關配置。

   雲原生網關將自動監聽所選容器叢集內且關聯到源IngressClass的所有Ingress資源的變化，並生效Ingress資源中網域名稱和路由的相關配置。

   重要

   如果目標雲原生網關叢集中已關聯該容器叢集，且已配置的IngressClass與此處的配置不同，則不允許遷移。請確保此處配置的IngressClass與已關聯容器叢集配置的IngressClass一致。

   配置項	說明
   云原生网关实例	選擇要遷移至的目標雲原生網關。要求雲原生網關的版本至少為1.2.22。
   Container ServiceACK/ACK Serverless叢集	選擇要遷移的Nginx Ingress對應的容器叢集，請確保雲原生網關與容器叢集處於同一VPC。
   源IngressClass	配置待遷移的Ingress資源關聯的IngressClass資源。 說明 僅支援配置單個IngressClass。 配置為空白，即忽略IngressClass，表示監聽叢集中所有的Ingress資源。
   描述	長度限制為64個字元

5. 單擊下一步。

   此時雲原生網關將自動監聽所選容器叢集內，關聯到源IngressClass的所有Ingress資源的變化，並生效Ingress資源中網域名稱、路由的相關配置。

   1. 假設在原有容器叢集內有一個名稱為httpbin的Ingress。

   2. 在雲原生網關控制台可以看到目的地組群中的Ingress已自動同步到目標雲原生網關中，並產生與之對應的網域名稱、路由的相關配置。路由配置詳情頁內容如下：

      1. 配置引導模組：

         1. 添加服務來源

            支援以 K8s、Nacos、Zookeeper、SAE、EDAS 和 FC 作為服務來源。您可以添加一個當前 VPC 中已有的資源,然後從中選擇註冊的服務。

            按鈕:添加服務來源

         2. 關聯後端服務

            會將請求分發給後端服務。後端服務可以從服務來源動態發現,也可以通過靜態地址或網域名稱指定。

            按鈕:關聯後端服務

         3. 綁定網域名稱

            提供了多網域名稱管理能力。通過綁定網域名稱,您可以關聯不同網域名稱下的協議、認證與路由配置。

            按鈕:綁定網域名稱

         4. 建立路由

            路由包含可以指定規則匹配的網域名稱、路徑、方法、請求參數和要求標頭。當使用者訪問路由時,請求將會被路由到路由對應的後端服務。

            按鈕：建立路由

      2. 列表欄位：路由名稱、狀態、WAF安全防護、來源、路由條件、關聯網域名稱、目標服務類型、目標服務、操作。

步驟二：路由校正

校正監聽的Ingress的相容性：

• 如果無不相容的Ingress Annotation，則繼續下一步。

• 如果存在不相容的Ingress Annotation，您可以提交工單諮詢解決方案。

  重要

  • 註解nginx.ingress.kubernetes.io/service-weight的值為""可以忽略，該註解為舊版Container Service控制台預設添加，本身沒有任何意義。

  • 遷移過程中，請勿刪除線上正在使用的不相容註解。因為這些不相容的註解仍然被Nginx Ingress Controller解析並作用於您的業務流量。您可以在Ingress資源上額外添加MSE擴充的註解，在MSE Ingress實現相同的功能。待流量全部遷移至MSE Ingress之後，您可以按需刪除不相容的註解。

步驟三：切流選擇

切流前測試

正式切流前，建議先進行本地測試：修改本地hosts檔案，為業務網域名稱添加雲原生網關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': {}