CI/CD / 系统课时

自动更新应用镜像

自动更新应用镜像

本课把“修改镜像”变成完整的发布动作:流水线先更新 Deployment 的容器镜像,再阻塞等待 Kubernetes 滚动发布完成,最后核对实际镜像。这样能让发布失败直接反映为流水线失败,而不是命令提交后就误判成功。

学习目标

  • 使用 kubectl set image 精确更新 Deployment 中的目标容器。
  • 用 kubectl rollout status 等待滚动发布完成并设置超时。
  • 核对 Deployment 最终镜像,让流水线以可验证结果结束。

更新镜像时只修改目标容器

镜像标签或摘要应由前面的构建阶段产出,并作为流水线变量传入。不要在部署脚本里重新计算版本,更不要使用不可追踪的 latest 作为生产发布依据。

下面示例假设命名空间为 app-prod、Deployment 为 checkout-api、容器名为 app,镜像仓库为 registry.example.com/checkout-api。IMAGE_TAG 由前序阶段注入。

bash
set -euo pipefail

NAMESPACE="app-prod"
DEPLOYMENT="checkout-api"
CONTAINER="app"
: "${IMAGE_TAG:?IMAGE_TAG is required}"

IMAGE="registry.example.com/checkout-api:${IMAGE_TAG}"

kubectl -n "$NAMESPACE" set image \
  "deployment/$DEPLOYMENT" \
  "$CONTAINER=$IMAGE"

kubectl -n "$NAMESPACE" rollout status \
  "deployment/$DEPLOYMENT" \
  --timeout=5m

kubectl -n "$NAMESPACE" get "deployment/$DEPLOYMENT" \
  -o jsonpath='{.spec.template.spec.containers[?(@.name=="app")].image}{"\n"}'

预期输出

text
deployment.apps/checkout-api image updated
deployment "checkout-api" successfully rolled out
registry.example.com/checkout-api:<ID>

其中 <ID> 代表本次流水线传入的镜像标签,实际值可能是提交 SHA、构建号或版本号。只要 rollout status 超时或返回非零状态,set -e 就会让作业失败,不会继续把发布标记为成功。

理解滚动发布为什么必须等待

set image 只修改 Deployment 的 Pod 模板,API Server 接受更新并不代表新版本已经可服务。Deployment Controller 还需要创建新的 ReplicaSet、逐步拉起新 Pod、等待 Readiness 通过,并缩容旧 ReplicaSet。

流水线更新镜像并等待滚动发布的验证流程

因此,流水线的成功门禁应该放在控制器收敛之后,而不是 API 请求返回之后。kubectl rollout status 会持续观察 Deployment 状态,直到达到期望副本数或超时。

让失败在流水线里可见

最常见的问题是镜像不存在、镜像拉取凭据失效、Readiness Probe 持续失败,或者集群资源不足。出现这些情况时,rollout status 通常会等待到超时,流水线必须保留现场信息供排查。

可以在 CI 平台的“失败后执行”能力中采集 kubectl -n app-prod get pods、kubectl -n app-prod describe deployment checkout-api 和目标 Pod 的事件。它们属于诊断信息,不应替代主流程中的发布门禁。

验收发布结果

发布完成后至少确认三件事:rollout status 成功、Deployment 的目标容器镜像等于本次构建产物、流水线最终状态为成功。若组织使用不可变镜像,进一步可把镜像标签解析为 digest 后校验,避免同一标签被重新推送。

自动更新镜像的关键不是多写一条 kubectl 命令,而是把“提交变更、等待控制器收敛、核对实际镜像”连成一个原子化发布门禁。只有最终状态可验证,流水线成功才真正代表新版本已经完成滚动发布。

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

目录与阅读设置

阅读设置

17

记录一个想法

自动更新应用镜像

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

登录哪都通