用 GitHub Actions 做 CI · DevOps：容器、CI 与 Kubernetes

为什么需要它

直觉理解

name: CI
on:                                # 什么时候运行
  push:
    branches: [main]
  pull_request:
jobs:
  test:                            # 每个 job 在一台全新的机器上运行
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4  # 一个现成的 action
      - run: pytest                # 一条 shell 命令
  deploy:
    needs: test                    # 只在 test 成功之后
    runs-on: ubuntu-latest
    steps:
      - run: ./deploy.sh
        env:
          TOKEN: ${{ secrets.DEPLOY_TOKEN }}

定义

CI / CD

Continuous integration: test every change automatically. Continuous delivery/deployment: release what passed automatically.

持续集成：自动测试每一次改动。持续交付/部署：自动发布通过测试的版本。

Job（任务）

A list of steps that runs on its own fresh machine. Jobs run in parallel unless linked with needs.

在一台独立的全新机器上运行的一串步骤。除非用 needs 关联，job 之间并行运行。

密钥（secret）

A value stored in the repository settings and given to workflows as ${{ secrets.NAME }}, hidden from logs.

存在仓库设置里的值，以 ${{ secrets.NAME }} 的形式提供给工作流，在日志里隐藏。

示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

name: CI
on:
  push:
    branches: [main]
  pull_request:
jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-python@v5
        with:
          python-version: "3.12"
      - run: pip install -r requirements.txt
      - run: pytest
  deploy:
    needs: test
    if: github.ref == 'refs/heads/main'
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: ./deploy.sh
        env:
          TOKEN: ${{ secrets.DEPLOY_TOKEN }}

常见错误

小测验

动手练习

3 道练习，分三层：先预测程序的输出，再按新需求改程序，最后从零写一个。代码在浏览器里运行，提交马上判题。

1. 预测输出哪个 job 什么时候运行？

   这五个 job 是怎么运行的？

2. 改需求更安全的流水线

   有两个问题：test 失败时 deploy 照样运行；部署令牌直接写在文件里。让 deploy 等待 test，并且改为通过环境变量 TOKEN 传入密钥 DEPLOY_TOKEN（脚本会读取 $TOKEN，所以那一行改成 ./deploy.sh 就行）。

3. 从零写给 Node 项目配 CI

   写一个名叫 CI 的工作流，在 pull request 和推送到 main 时运行，包含两个运行在 ubuntu-latest 上的 job：

   • test：检出代码（actions/checkout@v4），配置 Node（actions/setup-node@v4，node-version: "20"），然后运行 npm ci 和 npm test
   • build：只在 test 之后运行；检出代码，运行 npm ci，然后 npm run build

本课术语