遷移流程

通過將一個域名同時解析到Nginx Ingress和ALB Ingress并逐漸調整權重，可以實現對客戶端無感的遷移。下圖展示了通過DNS解析完成無感遷移的大致流程，各個步驟在下方的遷移示例場景有更具體的示例展示。

遷移示例場景

通過以下示例，您可了解遷移流程中的具體操作細節和工作原理。

某企業在ACK集群中安裝了Nginx Ingress Controller，并為Controller的Service選擇了公網LoadBalancer類型，使Controller自動關聯了一個公網類型CLB實例。該企業同時配置了DNS解析，客戶端訪問www.example.net時，客戶端請求將被解析到CLB，并經由CLB轉發后到達后端Pod。

步驟一：配置ALB Ingress

隨著業務逐步上量，Nginx Ingress的性能已無法滿足業務需求，并且產生了較為高昂的運維成本。該企業決定從Nginx Ingress遷移至ALB Ingress。遷移過程中，該企業通過ACK提供的遷移工具將Nginx Ingress的配置轉換到了ALB Ingress中，并將ALB Ingress加入到了DNS解析中，給予了更低的權重。

步驟二：將流量逐漸轉移至ALB Ingress

經過一段時間的測試后，ALB Ingress工作正常，該企業隨即提高了ALB Ingress的DNS解析權重，使更多流量經由ALB Ingress轉發。

步驟三：刪除Nginx Ingress相關資源

在將流量完全轉移至ALB Ingress后，該企業刪除了DNS解析中的Nginx Ingress相關條目，移除了Nginx Ingress相關資源，并卸載了Nginx Ingress Controller組件。至此，該企業已經完成了從Nginx Ingress遷移至ALB Ingress的過程，且全流程對客戶端無感。

前提條件

已通過kubectl工具連接集群。具體操作，請參見獲取集群KubeConfig并通過kubectl工具連接集群。

步驟一：配置ALB Ingress

1. 登錄容器服務管理控制臺，在需要執行遷移的集群中，安裝ALB Ingress Controller組件。具體操作，請參見管理ALB Ingress Controller組件。遷移工具會自動轉換AlbConfig、IngressClass、Ingress資源，因此在安裝組件時請為ALB云原生網關實例來源選擇暫不創建。

   重要

   如需在ACK專有集群中通過ALB Ingress訪問服務，在部署服務前需要為ALB Ingress Controller授權。具體操作，請參見為ACK專有集群授予ALB Ingress Controller訪問權限。

2. 創建并復制下方YAML文件至ingress2albconfig.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任務。該任務將會依據現有的Nginx Ingress Controller配置，自動轉化到AlbConfig、IngressClass、Ingress等資源并輸出，后續可通過Log查看。

   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中的虛擬交換機ID
       - vSwitchId: vsw-xxx #替換為VPC中的虛擬交換機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: {}

步驟二：將流量逐漸轉移至ALB Ingress

步驟三：刪除Nginx Ingress相關資源

當Nginx Ingress長連接全部處理完成，且Nginx Ingress沒有新增流量時，您可以根據業務場景靜默觀察一段時間后釋放冗余資源。

1. 通過域名解析控制臺刪除Nginx Ingress相關DNS條目。

2. 卸載Nginx Ingress Controller組件。

   1. 登錄容器服務管理控制臺，在左側導航欄選擇集群。

   2. 在集群管理頁左側導航欄中，選擇網絡 > 路由。

   3. 在Nginx Ingress右側操作欄，選擇 > 刪除，在彈出的對話框，單擊確定。

   4. 在左側導航欄中選擇運維管理 > 組件管理頁面，單擊網絡頁簽，在Nginx Ingress Controller卡片，單擊卸載。

   5. 在彈出的對話框中，單擊確定。

      說明

      Nginx Ingress Controller所使用的CLB會隨著組件卸載自動釋放，不會繼續產生計費。

相關文檔

• ALB實例支持多種配置，更多信息，請參見通過AlbConfig配置ALB實例。

• 在ALB Ingress中使用HTTPS協議的操作，請參見配置HTTPS證書以實現加密通信。

• ALB Ingress支持的Annotation列表，請參見ALB Ingress配置詞典。