需启用禅道DevOps模块、配置Git Webhook、创建构建计划、在Jenkins中设置参数化任务并上报结果，最终实现代码提交到构建、测试、部署及Bug自动关联的端到端自动化。

如果您希望在禅道中集成DevOps流水线以实现代码提交、构建、测试与部署的自动化协同，则需借助禅道内置的DevOps模块与外部CI/CD工具（如Jenkins、GitLab CI）进行对接。以下是具体实施步骤：

一、启用禅道DevOps模块并配置基础信息

禅道社区版16.5+及专业版默认提供DevOps模块入口，需先在后台开启该功能，并绑定项目与代码仓库。此步骤确保禅道能识别代码变更事件并触发后续流程。

1、使用管理员账号登录禅道，进入【后台】→【系统设置】→【模块设置】。

2、找到“DevOps”选项，勾选“启用DevOps模块”，点击【保存】。

3、返回前台，进入目标项目，点击【项目】→【DevOps】→【添加仓库】。

4、填写仓库类型（Git）、仓库地址、认证方式（推荐Token），并确保填写的Token具有读取代码和读取Webhook事件的权限。

二、配置Git仓库Webhook推送至禅道

Webhook是实现代码提交后自动同步到禅道的关键机制，需在代码托管平台（如GitLab、GitHub、Gitee）中配置请求地址与触发事件类型。

1、在禅道【DevOps】→【仓库列表】中，找到已添加的仓库，点击右侧【Webhook地址】复制完整URL。

2、登录对应Git平台，在仓库【Settings】→【Webhooks】中新建Webhook。

3、粘贴复制的URL，Content type选择application/json，勾选“Push events”和“Merge Request events”（GitLab）或“Just the push event”（GitHub/Gitee）。

4、点击【Add webhook】并测试推送，禅道页面右上角出现“Webhook接收成功”提示即表示连通正常。

三、创建禅道构建计划并关联CI任务

构建计划用于定义何时触发CI任务、关联哪些代码分支及构建参数，是连接禅道与外部CI工具的中间载体。

1、进入【DevOps】→【构建计划】→【创建构建计划】。

2、填写计划名称（如“frontend-dev-build”），选择所属项目与代码仓库。

3、在“触发方式”中选择“Webhook触发”，并指定监听分支（如“develop”）。

4、在“构建工具”下拉菜单中选择已配置的Jenkins或GitLab CI实例，确保该实例已在【后台】→【集成】→【CI工具】中完成授权与连接测试。

四、在Jenkins中配置对应Job并设置参数化构建

Jenkins需通过参数化构建接收禅道传递的分支名、提交ID、构建计划ID等上下文信息，从而执行精准构建。

1、在Jenkins中新建一个“Pipeline”类型任务，命名为与禅道构建计划一致的标识。

2、进入任务【配置】→【参数化构建过程】，添加以下String参数：ZEN_TAO_BUILD_ID、ZEN_TAO_BRANCH、ZEN_TAO_COMMIT_ID、ZEN_TAO_REPO_ID。

3、在Pipeline脚本中使用env.ZEN_TAO_BRANCH动态检出对应分支，例如：checkout([$class: 'GitSCM', branches: [[name: '*/' + env.ZEN_TAO_BRANCH]], ...])。

4、构建完成后，Jenkins需调用禅道API上报结果，请求地址为{禅道URL}/devops-api-build-report，Header需携带token且Body包含buildId与status字段。

五、在禅道中查看构建记录与缺陷自动关联

当CI任务完成并上报结果后，禅道将自动归档构建记录，并根据提交信息中的Bug编号（如“BUG#1234”）反向关联至对应禅道Bug。

1、进入【DevOps】→【构建记录】，可按状态（成功/失败）、时间、分支筛选历史构建。

2、点击某条记录，查看详细日志、代码变更列表及关联的禅道需求、任务、Bug。

3、若某次提交信息中包含“BUG#2056”，且该Bug存在于当前项目中，禅道将自动将该构建记录挂载至Bug详情页的“相关构建”区域。