流水线任务 jobs

非必填，默认使用云效北京构建集群。 流水线任务运行的集群环境，可以使用云效提供的公共集群环境，也可以使用私有构建集群。支持 默认环境、指定容器环境 和 默认VM环境。

默认环境：在构建 K8s 集群或主机上启动容器，在容器环境进行构建。语法示例如下：

jobs:
  my_job:
    name: 我的任务
    runsOn: private/<私有构建集群ID>  // 指定私有构建集群、默认环境；不填时，默认使用云效北京构建集群

说明：默认环境已处于 Deprecated 状态，2025.4.1号之后创建的组织已不支持默认环境，请使用下述指定容器环境。

指定容器环境：在构建机器上启动指定容器，在单容器环境进行构建。语法示例如下：

jobs:
  my_job:
    name: 我的任务
    runsOn:
      group: [public/cn-beijing|public/cn-hongkong] // 指定容器环境目前仅支持云效公共构建集群
      container: build-steps-public-registry.cn-beijing.cr.aliyuncs.com/build-steps/alinux3:latest // 公网可直接访问的 public 镜像地址,云效系统官方镜像参考：https://atomgit.com/flow-steps/system_images/blob/main/README.md 

默认VM环境：直接在构建集群的宿主机或虚拟机上执行步骤。示例如下：

jobs:
  my_job:
    name: 我的任务
      runsOn:
        group: private/<私有构建集群ID>   // 仅支持私有构建集群，指定私有构建集群
        labels: windows, amd64          // 指定操作系统、架构调度；不填时，则随机调度到集群中的某台机器
        vm: true                        // 指定 VM 构建环境；不填时，则使用默认环境

目前私有构建集群支持接入 Linux、Windows、macOS 机器，各操作系统支持架构和构建环境如下：

非必填，构建环境规格。云效会根据任务中配置的步骤自动分配 DEFAULT 默认规格，默认规格详见帮助文档：构建集群 。如有需要，您也可以指定构建环境规格，规格可选：SMALL_1C2G、MEDIUM_2C4G、LARGE_4C8G、XLARGE_8C16G、XXLARGE_16C32G。

如：

jobs:
  my_job:
    name: 我的任务
    runsOn:
      group: public/cn-beijing
      container: build-steps-public-registry.cn-beijing.cr.aliyuncs.com/build-steps/alinux3:latest
      instanceType: LARGE_4C8G    # 指定构建环境规格

非必填，默认任务运行超时时间为 240 分钟，支持设置范围 1~1440 分钟

如：

jobs:
  my_job:
    name: 我的任务
    runsOn:
      group: public/cn-beijing
      container: build-steps-public-registry.cn-beijing.cr.aliyuncs.com/build-steps/alinux3:latest
    timeoutMinutes: 60		# 任务开始运行后，60分钟超时结束

非必填，填写该值，则可以在任务结束之后保留任务执行环境，并登录到环境中进行调试。

只能和”指定容器环境“一起使用。

这两个值需要一起填写，或者都不填写。

debugPolicy 的可选值：

1. onFailure：仅任务运行失败时才保留运行环境，运行成功或仅红线卡点不通过则不会保留环境

2. always：无论任务是否成功都保留构建环境

debugRetentionMinutes 是1-240之间的整数，表示保留的时长

如：

jobs:
  my_job:
    name: 我的任务
    runsOn:
      group: public/cn-beijing
      container: build-steps-public-registry.cn-beijing.cr.aliyuncs.com/build-steps/alinux3:latest
    debugPolicy: always
    debugRetentionMinutes: 5

jobs:
  my_job:
    name: 我的任务
    runsOn: public/cn-beijing
    driven: manual		#手动确认执行任务

jobs:
  my_job:
    name: 我的任务
    runsOn: public/cn-beijing
    condition: |
      "${CI_COMMIT_REF_NAME}" == "master"		# 运行分支为 master 时执行该任务

jobs:
  deploy_job:
  name: 主机组部署任务
  runsOn: public/cn-beijing
  component: VMDeploy             # 指定组件
  with:                           # 填写组件的参数
    artifact: $[stages.build_stage.build_job.upload_step.artifacts.default]
    machineGroup: <YOUR-MACHINE-GROUP-ID>
    ......