容器服务从 TKE Nginx Ingress 插件迁移到自建 Nginx Ingress-实践教程-文档中心-腾讯云

注意：
ingress-nginx 是一个由社区维护的开源项目。本文内容仅供参考，不提供官方支持。如在使用过程中遇到问题，建议查阅 ingress-nginx 社区 的最新官方文档以获取帮助。
迁移的好处
Nginx Ingress 提供的功能和配置都是非常多和灵活，可以满足各种使用场景，自建可以解锁 Nginx Ingress 的全部功能，并根据自己需求，对配置进行自定义，还能够及时更新版本。
迁移思路
使用本文中自建的方法创建一套新的 Nginx Ingress 实例以及 Ingress 规则，两套流量入口共存，最后修改 DNS 指向新的入口地址，完成平滑迁移。
﻿
﻿
﻿
确认已安装的 Nginx Ingress 相关信息
1. 先确认已安装的 Nginx Ingress 实例的 IngressClass 名称，例如：
$ kubectl get deploy -A | grep nginx
kube-system            extranet-ingress-nginx-controller           1/1     1            1           216d
在本例中，只有一个实例，Deployment 名称是 extranet-ingress-nginx-controller，IngressClass 是 -ingress-nginx-controller 之前的部分，即 extranet。
2. 确认当前使用的 nginx ingress 的镜像版本：
$ kubectl -n kube-system get deploy extranet-ingress-nginx-controller -o yaml | grep image:
        image: ccr.ccs.tencentyun.com/tkeimages/nginx-ingress-controller:v1.9.5
本例中的镜像版本是 v1.9.5。
3. 确认当前使用的 chart 版本：
$ helm search repo ingress-nginx/ingress-nginx --versions  | grep 1.9.5
ingress-nginx/ingress-nginx     4.9.0           1.9.5           Ingress controller for Kubernetes using NGINX a...
﻿本例中 chart 版本为 4.9.0，请记住这个版本，
后续在使用 helm 安装新版渲染时需要指定这个 chart 版本。
准备 values.yaml
下面配置 values.yaml，确保 helm 新创建的 Nginx Ingress 实例和 TKE 插件创建 Nginx Ingress 实例不要共用同一个 IngressClass：
controller:
  ingressClass: extranet-new # 新 IngressClass 名称，避免冲突
  ingressClassResource:
    name: extranet-new
    enabled: true
    controllerValue: k8s.io/extranet-new
安装新的 Nginx Ingress Controller
helm upgrade --install new-extranet-ingress-nginx ingress-nginx/ingress-nginx \\
  --namespace ingress-nginx --create-namespace \\
  --version 4.9.0 \\
  -f values.yaml
避免在 release 名称加上 -controller  后缀导致其与已有的 Nginx Ingress Deployment 名称相同，如果有同名的 ClusterRole 存在会导致 helm 安装失败。
version 指定在前面步骤得到的 chart 版本（即当前 nginx ingress 实例版本对应的 chart 版本）。
获取到新的 Nginx Ingress 的流量入口：
$ kubectl -n ingress-nginx get svc
NAME                                              TYPE           CLUSTER-IP       EXTERNAL-IP      PORT(S)                      AGE
new-extranet-ingress-nginx-controller             LoadBalancer   172.16.165.100   43.136.214.239   80:31507/TCP,443:31116/TCP   9m37s
EXTERNAL-IP 是新的流量入口，后续用该入口验证是否正常转发。
复制 Ingress 资源
将使用旧 IngressClass 的 Ingress 资源的 YAML 文件保存下来，并修改其名称（例如添加后缀 -new）。然后，将修改后的 YAML 文件应用到集群中。这样，新旧 Nginx Ingress 实例的转发规则将保持一致，确保流量进入任意入口时效果相同。
切换 DNS
至此，新旧 Nginx Ingress 共存，无论通过哪个流量入口都能正常转发。
接下来修改域名的 DNS 解析，指向新 Nginx Ingress 流量入口，在 DNS 解析完全生效前，两边流量入口均能正常转发，无论通过哪个流量入口都能正常转发，这个过程会非常平滑，生产环境的流量不受影响。
删除旧 NginxIngress 实例和插件
1. 等到所有旧的 Nginx Ingress 实例完全没有流量的时候，前往 TKE 控制台删除 Nginx Ingress 实例：
﻿
﻿
﻿
2. 在组件管理中删除 ingressnginx ，彻底完成迁移。
﻿
﻿
﻿
﻿
从 TKE Nginx Ingress 插件迁移到自建 Nginx Ingress

本页目录：

迁移的好处

迁移思路

确认已安装的 Nginx Ingress 相关信息

准备 values.yaml

安装新的 Nginx Ingress Controller

复制 Ingress 资源

切换 DNS

删除旧 NginxIngress 实例和插件
