产品动态
公告
产品发布记录
从 TKE Nginx Ingress 插件迁移到自建 Nginx Ingress
迁移的好处
Nginx Ingress 提供的功能和配置都是非常多和灵活，可以满足各种使用场景，自建可以解锁 Nginx Ingress 的全部功能，并根据自己需求，对配置进行自定义，还能够及时更新版本。
迁移思路
使用本文中自建的方法创建一套新的 Nginx Ingress 实例，与旧的实例共享同一个 IngressClass，也就会共享相同的 Ingress 转发规则，两套流量入口共存，最后修改 DNS 指向新的入口地址，完成平滑迁移。
确认已安装的 Nginx Ingress 相关信息
1. 先确认已安装的 Nginx Ingress 实例的 IngressClass 名称，例如：
$ kubectl get deploy -A | grep nginxkube-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.5ingress-nginx/ingress-nginx 4.9.0 1.9.5 Ingress controller for Kubernetes using NGINX a...
本例中chart 版本为
后续在使用 helm 安装新版渲染时需要指定这个 chart 版本。4.9.0，请记住这个版本，准备 values.yaml
确保 helm 新创建的 Nginx Ingress 实例和 TKE 插件创建 Nginx Ingress 实例共用一个 IngressClass，即让 Ingress 规则在两边同时生效。
查看当前的 IngressClass 定义：
$ kubectl get ingressclass extranet -o yamlapiVersion: networking.k8s.io/v1kind: IngressClassmetadata:creationTimestamp: "2024-03-27T10:47:49Z"generation: 1labels:app.kubernetes.io/component: controllername: extranetresourceVersion: "27703380423"uid: 5e2de0d1-8eae-4b55-afde-25c8fe37d478spec:controller: k8s.io/extranet
获取到 controller 的值
k8s.io/extranet，与 IngressClass 名称一起，配置到 values.yaml 中：controller:ingressClassName: extranet # IngressClass 名称ingressClassResource:enabled: false # 不自动创建 IngressClass 资源，避免冲突controllerValue: k8s.io/extranet # 新 Nginx Ingress 复用已有的 IngressClass
安装新的 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 svcNAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGEnew-extranet-ingress-nginx-controller LoadBalancer 172.16.165.100 43.136.214.239 80:31507/TCP,443:31116/TCP 9m37s
EXTERNAL-IP 是新的流量入口，请验证确认能够正常转发。切换 DNS
至此，新旧 Nginx Ingress 共存，无论通过哪个流量入口都能正常转发。
接下来修改域名的 DNS 解析，指向新 Nginx Ingress 流量入口，在 DNS 解析完全生效前，两边流量入口均能正常转发，无论通过哪个流量入口都能正常转发，这个过程会非常平滑，生产环境的流量不受影响。
删除旧 NginxIngress 实例和插件
1. 等到所有旧的 Nginx Ingress 实例完全没有流量的时候，再前往 TKE 控制台删除 Nginx Ingress 实例：
2. 在组件管理中删除
ingressnginx ，彻底完成迁移。
文档反馈