可重复交付
可重复交付是让同一份经过验证的产物依次进入测试、预发和生产环境。对于 Docker 应用,关键是确认部署的镜像就是测试过的镜像,并且能查清它来自哪次提交、使用哪版配置、怎样安全回退。
这需要把构建和部署分开:构建生成产物,后续流水线逐级放行同一产物,而环境配置在部署时注入。
1. 面试核心
先记住这几条,再读正文- 镜像 digest 按内容标识产物,tag 则可以被重新指向,部署记录要能定位到准确内容。卡 · 综合题
- 多阶段构建把编译环境与最终运行环境分开,运行镜像只保留必要产物和运行时。
- Jenkins 把构建、测试、镜像推送和部署组织为结果可检查的阶段;推送到镜像仓库不等于完成部署。卡 · Jenkins 流水线
- 部署脚本需要等待发布完成并核对目标镜像,命令失败时保留现场,不能把 API 请求成功当成业务验收通过。卡 · 部署脚本与状态检查
- 测试、预发和生产应使用同一个已验证的 digest,配置在部署时注入,避免上线前重新打包。
- 构建凭据通过 BuildKit secret mount 临时提供给指定步骤,构建命令仍要避免把它写进产物或日志。卡 · 构建缓存与凭据
- exec 形式的
ENTRYPOINT可以让应用直接接收终止信号;入口是脚本时,脚本需通过exec启动应用。卡 · 容器终止信号
2. 镜像与 digest
镜像由文件系统层和配置元数据组成。RUN、COPY 等指令可以产生文件系统变化,CMD、LABEL 等指令主要修改配置元数据。
tag 是便于阅读的镜像标签,digest 是按内容计算的摘要,用来精确引用产物。同一个 tag 可能先后指向不同内容,因此部署记录要同时保存源码提交和镜像 digest。基础镜像也可以按 digest 固定,在更新后重新测试。
构建上下文是发送给构建器的文件集合,.dockerignore 用来排除不需要的文件,例如密钥、Git 历史和本地缓存。密钥不能先复制进镜像、再靠后续指令删除,因为旧层中仍可能保留原内容。
3. 多阶段构建
多阶段构建把编译和运行放在不同阶段:构建阶段使用 JDK、Maven 等工具生成 jar,运行阶段只复制必要产物并提供运行时。这样,编译工具就不必进入最终运行镜像。
运行镜像还要明确应用能以什么身份、向哪些目录写入。使用非 root 用户并收紧文件权限,临时文件放进指定可写目录,同时保留应用需要的证书与诊断能力。
4. CI
持续集成(CI)负责对提交进行构建和验证,并生成可交付产物。流水线从固定的源码提交与工具链开始,可以按下面的顺序执行:
- 校验依赖,完成编译与单元测试。
- 执行静态检查、集成测试和契约测试。
- 构建镜像,生成软件物料清单(SBOM,记录产物包含的软件组件)与构建来源记录。
- 对实际镜像执行冒烟测试和漏洞检查。
- 对通过检查的镜像签名,并按 digest 发布。
签名只有被部署端验证才有作用。部署端需要检查签名身份和来源是否符合策略,而生产凭据只授予需要它的部署阶段。
4.1 Jenkins 流水线
Jenkins Pipeline 是用流水线代码组织构建、测试和部署任务的方式,stage 用来划分可以分别观察结果的阶段。以一个容器化应用为例,各阶段可以这样衔接:
| 阶段 | 执行动作 | 下一阶段需要的结果 |
|---|---|---|
| Checkout | 检出确定的源码提交,读取构建配置 | 提交 ID 与固定的构建输入 |
| Build and Test | 编译并运行测试,失败则停止 | 通过验证的应用产物 |
| Build Image | 使用 Dockerfile 构建镜像,给它标记提交 ID | 待验证的镜像 |
| Verify Image | 对实际镜像运行检查与冒烟测试 | 该镜像的验证结果 |
| Push | 登录目标镜像仓库并推送镜像 | 仓库中的镜像引用及 digest |
| Deploy | 将已验证的 digest 交给目标环境,等待并检查结果 | 部署状态及提交、digest、配置版本记录 |
例如,registry.example.com/team/api:<提交ID> 中,registry.example.com 是仓库地址,team/api 是镜像名称。执行 docker push 会把本地镜像上传到这个 registry。实际地址可以是组织自己的仓库或托管仓库,应以项目配置为准。镜像仓库存放镜像,运行环境负责拉取并启动镜像,推送成功只能说明产物已经可以被交付。
Jenkins 的仓库凭据只提供给需要登录和推送的阶段,部署凭据只提供给部署阶段,例如通过 Jenkins Credentials 配合 withCredentials 注入。不要把明文密码写进 Jenkinsfile,也不要把凭据输出到日志。这里讲的是应用交付流程;安装 Jenkins 服务本身是另一项任务。
5. CD 晋升
产物晋升是把已通过上一阶段验证的产物交给下一环境使用。持续交付(CD)负责后续交付流程:测试、预发和生产引用同一个 digest,配置、Secret 和资源声明在部署时注入。
如果生产前重新打包,即使源码没变,也已经是另一份二进制,之前的镜像测试不能直接代表它。使用同一产物并记录配置版本,才能追溯部署内容;环境配置和外部依赖不同,各环境的集成行为仍然要验证。
5.1 部署脚本与状态检查
部署脚本把一次有明确输入和完成条件的发布操作自动执行,并用退出码把结果交回流水线。下面的教学示例只更新 Kubernetes 中一个已有 Deployment 的镜像:命名空间为 staging,Deployment 和容器都叫 api。这些名称是示例约定。
运行前,Deployment 应已配置就绪探针、非零副本数,并处于未暂停状态;配置、Secret、Service 和拉取镜像的权限也已经准备好。调用方须确认集群 context、验证镜像来源,并对这个 Deployment 串行发布,期间没有其他操作者修改它。脚本不负责创建这些资源。
#!/bin/sh
set -eu
context=${1:?usage: deploy.sh CONTEXT IMAGE_AT_DIGEST}
image=${2:?usage: deploy.sh CONTEXT IMAGE_AT_DIGEST}
if ! printf '%s\n' "$image" | grep -Eq '^[^[:space:]@]+@sha256:[0-9a-f]{64}$'; then
echo 'expected image reference with sha256 digest' >&2
exit 2
fi
k() {
kubectl --context="$context" --namespace=staging --request-timeout=15s "$@"
}
k set image deployment/api "api=$image"
k rollout status deployment/api --timeout=120s
actual=$(k get deployment/api -o 'jsonpath={.spec.template.spec.containers[?(@.name=="api")].image}')
if [ "$actual" != "$image" ]; then
echo 'deployment image differs from requested image' >&2
exit 1
fi
printf 'rollout completed for %s\n' "$image"
调用时传入明确的 context 和 仓库/镜像@sha256:摘要。校验只限制引用的基本形式,不证明镜像存在或签名可信。set image 提交目标镜像,rollout status 等待 Deployment 发布完成,最后读取目标模板中的镜像并与输入比较。这里的串行发布前提很重要:rollout status 默认跟踪最新的 rollout,出现并发更新时可能切换到另一轮发布。
set -e 让本例的关键命令失败后停止,并把非零退出码交给 Jenkins;镜像不一致也会显式失败。API 超时不代表更新一定没有生效,等待超时也不代表系统已经回到旧版本。此时应保留日志,查看 Deployment、ReplicaSet、Pod 事件及当前镜像,确认已经更新到哪一步,再决定继续或回退。
脚本成功表示,在上述前提下控制器已报告发布完成且目标模板符合输入。它仍不能代替业务冒烟测试。脚本失败也不自动执行 rollout undo:数据库或配置可能已变化,回退前仍需检查兼容性。
6. 无损替换
替换实例时,要先让新实例就绪并接收流量,再让旧实例停止接收新请求、完成已有请求。这个过程称为排空,探针和端点传播的细节见服务发现。
交付验收还要验证应用能否收到并处理 SIGTERM 终止信号。在宽限期内,任务应完成,或者保存可以恢复的检查点;仅仅启动成功,不能说明替换过程完整。
7. 数据库变更
镜像回退不会自动撤销数据库变更,因此两者要分开管理。新旧应用能否同时使用变更后的数据库,取决于数据结构是否兼容,具体方法见架构迁移。
流水线需要记录迁移版本、执行锁和检查点。耗时较长的 DDL 使用独立任务执行,避免多个应用实例启动时同时修改数据库结构。
8. 发布策略
发布策略要写清楚观察哪些业务指标,以及什么条件下停止。逐步放量的判断方法见灰度发布。
回退记录同时包含镜像 digest、配置版本和数据兼容状态。出现失败时,保留对应日志和调用追踪(Trace),才能在停止发布后继续定位原因。
9. 流水线故障演练
故障演练用于验证流水线能否在失败处停住,并保留可查询的部署状态。可以分别模拟镜像仓库不可用、拉取失败、探针持续失败,也要验证数据库升级后是否还能回退镜像。
一次失败不能只留下「流水线失败」的结论。需要能查到哪些实例已经更新,以及它们对应的提交、镜像和配置,后续恢复才有依据。
10. 构建缓存与凭据
构建缓存复用已完成步骤,但可重复构建仍然依赖固定输入。如果远程下载地址的内容会变化,同一份 Dockerfile 也可能得到不同结果。
构建私有依赖时,可以用 BuildKit 的 --secret 提供凭据,再由 Dockerfile 中的 RUN --mount=type=secret 挂载给指定步骤。挂载只在该步骤执行期间可见,但步骤中的命令仍不能把凭据复制进产物或打印到日志。
ARG 和 ENV 不适合传递密钥,因为值可能暴露在镜像或构建元数据中。secret 的内容变化本身不会使缓存失效;轮换密钥后如果确实需要重跑,可以改变非敏感版本参数,或禁用该阶段缓存。
11. 容器终止信号
exec 形式的入口可以让 Java 直接成为容器主进程,接收终止信号:
ENTRYPOINT ["java", "-jar", "/app/app.jar"]
应用收到信号后,关闭逻辑应停止领取新任务,并等待在途工作结束。收到信号和完成排空是两个步骤,都需要验证。
shell 形式会增加 /bin/sh -c 中间进程,不能依赖它自动转发应用需要的信号。如果使用包装脚本,可以通过 exec java ... 让 Java 替换脚本进程。无论采用哪种入口,排空超过宽限期后,平台仍会强制终止容器。
12. 常见问题
12.1 部署记录只保存 latest 可以吗?
不可以。latest 可以指向不同内容,之后再拉取它,未必得到当时部署的镜像。回滚清单应保存明确的 digest,易读 tag 则可以作为检索辅助。
12.2 镜像越小就越安全吗?
镜像体积不能单独说明安全性。减少组件能降低需要维护的软件数量,但还要检查更新来源、漏洞和运行权限。裁剪镜像后,也要验证应用运行和诊断所需的能力是否仍然完整。
13. 面试题卡片
14. 参考资料
- Docker:Multi-stage builds
- Docker:Build best practices
- Kubernetes:Deployments
- SLSA Specification
- Docker:Build secrets
- Docker:Build cache invalidation
- Docker:Dockerfile reference
- Jenkins:Pipeline
- Jenkins:Using a Jenkinsfile
- Docker:docker image push
- Kubernetes:kubectl set image
- Kubernetes:kubectl rollout status
来源:Coding 101 原文 · 免费阅读,引用请保留出处。内容使用说明