2. GitHub Actions 核心概念：Workflow、Job、Step、Runner、Event、Action

GitHub Actions 是一个事件驱动的自动化平台，其执行模型由六个核心概念构成：Workflow（工作流）、Job（作业）、Step（步骤）、Runner（运行器）、Event（事件）和 Action（动作）。理解这六个概念之间的关系，是编写 CI/CD 流水线的起点。

2.1 概念对比与职责划分

2.2 配置结构与执行流程

一个典型的 Workflow 文件以 YAML 格式编写，GitHub 在推送到仓库后立即解析并排队。以下是后端测试场景中最基础的流水线配置：

name: Backend Test CI
on:
  push:
    branches: [ "main", "develop" ]
  pull_request:
    branches: [ "main" ]

jobs:
  unit-test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Install dependencies
        run: npm ci
      - name: Run unit tests
        run: npm run test:unit

  integration-test:
    needs: unit-test
    runs-on: ubuntu-latest
    services:
      postgres:
        image: postgres:15
        env:
          POSTGRES_PASSWORD: testpass
        options: >-
          --health-cmd pg_isready
          --health-interval 10s
          --health-timeout 5s
          --health-retries 5
    steps:
      - uses: actions/checkout@v4
      - name: Run integration tests
        run: npm run test:integration

2.3 Runner 的隔离性与上下文

每个 Job 会分配到独立的 Runner 实例，Runner 环境之间完全隔离。下表总结了 GitHub 托管 Runner 和自托管 Runner 的关键差异：

2.4 Action 的三种来源

在使用 uses: 关键字时，可以从以下三种位置引用 Action：

• GitHub 官方 Action： 前缀为 actions/，如 actions/checkout@v4、actions/setup-node@v4。经过大量验证，推荐生产环境使用。
• 社区/第三方 Action： 格式 author/repo@tag，例如 docker/login-action@v3。使用时建议固定到语义化标签或 commit SHA。
• 本地 Action： 通过 ./path/to/action 引用仓库目录内的 Action 定义，适合团队内部测试工具复用。

2.5 Event 触发矩阵与常见陷阱

Workflow 可以响应多种事件，事件还可以组合过滤条件。下面列出后端测试中最常用的四个事件及其注意事项：

2.6 Job 依赖与矩阵策略

在复杂后管任务测试中，经常需要并行运行多版本测试。GitHub Actions 通过 strategy.matrix 实现测试矩阵，同时利用 needs 建立 Job 间依赖。

jobs:
  lint:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: npm run lint

  test:
    needs: lint
    runs-on: ubuntu-latest
    strategy:
      matrix:
        node-version: [18, 20, 22]
        os: [ubuntu-latest, windows-latest]
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: ${{ matrix.node-version }}
      - run: npm ci
      - run: npm test

  deploy-staging:
    needs: test
    runs-on: ubuntu-latest
    if: github.ref == 'refs/heads/main'
    steps:
      - run: echo "Deploying to staging..."

2.7 Step 的上下文与表达式

Step 可以通过 ${{ }} 表达式访问上下文信息，包括 github、env、secrets、steps 和 runner 等。以下示例展示如何在 Step 之间传递数据：

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - id: step1
        name: Generate version
        run: echo "version=1.0.0-$(date +%s)" >> "$GITHUB_OUTPUT"
      - name: Use version from previous step
        run: |
          echo "Building version: ${{ steps.step1.outputs.version }}"
          # 实际构建命令使用该版本号

输出传递机制： 通过写入 $GITHUB_OUTPUT 环境文件（推荐方式，替代已弃用的 ::set-output 命令），下游 Step 可以通过 steps.<id>.outputs.<key> 获取。此机制在并行 Job 之间不可用，跨 Job 传递请使用 artifacts 或 workflow_dispatch 参数。

2.8 性能稳定性关键参数

在日常调试和优化中，以下参数直接影响 Workflow 的执行稳定性：

jobs:
  debug-context:
    runs-on: ubuntu-latest
    steps:
      - name: Dump GitHub context
        env:
          GITHUB_CONTEXT: ${{ toJSON(github) }}
        run: echo "$GITHUB_CONTEXT"
      - name: Dump runner context
        env:
          RUNNER_CONTEXT: ${{ toJSON(runner) }}
        run: echo "$RUNNER_CONTEXT"