Skip to content

第 5 章:自动发布与回滚 ​

手工发布三次之后你就会烦,五次之后就会出错。自动化不是为了快,是为了每次都一样——包括失败的时候。


学习目标 ​

  • 判断"在哪构建镜像":服务器上还是 CI 上
  • 写出一条 push 即部署的流水线
  • 让镜像可回滚:tag、digest 与保留策略
  • 知道出事时第一分钟该按哪个按钮

5.1 两种拓扑,先选一个 ​

区别只有一句:镜像在哪台机器上被构建出来A · 服务器上构建(简单,但危险)git push服务器拉代码docker build重启优点:链路短、不用 registry代价:构建吃满 CPU/内存(2G 机器直接卡死)、构建依赖在线上回滚:得重新构建一次,慢且不可靠B · CI 构建后推送(推荐)pushCI 构建推 registry服务器 pull+ 重启优点:服务器只负责拉与跑,构建不吃生产资源回滚:把 tag 换回上一个,一条命令几十秒代价:多一个 registry 与服务端鉴权判断标准只有一条:生产机该不该干"构建"这种重活。多数人的答案是"不该"。例外:完全离线、或只有一台机器且构建确实很轻(纯静态站),A 方案也够用。不管选哪个,都要做到:镜像有唯一版本号、能回到上一版、回滚不依赖重新构建。最常见的坏习惯:只用 :latest。它意味着"我不知道线上跑的是哪一版",回滚无从下手。

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

三条必须记住的话:

  1. 代码能回滚,数据不一定能。删列、改类型这类迁移,回滚镜像救不回来;
  2. 回滚要比修复快。出事时先回滚止血,再慢慢查原因;
  3. 回滚完要补一次复盘,否则同一个坑会再踩。

5.5 国内网络下的两个现实问题 ​

问题表现解法
拉 GitHub 慢CI 或服务器 git clone 卡住用国内代码托管镜像、或只在 CI 里拉一次
拉镜像慢/限速docker pull 超时用带镜像加速的 registry、或在 CI 推到一个国内可达的 registry
证书/依赖下载慢构建时间过长构建期用国内镜像源,运行期不受影响

这也解释了一个常见现象:"我本地构建 2 分钟,服务器构建 20 分钟还没完"——不是机器差,是网络与依赖源的问题。这也是"在 CI 构建"的额外好处:构建环境的网络通常比你的小机器稳。


5.6 发布与回滚的时序 ​


本章小结 ​

要点说明
拓扑CI 构建推 registry,生产只 pull(推荐)
流水线构建 → 推 → 拉重启 → 就绪检查判红
版本tag 用 commit sha,禁用裸 latest
零停机起新容器 → 切代理 → 停旧容器(要内存)
回滚一条脚本、几十秒,先止血后查因
数据代码可回,迁移不一定可回
网络慢通常在拉取与依赖源,不在机器性能

下一章 ​

发布自动化了,但你得知道它有没有变坏:日志、指标、告警,以及一次告警怎么真的送到你手机上。

本文阅读--次|全站访问--次|访客--人