容器与云原生 / 系统课时

管理控制面修订与升级

管理控制面修订与升级

直接替换 Istio 控制面会把升级风险同时施加到整个网格。revision 让旧、新 Istiod 并行存在,再通过 revision tag 和工作负载重新注入逐步迁移代理,从而把控制面升级变成可观察、可暂停、可回退的过程。

学习目标

  • 理解 revision、revision tag 与工作负载注入之间的关系
  • 使用金丝雀方式并行安装新控制面并迁移少量工作负载
  • 验证代理归属后再推广、回退并安全下线旧修订

revision 把替换改成并行

每个 revision 是一套独立的 Istio 控制面实例。安装新 revision 后,既有 Sidecar 并不会自动连接到新 Istiod;代理在注入时根据命名空间或工作负载上的 istio.io/rev 选择控制面,因此迁移已有 Pod 需要重新注入。

revision tag 再增加一层稳定别名。例如业务命名空间长期标记 istio.io/rev=prod-stable,而 prod-stable 可以从旧 revision 改指向新 revision。这样推广和回退只需调整 tag,再滚动重启需要迁移的工作负载,不必批量修改所有命名空间标签。

Istio 控制面 revision 金丝雀升级

先并行安装新修订

升级前先使用目标版本的 istioctl 执行预检查,并复用经过审计的安装配置。示例把新 revision 命名为 1-30-3;revision 名称使用连字符而不是点,实际升级时替换为目标版本。<PATH> 替换为实际的 Istio 安装配置路径。

bash
set -euo pipefail

NEW_REV=1-30-3
istioctl x precheck >/dev/null
istioctl install -f "<PATH>/mesh.yaml" --set revision="${NEW_REV}" --skip-confirmation >/dev/null
kubectl get pods -n istio-system -l app=istiod

预期输出:

text
NAME                                READY   STATUS    RESTARTS   AGE
istiod-1-29-1-<ID>                  1/1     Running   0          <TIME>
istiod-1-30-3-<ID>                  1/1     Running   0          <TIME>

Pod 后缀和运行时长会因集群而不同。此时只能证明两个控制面并行运行,不能说明任何既有业务代理已经升级。

让少量工作负载切到新修订

生产环境更适合让业务绑定稳定 tag。下面把 prod-stable 指向旧 revision、prod-canary 指向新 revision,再只迁移 payments 命名空间。示例假定该命名空间已经使用 revision 机制管理注入。

bash
set -euo pipefail

OLD_REV=1-29-1
NEW_REV=1-30-3

istioctl tag set prod-stable --revision "${OLD_REV}" --overwrite >/dev/null
istioctl tag set prod-canary --revision "${NEW_REV}" --overwrite >/dev/null
kubectl label namespace payments istio.io/rev=prod-canary --overwrite >/dev/null
kubectl rollout restart deployment/payments -n payments >/dev/null
kubectl rollout status deployment/payments -n payments --timeout=5m

预期输出:

text
deployment "payments" successfully rolled out

示例假定业务 Deployment 名为 payments;实际环境按资源名替换。重启后必须检查新 Pod 的代理是否连接新 Istiod,并确认 CDS、LDS、EDS、RDS 等核心配置处于同步状态。

bash
istioctl proxy-status | grep -E '\.payments[[:space:]]'

预期输出:

text
<VALUE>.payments   Kubernetes   SYNCED   SYNCED   SYNCED   SYNCED   <VALUE>   istiod-1-30-3-<ID>   1.30.3

列内容会随 Istio 版本和代理类型略有差异,关键是业务代理归属于新 revision,且核心配置状态为 SYNCED。

推广与回退都通过稳定 tag

金丝雀命名空间稳定后,可以把 prod-stable 改指向新 revision。已经标记 istio.io/rev=prod-stable 的命名空间无需改标签,但其中既有 Pod 仍要滚动重启,新的注入结果才会绑定新控制面。

bash
set -euo pipefail

NEW_REV=1-30-3
istioctl tag set prod-stable --revision "${NEW_REV}" --overwrite >/dev/null
kubectl rollout restart deployment/reviews -n shop >/dev/null
echo "PROMOTION_STARTED=shop/reviews"

预期输出:

text
PROMOTION_STARTED=shop/reviews

若错误率、延迟、代理同步或关键路由出现回归,并且旧 revision 仍保留,则把 prod-stable 重新指向旧 revision,再滚动重启受影响工作负载即可完成控制面回退。不要在确认升级稳定前删除旧 revision,否则会失去这条快速恢复路径。

旧修订只能最后删除

推广完成后,先确认没有业务代理继续连接旧 Istiod,再检查网关等独立部署组件是否也完成目标版本迁移。下面的检查用旧 Istiod 名称作为条件;只有没有匹配项时才允许进入清理阶段。

bash
set -euo pipefail

OLD_REV=1-29-1
if istioctl proxy-status | grep -q "istiod-${OLD_REV}"; then
  echo "OLD_REVISION_STILL_IN_USE"
  exit 1
fi

echo "OLD_REVISION_UNUSED"

预期输出:

text
OLD_REVISION_UNUSED

确认网关等独立组件也已完成迁移后,还要检查所有 revision tag;如果 default 或其他 tag 仍指向旧 revision,先完成切换和验证。最后再按 revision 精确卸载旧控制面,避免误删新修订或留下失效指向。

bash
OLD_REV=1-29-1
istioctl uninstall --revision="${OLD_REV}" -y >/dev/null
echo "OLD_REVISION_REMOVED=${OLD_REV}"

预期输出:

text
OLD_REVISION_REMOVED=1-29-1

只有代理归属、网关版本、核心指标和回滚观察期都满足门禁后,才下线旧修订。revision 升级的关键不是“同时跑两套 Istiod”,而是始终保留清晰的工作负载归属、可验证的同步状态和一条在旧修订删除前仍然有效的回退路径。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

管理控制面修订与升级

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通