工作流触发器
简介
本文主要介绍自定义工作流的触发器功能,包括:
Git 触发器
:代码变更后自动触发工作流定时器
:定时触发工作流JIRA 触发器
:JIRA 问题状态变更后自动触发工作流飞书项目触发器
:飞书项目状态变更后自动触发工作流通用触发器
:任意第三方系统通过 Webhook 自动触发工作流
产品工作流中支持 Git 触发器和定时器,具体使用可参考文档:产品工作流触发器操作、产品工作流定时器操作。
Git 触发器
提示
- 为工作流配置触发器,当满足触发条件的事件发生时会自动触发工作流执行。
- 支持的代码源请参考文档:代码源信息。
- 支持自动创建和手动创建两种方式,二者的区别如下:
- 自动创建:在工作流中配置触发器参数即可,Zadig 会自动在对应代码库中创建 Webhook,适用于代码源集成账号对代码库有创建 Webhook 权限的场景。
- 手动创建:先在代码库中配置 Webhook,再在 Zadig 中配置触发器参数,适用于代码源集成账号对代码库没有创建 Webhook 权限的场景。
自动创建
点击工作流右侧的 触发器
。
选择 Git 触发器
-> 填写参数后保存即可。
参数说明:
工作流执行变量
:希望被 Webhook 触发执行的任务,以及任务中的具体配置- 其他参数:请参考 Git 触发器基本配置中的描述
手动创建
如果系统集成中的代码源集成账号对代码库没有创建 Webhook 权限,可以选择使用手动创建的方式来配置,操作步骤如下:
- 点击
手动创建 Webhook
切换到手动创建页面。
- 访问代码库配置 Webhook,填写 Webhook URL、Secret Token、触发事件,以 GitLab 示例如下:
不同代码源需要配置的触发事件
- GitHub 代码源:Branch or tag creation、Check runs、Pull requests、Pushes
- GitLab 代码源:Push events、Tag push events、Merge request events
- Gitee 代码源:Push、Tag Push、Pull Request
- 参考 Git 触发器基本配置,填写 Zadig 中的相关配置后保存即可。
定时器
编辑工作流,点击右侧的 触发器
-> 选择 定时器
,通过配置定时器,可以实现周期性的运行工作流。支持定时循环、周期循环以及基于 Cron 表达式循环。
参数说明:
- 工作流执行变量:希望被触发执行的任务,以及任务中的具体配置
- 其他参数:参考定时器配置
JIRA 触发器
可实现 JIRA 状态变更后自动触发 Zadig 工作流。
第一步:在工作流中添加 JIRA 触发器
编辑工作流,点击右侧的 触发器
-> 选择 JIRA 触发器
。
填写参数后保存触发器配置。
参数说明:
工作流执行变量
:希望被触发执行的任务,以及任务中的具体配置
复制 Webhook Url 后保存工作流。
第二步:在 JIRA 中完成 Webhook 配置
访问 JIRA 系统 -> 点击右上角的 设置
图标 -> 点击 System
-> 在左侧 ADVANCED
下找到 Webhook
。
点击 + Create a Webhook
-> 填写 URL(即:第一步中保存的 Webhook Url)并配置触发事件。
提示
目前支持基于 Issue related events
事件自动触发工作流
当满足条件的事件发生后会自动触发工作流执行,待工作流执行完成后,将会添加 Comment 到对应的 Issue 中。
飞书项目触发器
可实现飞书工作项状态变更后自动触发 Zadig 工作流。
第一步:在工作流中添加飞书项目触发器
编辑工作流,点击右侧的触发器
-> 选择 飞书项目触发器
。
填写参数后保存触发器配置。
参数说明:
工作流执行变量
:希望被触发执行的任务,以及任务中的具体配置
复制 Webhook Url 后保存工作流。
第二步: 在飞书项目中完成 Webhook 配置
点击 空间配置
-> 自动化
-> 新建规则
,进入规则创建。
根据需要选择规则,并在操作中将操作类型
设为 WebHook -> 填写 URL(即:第一步中保存的 Webhook Url)后保存规则。
当满足条件的事件发生后会自动触发工作流执行,待工作流执行完成后,将会添加 Comment 到对应的 Issue 中。
通用触发器
点击右侧的 触发器
-> 选择 通用触发器
即可配置实现第三方 Webhook 触发工作流。
参数说明:
工作流执行变量
:希望被触发执行的任务,以及任务中的具体配置
复制 Webhook Url,在第三方系统中完成添加。