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 的合并请求也执行同一套校验。

yaml
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"

预期输出

text
commit=<ID>
pipeline ok

<ID> 是本次提交的短 SHA,实际值每次不同。平台日志还会包含 Runner 准备、Action 下载和 Step 边界,因此只需要确认上面两行出现且三个 Step 都成功即可。

验证提交触发

把文件提交并推送到 main。如果默认分支不是 main,应把 YAML 中的分支名改成仓库真实分支,否则工作流文件存在也不会被当前提交触发。

bash
git add .github/workflows/ci.yml
git commit -m "ci: add first workflow"
git push origin main

预期输出

text
[main <ID>] ci: add first workflow
<...>
To <PATH>
   <ID>..<ID>  main -> main

Git 输出会因远端地址、提交历史和客户端版本而变化。关键结果是推送成功,并且 CI 平台出现由这次 push 创建的运行记录。

扩展时保留清晰层级

当需要加入依赖安装和测试时,优先在当前 verify Job 内增加 Step;只有运行环境、权限、失败隔离或并行策略明显不同,才拆成新的 Job。这样每一层都有明确职责:工作流负责触发,Job 负责执行环境与阶段边界,Step 负责一项具体动作。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

编写第一条流水线

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

登录哪都通