CI/CD / 系统课时
编写第一条流水线
编写第一条流水线
第一条 CI 流水线先解决最小闭环:代码提交后自动启动一个 Job,并按顺序执行可验证步骤。本课用 GitHub Actions 写一个最小工作流,再从日志确认触发、Job 与 Step 的组织关系,为后续构建、测试和部署扩展打好骨架。
学习目标
- 识别工作流配置中的触发器、Job 和 Step 三个核心层级
- 创建一条由代码提交触发的最小 CI 流水线
- 从运行日志验证步骤顺序和本次提交版本
理解最小工作流结构
GitHub Actions 的工作流文件放在 .github/workflows/。顶层 on 决定什么时候运行,jobs 定义可并行或有依赖关系的作业,每个 Job 里的 steps 再按书写顺序执行具体动作。
这里先保持单 Job:它足以验证“提交触发 → 分配 Runner → 拉取代码 → 执行命令”这条最短链路。等这条链路稳定后,再加入构建、测试、制品和部署阶段,排错成本会低很多。
创建第一条工作流
在仓库中新建 .github/workflows/ci.yml,写入下面内容。push 让提交到 main 时触发,pull_request 让针对 main 的合并请求也执行同一套校验。
name: ci
on:
push:
branches:
- main
pull_request:
branches:
- main
jobs:
verify:
runs-on: ubuntu-latest
steps:
- name: Checkout source
uses: actions/checkout@v4
- name: Show revision
shell: bash
run: |
echo "commit=$(git rev-parse --short HEAD)"
- name: Run basic check
shell: bash
run: |
echo "pipeline ok"预期输出
commit=<ID>
pipeline ok<ID> 是本次提交的短 SHA,实际值每次不同。平台日志还会包含 Runner 准备、Action 下载和 Step 边界,因此只需要确认上面两行出现且三个 Step 都成功即可。
验证提交触发
把文件提交并推送到 main。如果默认分支不是 main,应把 YAML 中的分支名改成仓库真实分支,否则工作流文件存在也不会被当前提交触发。
git add .github/workflows/ci.yml
git commit -m "ci: add first workflow"
git push origin main预期输出
[main <ID>] ci: add first workflow
<...>
To <PATH>
<ID>..<ID> main -> mainGit 输出会因远端地址、提交历史和客户端版本而变化。关键结果是推送成功,并且 CI 平台出现由这次 push 创建的运行记录。
扩展时保留清晰层级
当需要加入依赖安装和测试时,优先在当前 verify Job 内增加 Step;只有运行环境、权限、失败隔离或并行策略明显不同,才拆成新的 Job。这样每一层都有明确职责:工作流负责触发,Job 负责执行环境与阶段边界,Step 负责一项具体动作。