编写流水线

本章节详细介绍如何编写 AtomGit Action 流水线的各个组成部分，涵盖工作流文件基础、触发条件、任务与步骤配置、脚本命令、Action 插件、依赖编排、条件执行、矩阵构建、变量密钥、输出传递、制品管理以及缓存使用。

📄️ 工作流文件位置与基本结构

适用场景 ：当你需要在仓库中创建第一个 AtomGit Action 流水线，或者需要了解 workflow 文件应该放在哪里、怎么命名、基本 YAML 结构怎么写时。

📄️ 配置触发条件

适用场景 ：当你需要控制 workflow 在什么事件、什么分支、什么路径或什么 Tag 下触发时。

📄️ 配置任务 Jobs

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

📄️ 配置步骤 Steps

适用场景 ：当你需要在 job 内定义具体的执行步骤，包括运行脚本、调用 Action 插件、设置环境变量、条件执行等时。

📄️ 使用脚本命令

适用场景 ：当你需要在 step 中通过 run 执行 shell 命令、调用仓库内脚本、设置环境变量或写入输出参数时。

📄️ 使用 Action 插件

适用场景 ：当你需要在 step 中调用可复用的 Action 插件来完成拉取代码、设置语言环境、缓存依赖、上传制品等操作时。

📄️ 配置任务依赖与执行顺序

适用场景 ：当你需要控制多个 job 的执行顺序，实现 build → test → deploy 的串行流程，或更复杂的 DAG 拓扑时。

📄️ 配置条件执行

适用场景 ：当你需要根据分支、Tag、事件类型、前置步骤状态等条件控制 job 或 step 是否执行时。

📄️ 配置矩阵构建

适用场景 ：当你需要在多个操作系统、多个语言版本、多种架构组合下并行执行测试或构建时。

📄️ 使用变量和密钥

适用场景 ：当你需要在 workflow 中使用环境变量、配置变量、密钥或输入参数，并理解它们的作用域和优先级规则时。

📄️ 任务间传递输出参数

适用场景 ：当你需要在 step 之间、job 之间、甚至 workflow 之间传递输出参数时，例如将构建版本号从 build job 传递给 deploy job。

📄️ 上传和下载制品

适用场景 ：当你需要在 job 之间传递构建产物（如编译结果、测试报告、打包文件等）时。

📄️ 使用依赖缓存

适用场景 ：当你需要缓存依赖包（npm、Maven、pip、Gradle 等）以加速后续构建时。