配置任务 Jobs

本文档介绍如何定义工作任务（Job），包括运行环境、依赖关系、条件执行、超时时间、环境变量、输出参数和容错配置。

当你需要在 workflow 中定义一个或多个任务，指定运行环境、超时时间、环境变量、并发控制、矩阵策略等时。

前提条件

• 已理解 workflow 的基本结构。
• 已确定 job 需要的运行环境（Runner 标签）。

快速示例

name: ci

on:
  push:
    branches:
      - main

jobs:
  build:
    name: 构建
    runs-on: [ubuntu-latest, x64, small]
    timeout-minutes: 30
    env:
      APP_ENV: production
    steps:
      - name: Checkout source code
        uses: checkout
      - name: Run bash
        run: ./build.sh

配置说明

runs-on 运行环境

runs-on 指定 job 运行的 Runner 环境。AtomGit Action 的官方资源池标签采用三段式格式：{os}-{version},{arch},{flavor}。

段位	说明	示例
{os}-{version}	操作系统及版本	ubuntu-latest 、euler-latest
{arch}	CPU 架构	x64、arm64
{flavor}	资源规格	slim、small、medium、large、xlarge、2xlarge

完整标签示例：

runs-on: [ubuntu-latest, x64, small]

默认标签 default 对应 [ubuntu-latest, x64, small]，即：

runs-on: default
# 等同于 [ubuntu-latest, x64, small]

自托管资源池配置示例：

runs-on: [self-hosted, linux, x64]

self-hosted 表示自托管，通过self-hosted + 自定义标签的方式匹配自托管的资源池。

needs 依赖

通过 needs 配置 job 间的依赖关系，被依赖的 job 完成后才执行当前 job：

jobs:
  build:
    name: 构建
    runs-on: [ubuntu-latest, x64, small]
    steps:
      - name: Run build
        run: echo "build"

  test:
    name: 测试
    runs-on: [ubuntu-latest, x64, small]
    needs: build
    steps:
      - name: Run test
        run: echo "test"

  deploy:
    name: 部署
    runs-on: [ubuntu-latest, x64, small]
    needs:
      - test
      - build
    steps:
      - name: Run deploy
        run: echo "deploy"

if 条件执行

你可以用条件句阻止作业运行，除非满足某个条件。你可以使用任何支持的上下文和表达式来创建条件句。有关本检索表支持的上下文的更多信息，请参见上下文参考。

jobs:
  deploy:
    name: 部署
    if: ${{ atomgit.ref == 'refs/heads/main' }}
    runs-on: [ubuntu-latest, x64, small]
    steps:
      - name: Run deploy
        run: echo "deploy only on main"

timeout-minutes 超时时间

jobs:
  build:
    name: 构建
    runs-on: [ubuntu-latest, x64, small]
    timeout-minutes: 30
    steps:
      - name:  Run bash
        run: ./build.sh

默认超时时间为 4320 分钟（72 小时）。超时后 job 将被强制终止。

env 环境变量

job 级别的 env 对该 job 内所有 step 可见：

jobs:
  build:
    name: 构建
    runs-on: [ubuntu-latest, x64, small]
    env:
      APP_ENV: production
      BUILD_MODE: release
    steps:
      - name: Run env
        run: echo "$APP_ENV"
      - name: Run build
        run: echo "$BUILD_MODE"

outputs 输出参数

job 可以声明输出参数，从 step 输出中映射：

jobs:
  prepare:
    name: 准备
    runs-on: [ubuntu-latest, x64, small]
    steps:
      - name: Run output
        id: version
        run: echo "version=1.0.0" >> "$ATOMGIT_OUTPUT"

strategy 矩阵策略

详见配置矩阵构建。

continue-on-error 容错

jobs:
  flaky-test:
    name: 不稳定测试
    runs-on: [ubuntu-latest, x64, small]
    continue-on-error: true
    steps:
      - name: Run bash
        run: ./run-flaky-test.sh

设置 continue-on-error: true 后，即使 job 失败，workflow 也不会因此终止（后续依赖该 job 的 job 需通过 if 条件判断是否继续）。

常见问题

Q：runs-on 标签格式为什么是三段式？

A：AtomGit托管资源池标签采用 {os}-{version},{arch},{flavor} 三段式格式，提供了更精确的环境选择能力。

Q：job 默认是并行还是串行？

A：无 needs 配置时，多个 job 默认并行执行。配置 needs 后按依赖顺序执行。也可使用 stages 阶段机制实现阶段间串行。

Q：continue-on-error 对后续 job 有什么影响？

A：设置 continue-on-error: true 的 job 即使失败，也不会阻止后续 job 运行。