容器与云原生 / 系统课时
建立可复用的容器化交付流程
建立可复用的容器化交付流程
本课把零散的 Docker 命令整理为可重复执行的交付流程。最终你将得到一份包含不可变镜像、外部配置、部署验证、失败回滚和安全清理的最小工程化方案。
学习目标
- 按构建、标记、推送、部署、验证和回滚组织交付步骤
- 使用唯一版本标签和外部环境变量避免覆盖式发布
- 通过脚本固化检查项,降低人工漏操作风险
定义交付边界
一份可复用流程至少要明确四类输入:源码与 Dockerfile、镜像仓库地址、版本标签、运行配置。镜像应保存程序和固定依赖,环境差异通过环境变量、密钥系统或挂载文件注入。
不要只使用 latest。推荐使用 Git 提交号、构建号或时间戳作为不可变标签,例如 registry.example.com/demo/app:20260729-abc1234。这样才能准确追踪当前版本并执行回滚。
使用 Compose 固化运行参数
下面的 compose.yaml 通过 IMAGE_REF 指定唯一镜像,通过 APP_PORT 决定宿主机端口,并从 .env.runtime 读取业务配置。
services:
app:
image: ${IMAGE_REF}
container_name: ${APP_NAME}
restart: unless-stopped
env_file:
- .env.runtime
ports:
- "${APP_PORT}:8080".env.runtime 片段示例如下,实际敏感值不应提交到代码仓库:
SPRING_PROFILES_ACTIVE=prod
DATABASE_URL=<DATABASE_URL>
DATABASE_USERNAME=<DATABASE_USERNAME>
DATABASE_PASSWORD=<DATABASE_PASSWORD>生效行为与验证方法
执行 docker compose config 后,应看到变量已展开且 YAML 结构有效;执行 docker inspect <APP_NAME> 可核对镜像、端口和环境变量。密钥应由部署平台注入,示例中的占位符必须替换为真实值。
用脚本串联发布与回滚
以下脚本要求当前目录包含 Dockerfile、compose.yaml 和 .env.runtime,本机已安装 Docker Compose,并已执行 docker login <REGISTRY>。应用必须提供 GET /health,成功时返回 HTTP 2xx。
#!/usr/bin/env bash
set -Eeuo pipefail
APP_NAME="${APP_NAME:-demo-app}"
APP_PORT="${APP_PORT:-8080}"
REGISTRY="${REGISTRY:?请设置 REGISTRY,例如 registry.example.com/team}"
IMAGE_NAME="${IMAGE_NAME:-demo-app}"
TAG="${1:-$(date +%Y%m%d%H%M%S)}"
IMAGE_REF="${REGISTRY}/${IMAGE_NAME}:${TAG}"
export APP_NAME APP_PORT IMAGE_REF
previous_image="$(docker inspect "$APP_NAME" --format '{{.Config.Image}}' 2>/dev/null || true)"
rollback() {
if [[ -n "$previous_image" ]]; then
echo "health check failed, rollback to ${previous_image}"
export IMAGE_REF="$previous_image"
docker compose up -d --remove-orphans
else
echo "health check failed, no previous image available"
fi
}
echo "build ${IMAGE_REF}"
docker build --pull -t "$IMAGE_REF" .
echo "push ${IMAGE_REF}"
docker push "$IMAGE_REF"
echo "deploy ${IMAGE_REF}"
docker compose up -d --remove-orphans
for attempt in $(seq 1 30); do
if curl -fsS "http://127.0.0.1:${APP_PORT}/health" >/dev/null; then
echo "deployment succeeded: ${IMAGE_REF}"
docker image prune -f
exit 0
fi
sleep 2
done
rollback
exit 1保存为 deploy.sh 后执行:
chmod +x deploy.sh
REGISTRY=registry.example.com/team \
APP_NAME=demo-app \
APP_PORT=8080 \
./deploy.sh 20260729-abc1234预期输出
build registry.example.com/team/demo-app:20260729-abc1234
<DOCKER_BUILD_OUTPUT>
push registry.example.com/team/demo-app:20260729-abc1234
<DOCKER_PUSH_OUTPUT>
deploy registry.example.com/team/demo-app:20260729-abc1234
<DOCKER_COMPOSE_OUTPUT>
deployment succeeded: registry.example.com/team/demo-app:20260729-abc1234<DOCKER_BUILD_OUTPUT>、<DOCKER_PUSH_OUTPUT> 和 <DOCKER_COMPOSE_OUTPUT> 表示 Docker 根据环境产生的动态日志。若 60 秒内健康检查仍失败,脚本会恢复发布前镜像并返回非零状态。
明确每个阶段的验收条件
构建阶段应确认依赖可解析、镜像成功生成且没有把密钥打入镜像。推送阶段应确认目标仓库和标签正确,不能把开发仓库误推到生产命名空间。
部署阶段应先保留旧镜像引用,再启动新版本。验证阶段不能只看容器为 running,还要检查健康接口、关键日志和至少一个核心业务请求。
回滚阶段应使用明确的旧镜像标签重新部署,而不是重新构建旧代码。清理阶段只删除悬空镜像和确认无用的历史版本,不能在回滚窗口内执行无差别 docker system prune -a。
建立发布清单
每次交付至少记录版本标签、镜像摘要、配置版本、执行人、发布时间和验证结果。生产环境还应保留变更单或自动化流水线记录,使“运行的是哪个版本、用了什么配置、如何回退”都能被追溯。建议把以下检查作为发布门槛:
- 镜像标签唯一,仓库推送成功
- 配置文件存在,必填变量已注入
- 新容器启动成功,健康接口返回 2xx
- 关键日志无持续异常,核心请求验证通过
- 上一版本镜像仍可用,回滚命令已确认
- 清理范围明确,不删除正在使用或待回滚镜像