问题与边界
新模型版本需要小流量验证,异常时必须回到旧版本。案例只使用本地 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))
复现步骤
- 创建隔离 namespace,并对旧版本和新版本清单执行 dry-run。
- 部署新版本,等待 startup/readiness 探针成功。
- 用固定请求集比较错误、延迟和输出 schema,再切换 Service selector。
- 故意让新版本 readiness 失败,恢复旧 selector 并记录回滚原因。
验证清单
验证 selector 不指向未就绪 Pod、回滚后旧版本仍可读、事件记录保留、密钥不进入 manifest。
常见问题
金丝雀比例如何控制? 由网关或服务拆分实现,本案例使用显式 selector 说明切换边界。
回滚要不要删除新版本? 不立即删除,保留排障和审计所需的工件。
官方参考
Kubernetes Deployments;Kubernetes Services。
最后核对日期:2026-11-16。版本、接口和安全边界以链接的官方资料为准;本文不虚构性能或费用结论。
