- 1. 禅道DevOps解决方案介绍
- 1.1 关于禅道DevOps解决方案
- 1.2 DevOps4.0版本的变化
- 2. 安装与升级
- 3. 空间
- 4. 代码库
- 5. 分支规则
- 6. 分支类型
- 7. 评审流程
- 8. AI代码评审
- 9. 分支归档
- 10. 流水线
- 11. 制品库
- 12. 代码扫描
- 13. 应用管理
- 13.1 应用管理
- 14. 部署
- 15. 配置管理
- 16. Fit命令
- 16.1 Fit命令行使用手册
- 1.1 关于禅道DevOps解决方案
编排流水线
本篇目录
流水线作为DevOps中的核心概念,扮演着打通工具链、实现自动化的重要角色。通过建立高效的流水线,研发团队可以实现更高效、更快速、更可靠的软件开发和交付过程。
安装解决方案后,研发团队可以在代码库或空间下,直接新建编排流水线。
1. 流水线的结构
系统支持创建不同层级的流水线:
空间流水线:归属于空间层级,属于无源流水线,支持手动触发和定时触发,可用于跨代码库任务。
代码库流水线:归属在某个代码库下,运行时需选择执行分支,支持事件触发、手动触发和定时触发。
流水线执行的基本单元为任务,不同的任务可以组合成为阶段,流水线会按照阶段顺序执行任务。
2. 创建流水线
进入代码库-流水线列表,或空间-流水线列表,点击创建流水线。

可直接创建空白流水线,或在现有流水线进行复制。

3. 配置流水线参数
流水线创建完成后,或在列表页点击编排按钮,会进入流水线编排页面,可以在编排页面配置流水线参数。

右侧抽屉式属性面板,分为「基本信息」「变量配置」「触发规则」三个标签页:

在基本信息页面,展示关联代码库,可自定义名称和描述,用于列表展示区分,输入后同步更新到 YAML 内流水线名称字段。

切换到变量配置选项卡,可配置流水线运行时的全局变量。代码库层级的流水线,会默认包含“分支”变量,用于指定运行时的分支。

点击添加变量,可以根据自己的需求对变量进行配置
显示名:变量的显示名称
Key:变量名
赋值方式:分为固定值和运行时指定。若选择运行时指定,则手动触发流水线时,系统会弹出弹窗,要求使用者输入变量值。当流水线通过自动化触发时,系统会采用下方默认变量值的内容。
变量值/默认变量值:当赋值方式为固定值时,变量值为必填。当赋值方式为运行时指定时,默认变量值为选填。

变量支持修改或删除

点击触发规则选项卡,可以对流水线的自动化触发规则进行配置。

系统支持按照事件触发(仅代码库下流水线)、按周定时触发、按月定时触发。

4. 编排流水线
在流水线列表点击编排按钮,可以进入流水线编排页面

可视化编排
进入流水线编排可视化页面后,左侧为流水线画板区域,鼠标悬停在开始和结束中间的连接线上,会出现加号,点击加号即可增加阶段

在右侧弹窗中可修改阶段名称,阶段添加完成后会自动创建一个任务。

点击任务卡片,可选择任务类型,选择任务类型后,进入任务编辑页面。

点击确定按钮,即可保存当前任务。

鼠标悬停在任务和任务的连接线上,即可添加下一个任务。

鼠标悬停在阶段的连接线上,即可添加下一个阶段。

YAML编排
进入YAML编排详情页,可以看到 YAML 代码编辑器
可直接编辑流水线完整定义,可配置阶段、任务步骤、执行容器、脚本、仓库克隆策略等全部流水线能力;

5. 激活流水线
流水线编排完成后,可以点击右上角保存按钮,将流水线保存为草稿状态。草稿状态的流水线不支持运行。
点击发布按钮,流水线将保存为激活状态。

附录:当前可用的环境变量
1、平台内置变量
| 变量 | 含义 | |
|---|---|---|
| GITFOX_WORKSPACE | 工作区根 | |
| GITFOX_EXECUTION_ID | 执行 ID | |
| GITFOX_STAGE_ID | stage 工作区(custom_env、临时脚本落此) | |
| GITFOX_API_ENDPOINT | API 完整地址 | |
| GITFOX_COMMIT_SHA | 检出 commit | |
| GITFOX_COMMIT_BEFORE / AFTER | 内嵌流水线扫描区间 |
2、插件连接平台相关变量
| 变量 | 用途 |
|---|---|
| GITFOX_API_ENDPOINT | 完整 API 地址(优先) |
| PLUGIN_GITFOX_SERVER_PROTO / _HOST / _PORT | 拼接用 |
| PLUGIN_TOKEN | 认证头 |
3、仓库目录传递变量
| 变量 | 写入方 | 读取方 |
|---|---|---|
| GITFOX_CLONE_REPO | git_clone(SetOutput) | build_go /build_gradle/build_maven /build_nodejs/build_docker /codescan/aireview,统一经 parameter.GetGitCloneDir () |
- 公用插件输入 PLUGIN_WORKSPACE






























精品资料包
1V1产品演示
免费试用增强功能
专属顾问答疑支持


