编写流水线
本章节详细介绍如何编写 AtomGit Action 流水线的各个组成部分,涵盖工作流文件基础、触发条件、任务与步骤配置、脚本命令、Action 插件、依赖编排、条件执行、矩阵构建、变量密钥、输出传递、制品管理以及缓存使用。
📄️ 工作流文件位置与基本结构
本文档介绍 AtomGit Action 工作流文件的存放目录、命名规范、YAML 结构字段以及 stages、post、concurrency、permissions 等配置项。
📄️ 配置触发条件
本文档介绍如何通过 on 字段配置工作流的触发事件,包括 push、pullrequest、workflowdispatch、schedule 以及分支/路径/标签过滤规则。
📄️ 配置任务 Jobs
本文档介绍如何定义工作任务(Job),包括运行环境、依赖关系、条件执行、超时时间、环境变量、输出参数和容错配置。
📄️ 配置步骤 Steps
本文档介绍如何在工作流步骤(Step)中配置命令执行、Action 调用、环境变量、条件执行、超时和容错等属性。
📄️ 使用脚本命令
本文档介绍如何在步骤中通过 run 执行 shell 命令、调用仓库内脚本、设置环境变量、写入输出参数以及脱敏敏感信息。
📄️ 使用 Action 插件
本文档介绍如何在步骤中引用官方插件、开源插件和自定义插件,以及如何传递参数和指定版本。
📄️ 配置任务依赖与执行顺序
本文档介绍如何通过 needs 和 stages 控制多个 Job 的执行顺序,实现串行依赖、并行执行和 DAG 拓扑编排。
📄️ 配置条件执行
本文档介绍如何通过 if 表达式和状态函数控制 Job 或 Step 是否执行,支持分支判断、事件类型过滤、前置状态检查等场景。
📄️ 配置矩阵构建
本文档介绍如何通过 strategy.matrix 实现多操作系统、多语言版本、多架构的并行构建与测试。
📄️ 使用变量和密钥
本文档介绍工作流中四种变量类型(env、vars、secrets、inputs)的定义方式、作用域、优先级规则和安全注意事项。
📄️ 任务间传递输出参数
本文档介绍 AtomGit Action 的 Step → Job → Workflow 三级输出传递模型,支持跨步骤和跨任务共享数据。
📄️ 上传 和下载制品
本文档介绍如何通过 upload-artifact 和 download-artifact 插件在 Job 之间传递构建产物和文件。
📄️ 使用依赖缓存
本文档介绍如何通过 cache 插件缓存依赖包(npm、Maven、pip、Gradle 等),加速后续构建的依赖安装过程。