从自建Nginx Ingress迁移至ALB Ingress

迁移流程

通过将一个域名同时解析到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配置词典。