金丝雀升级
通过先运行一个金丝雀部署的新控制平面来完成 Istio 的升级,从而允许您在将所有流量迁移到新版本之前以一小部分工作负载监视升级的效果,这比 就地升级 要安全的多,这也是推荐的升级方法。
安装 Istio 时,revision
安装设置可用于同时部署多个独立的控制平面。升级的金丝雀版本可以通过使用不同的 revision
,在旧版本的旁边安装启动新版本的 Istio 控制平面。每个修订都是一个完整的 Istio 控制平面实现,具有自己的 Deployment
、Service
等。
控制平面
要安装名为 canary
的新修订版本,您可以按照如下所示设置 revision
字段:
$ istioctl install --set revision=canary
运行该命令后,您将有两个并行运行的控制平面 Deployment 和 Service:
$ kubectl get pods -n istio-system -l app=istiod
NAME READY STATUS RESTARTS AGE
istiod-786779888b-p9s5n 1/1 Running 0 114m
istiod-canary-6956db645c-vwhsk 1/1 Running 0 1m
$ kubectl get svc -n istio-system -l app=istiod
NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE
istiod ClusterIP 10.32.5.247 <none> 15010/TCP,15012/TCP,443/TCP,15014/TCP 33d
istiod-canary ClusterIP 10.32.6.58 <none> 15010/TCP,15012/TCP,443/TCP,15014/TCP,53/UDP,853/TCP 12m
您还将看到包括新版本在内的两个 Sidecar 注入配置。
$ kubectl get mutatingwebhookconfigurations
NAME WEBHOOKS AGE
istio-sidecar-injector 1 7m56s
istio-sidecar-injector-canary 1 3m18s
数据平面
与 Istiod 不同,Istio Gateway 不运行特定修订版本的实例,而是就地升级以使用新的控制平面修订版本。
您可以通过运行以下命令来验证 istio-ingress
Gateway 是否正在使用 canary
修订版本:
$ istioctl proxy-status | grep $(kubectl -n istio-system get pod -l app=istio-ingressgateway -o jsonpath='{.items..metadata.name}') | awk '{print $8}'
istiod-canary-6956db645c-vwhsk
但是,仅安装新版本不会对现有的 Sidecar 代理产生影响。要升级它们,必须将它们配置为指向新的 istiod-canary
控制平面。这是在基于命名空间标签的 Sidecar 注入期间控制的 istio.io/rev
。
要升级名称空间 test-ns
,请删除 istio-injection
标签,然后添加 istio.io/rev
标签以指向 canary
修订版本。istio-injection
标签必须移除,因为它的优先级高于 istio.io/rev
,此标签用于向后兼容性。
$ kubectl label namespace test-ns istio-injection- istio.io/rev=canary
命名空间更新后,您需要重新启动 Pod 才能触发重新注入。一种方法是使用:
$ kubectl rollout restart deployment -n test-ns
当 Pod 被重新注入时,它们将被配置为指向 istiod-canary
控制平面。你可以查看 Pod 标签验证这一点。
例如,运行以下命令将显示使用 canary
修订版本的所有 Pod:
$ kubectl get pods -n test-ns -l istio.io/rev=canary
要验证 test-ns
命名空间中的新 Pod 正在使用与修订版本 istiod-canary
相对应的服务 canary
, 请选择一个新创建的 Pod,然后在 pod_name
中使用以下命令:
$ istioctl proxy-status | grep ${pod_name} | awk '{print $8}'
istiod-canary-6956db645c-vwhsk
输出确认 Pod 正在使用 istiod-canary
控制平面的修订版本。
卸载旧的控制平面
升级控制平面和数据平面之后,您可以卸载旧的控制平面。例如,以下命令卸载修订版本的控制平面 1-6-5
:
$ istioctl x uninstall --revision 1-6-5
如果旧的控制平面没有修订版本标签,请使用其原始安装选项将其卸载,例如:
$ istioctl x uninstall -f manifests/profiles/default.yaml
确认旧的控制平面已被移除,并且集群中仅存在新的控制平面:
$ kubectl get pods -n istio-system -l app=istiod
NAME READY STATUS RESTARTS AGE
istiod-canary-55887f699c-t8bh8 1/1 Running 0 27m
请注意,以上说明仅删除了用于指定控制平面修订版的资源,而未删除与其他控制平面共享的群集作用域资源。要完全卸载 Istio,请参阅 卸载指南。
卸载金丝雀控制平面
如果您决定回滚到旧的控制平面,而不是完成 Canary 升级,则可以使用 istioctl x uninstall --revision=canary
卸载 Canary 修订版。
但是,在这种情况下,您必须首先手动重新安装先前版本的网关,因为卸载命令不会自动还原先前就地升级的网关。