← Back to learning path

This chapter has not been reviewed in English; the original Simplified Chinese is shown.

Case · Published

实战:模型服务金丝雀发布与回滚 (original language)

在隔离 Kubernetes namespace 中演练探针、滚动更新和回滚指针。

Source: knowledge/p24-c/collection_62e019bd665ea4bb7c5eb169/cases/model-canary-and-rollback.mdModel deployment engineering
Chapter progress 0%Learning path progress 0% · 0/10 chapters completedContinue learning path →

问题与边界

新模型版本需要小流量验证,异常时必须回到旧版本。案例只使用本地 Kubernetes 或 manifest dry-run,不连接真实生产集群。

方案

两个 Deployment 使用不同 revision 标签,Service 通过 selector 指向当前版本。发布前检查 readiness 和固定请求,异常时恢复 selector 与 Deployment 镜像。

最小实现

import yaml

old = {'apiVersion': 'apps/v1', 'kind': 'Deployment', 'metadata': {'name': 'model-v1'}, 'spec': {'selector': {'matchLabels': {'app': 'model', 'revision': 'v1'}}, 'template': {'metadata': {'labels': {'app': 'model', 'revision': 'v1'}}}}}
service = {'apiVersion': 'v1', 'kind': 'Service', 'metadata': {'name': 'model'}, 'spec': {'selector': {'app': 'model', 'revision': 'v1'}}}
assert service['spec']['selector']['revision'] == old['spec']['template']['metadata']['labels']['revision']
print(yaml.safe_dump(service, sort_keys=False))

复现步骤

  1. 创建隔离 namespace,并对旧版本和新版本清单执行 dry-run。
  2. 部署新版本,等待 startup/readiness 探针成功。
  3. 用固定请求集比较错误、延迟和输出 schema,再切换 Service selector。
  4. 故意让新版本 readiness 失败,恢复旧 selector 并记录回滚原因。

验证清单

验证 selector 不指向未就绪 Pod、回滚后旧版本仍可读、事件记录保留、密钥不进入 manifest。

常见问题

金丝雀比例如何控制? 由网关或服务拆分实现,本案例使用显式 selector 说明切换边界。

回滚要不要删除新版本? 不立即删除,保留排障和审计所需的工件。

官方参考

Kubernetes Deployments;Kubernetes Services。

最后核对日期:2026-11-16。版本、接口和安全边界以链接的官方资料为准;本文不虚构性能或费用结论。

Prerequisite tutorials

KnowledgeKubernetes 发布:探针、资源与滚动更新 (original language)Knowledge模型服务观测与回滚:让故障可定位 (original language)
Product Hub Demo · V0.3