CI/CD / 系统课时

一次代码提交如何触发流水线

一次代码提交如何触发流水线

当代码被推送到 GitHub 后,Actions 并不是直接在仓库服务器上执行脚本,而是先匹配工作流触发条件,再创建运行记录、分配 Runner,最后按 Job 和 Step 执行。本篇沿着一次 push 梳理完整链路,并学会从运行记录判断问题发生在哪一层。

学习目标

  • 理解 push 事件从产生到工作流执行的完整链路
  • 区分 Workflow、Job、Step 与 Runner 在执行过程中的职责
  • 能从 Actions 运行记录定位触发、调度或执行阶段的问题

从 push 到工作流运行

假设仓库已经存在 .github/workflows/ci.yml,其中声明监听 main 分支的 push。开发者提交代码并推送后,GitHub 会产生对应的仓库事件,再检查工作流的 on 条件是否匹配。

下面用本地 Git 命令制造一次真实的 push 事件:

bash
git add .
git commit -m "test actions trigger"
git push origin main

预期输出

text
To <REPOSITORY_URL>
   <OLD_COMMIT>..<NEW_COMMIT>  main -> main

提交哈希和仓库地址会因实际环境不同而变化。git commit 本身只创建本地提交;真正让 GitHub 收到 push 事件的是随后执行的 git push。

一次 push 触发 GitHub Actions 的执行链路

GitHub 如何决定要不要执行

事件发生并不意味着所有工作流都会运行。GitHub 会读取默认分支当前提交中以及事件关联提交中的工作流配置,并依据 on 中声明的事件及过滤条件决定是否触发。以常见配置为例,只有推送目标为 main 时才符合条件。

yaml
name: CI

on:
  push:
    branches:
      - main

jobs:
  check:
    runs-on: ubuntu-latest
    steps:
      - name: Show commit
        run: echo "Triggered by $GITHUB_SHA"

这是工作流配置示例,保存到 .github/workflows/ci.yml 后生效。验证时向 main 推送一次提交,然后进入仓库的 Actions 页面,应看到名为 CI 的 Workflow Run;向未匹配的其他分支推送时,这条 push 规则不会创建对应运行。

Runner 实际执行什么

触发条件匹配后,GitHub 创建 Workflow Run。一个 Workflow Run 可以包含一个或多个 Job;每个 Job 根据 runs-on 请求合适的 Runner,并在 Runner 上依次执行自己的 Steps。Step 可以运行 Shell 命令,也可以调用 Action。

对于 GitHub 托管 Runner,Job 获得的是为该 Job 准备的执行环境。Job 结束后,Runner 将步骤日志和最终状态回传。后续 Job 默认不能依赖前一个 Job 工作目录中临时留下的文件;需要跨 Job 传递文件时,应显式使用 artifact 等机制。

执行结果通常沿着 Workflow → Job → Step 向下查看。某个 Step 返回非零退出码时,该 Step 通常会失败,并影响所在 Job 及最终 Workflow Run 的状态,除非工作流显式配置了其他错误处理行为。

按链路定位没有运行的问题

如果推送后看不到预期结果,应按执行链路从前往后检查,而不是直接怀疑 Runner。先确认提交确实推送到了目标仓库和目标分支,再确认工作流文件位于 .github/workflows/ 且 YAML 可被识别,随后检查 on 的事件、分支或路径过滤条件。

如果已经出现 Workflow Run,说明事件至少触发了工作流,此时再查看 Job 是否处于等待状态以及 Runner 是否可用。若 Job 已开始执行,则进入失败的 Step 阅读日志。这样可以把问题快速归类为“未触发”“等待调度”或“执行失败”,避免在错误层级反复修改配置。

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

目录与阅读设置

阅读设置

17

记录一个想法

一次代码提交如何触发流水线

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

登录哪都通