容器与云原生 / 系统课时

建立可复用的容器化交付流程

建立可复用的容器化交付流程

本课把零散的 Docker 命令整理为可重复执行的交付流程。最终你将得到一份包含不可变镜像、外部配置、部署验证、失败回滚和安全清理的最小工程化方案。

学习目标

  • 按构建、标记、推送、部署、验证和回滚组织交付步骤
  • 使用唯一版本标签和外部环境变量避免覆盖式发布
  • 通过脚本固化检查项,降低人工漏操作风险

定义交付边界

一份可复用流程至少要明确四类输入:源码与 Dockerfile、镜像仓库地址、版本标签、运行配置。镜像应保存程序和固定依赖,环境差异通过环境变量、密钥系统或挂载文件注入。

不要只使用 latest。推荐使用 Git 提交号、构建号或时间戳作为不可变标签,例如 registry.example.com/demo/app:20260729-abc1234。这样才能准确追踪当前版本并执行回滚。

使用 Compose 固化运行参数

下面的 compose.yaml 通过 IMAGE_REF 指定唯一镜像,通过 APP_PORT 决定宿主机端口,并从 .env.runtime 读取业务配置。

yaml
services:
  app:
    image: ${IMAGE_REF}
    container_name: ${APP_NAME}
    restart: unless-stopped
    env_file:
      - .env.runtime
    ports:
      - "${APP_PORT}:8080"

.env.runtime 片段示例如下,实际敏感值不应提交到代码仓库:

text
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。

bash
#!/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 后执行:

bash
chmod +x deploy.sh
REGISTRY=registry.example.com/team \
APP_NAME=demo-app \
APP_PORT=8080 \
./deploy.sh 20260729-abc1234

预期输出

text
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
  • 关键日志无持续异常,核心请求验证通过
  • 上一版本镜像仍可用,回滚命令已确认
  • 清理范围明确,不删除正在使用或待回滚镜像
按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

建立可复用的容器化交付流程

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

登录哪都通