跳到主要内容

从 TKE Nginx Ingress 插件迁移到自建 Nginx Ingress

迁移的好处​

迁移到自建 Nginx Ingress 有什么好处？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。

  1. 然后确认下当前使用的 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，看下对应哪个 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...

这里看到是 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 实例和插件​

最后等到所有旧的 Nginx Ingress 实例完全没有流量的时候，前往 TKE 控制台删除 Nginx Ingress 实例：

再去【组件管理】里删除 ingressnginx 彻底完成迁移: