第 5 章:自动发布与回滚
手工发布三次之后你就会烦,五次之后就会出错。自动化不是为了快,是为了每次都一样——包括失败的时候。
学习目标
- 判断"在哪构建镜像":服务器上还是 CI 上
- 写出一条 push 即部署的流水线
- 让镜像可回滚:tag、digest 与保留策略
- 知道出事时第一分钟该按哪个按钮
5.1 两种拓扑,先选一个
5.2 一条最小流水线
yaml
name: build-and-deploy
on:
push:
branches: [main]
jobs:
build:
runs-on: ubuntu-latest
permissions:
contents: read
packages: write
outputs:
tag: ${{ steps.meta.outputs.tag }}
steps:
- uses: actions/checkout@v4
- name: 计算版本号
id: meta
run: echo "tag=${{ github.sha }}" >> "$GITHUB_OUTPUT"
- uses: docker/login-action@v3
with:
registry: ghcr.io
username: ${{ github.actor }}
password: ${{ secrets.GITHUB_TOKEN }}
- uses: docker/build-push-action@v6
with:
context: .
push: true
tags: ghcr.io/${{ github.repository }}:${{ steps.meta.outputs.tag }}
deploy:
needs: build
runs-on: ubuntu-latest
steps:
- name: 通过 SSH 部署
uses: appleboy/ssh-action@v1
with:
host: ${{ secrets.HOST }}
username: ${{ secrets.USER }}
key: ${{ secrets.SSH_KEY }}
script: |
cd /srv/app
sed -i "s|image: .*|image: ghcr.io/${{ github.repository }}:${{ needs.build.outputs.tag }}|" docker-compose.yml
docker compose pull
docker compose up -d
sleep 5
curl -fsS http://127.0.0.1:8000/readyz三段式:构建 → 推镜像 → 拉取重启 → 就绪检查。最后那行 curl 是关键——流水线要因为健康检查失败而判红,否则"发布成功"只是"命令执行完了"。
安全提醒:部署用的 SSH 密钥只给这台服务器、只给这个目录。能在服务器上给这把钥匙加限制(限制来源 IP、限制可执行命令),值得做。
5.3 单机怎么做到"不明显停机"
| 方式 | 单机可行性 | 停机时长 |
|---|---|---|
| 直接重启 | 简单 | 数秒到数十秒 |
| 先起新版再切代理 | 可行 | 接近零 |
| 蓝绿双容器 | 可行 | 接近零,代价是双份内存 |
| 滚动更新 | 单机意义不大 | — |
单机最容易落地的"零停机":
text
1. 起一个新容器(不同端口,比如 8001),等它 /readyz 通过
2. 把 Nginx upstream 指向 8001,reload
3. 停掉旧容器代价是同一时刻两份进程在内存里,2G 机器要掂量。如果只能接受"几秒不可用",就在低峰发布,并接受这个现实——比为了零停机把架构搞复杂更划算。
5.4 回滚:一分钟内做完
| 需要准备 | 具体做法 |
|---|---|
| 版本可回 | 镜像 tag 用 commit sha,保留最近 5–10 个 |
| 配置可回 | docker-compose.yml 进 Git,改动可 revert |
| 数据可回 | 发布前备份(第 7 章) |
| 命令可背 | 一条脚本 ./rollback.sh <上一个 tag> |
bash
#!/usr/bin/env bash
set -euo pipefail
TAG="$1"
cd /srv/app
sed -i "s|image: .*|image: ghcr.io/you/app:${TAG}|" docker-compose.yml
docker compose pull
docker compose up -d
sleep 5
curl -fsS http://127.0.0.1:8000/readyz三条必须记住的话:
- 代码能回滚,数据不一定能。删列、改类型这类迁移,回滚镜像救不回来;
- 回滚要比修复快。出事时先回滚止血,再慢慢查原因;
- 回滚完要补一次复盘,否则同一个坑会再踩。
5.5 国内网络下的两个现实问题
| 问题 | 表现 | 解法 |
|---|---|---|
| 拉 GitHub 慢 | CI 或服务器 git clone 卡住 | 用国内代码托管镜像、或只在 CI 里拉一次 |
| 拉镜像慢/限速 | docker pull 超时 | 用带镜像加速的 registry、或在 CI 推到一个国内可达的 registry |
| 证书/依赖下载慢 | 构建时间过长 | 构建期用国内镜像源,运行期不受影响 |
这也解释了一个常见现象:"我本地构建 2 分钟,服务器构建 20 分钟还没完"——不是机器差,是网络与依赖源的问题。这也是"在 CI 构建"的额外好处:构建环境的网络通常比你的小机器稳。
5.6 发布与回滚的时序
本章小结
| 要点 | 说明 |
|---|---|
| 拓扑 | CI 构建推 registry,生产只 pull(推荐) |
| 流水线 | 构建 → 推 → 拉重启 → 就绪检查判红 |
| 版本 | tag 用 commit sha,禁用裸 latest |
| 零停机 | 起新容器 → 切代理 → 停旧容器(要内存) |
| 回滚 | 一条脚本、几十秒,先止血后查因 |
| 数据 | 代码可回,迁移不一定可回 |
| 网络 | 慢通常在拉取与依赖源,不在机器性能 |
下一章
发布自动化了,但你得知道它有没有变坏:日志、指标、告警,以及一次告警怎么真的送到你手机上。