> For the complete documentation index, see [llms.txt](https://guides-ones.gitbook.io/guides/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guides-ones.gitbook.io/guides/usage-guide/ones-pipeline/pipeline-xb/liu-shui-xian-guan-li.md). # 流水线管理 ### 通过流水线管理，进行持续集成与交付管理、及其和 Project 模块的结合使用。 ### 1 启用流水线管理 Pipeline 初始页面增加使用示例。如果当前团队未关联过 Jenkins，可以在 ONES Pipeline 首页点击「开启关联 Jenkins」进入 Pipeline 配置中心关联 Jenkins，以开启流水线管理的旅程。 ![](https://2389253470-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LwaVKDFhf_vIPo5hDmS%2F-MBdKnb_v8SCop9cNr2L%2F-MBdP-dBFWWRtsBKzyGp%2Fimage.png?alt=media\&token=38c6e8f3-93de-4c49-8c51-d97ea65f4472) 如果当前团队已关联过 Jenkins，可以进入 Pipeline 配置中心继续新建或编辑已关联 Jenkins。 ### 2 关联 Jenkins #### 2.1 新建关联 Jenkins {% hint style="info" %} 1. **关联 Jenkins 前，请确保 ONES 系统和贵司 Jenkins 网络能互联互通。** 2. Jenkins 版本最低支持 2.176.4，最高支持 2.235.1，推荐使用 2.204.5。 {% endhint %} 前往 Pipeline 配置中心的关联 Jenkins 页面，点击「新建关联 Jenkins」以关联当前团队所需持续集成工具。系统支持 Jenkins「流水线、文件夹、多分支流水线」类型的任务。关联 Jenkins 后，你可以在「ONES Pipeline」管理和追踪此类流水线。 ![](https://2389253470-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LwaVKDFhf_vIPo5hDmS%2F-MF5fBFggInckfb6Orfn%2F-MF5fWGn64wFRdpO9SYK%2Fimage.png?alt=media\&token=21293a39-8618-4a87-a094-9b25c3683a5b) 已关联的 Jenkins 将按列表展示。当你进入关联 Jenkins 页面时，系统会自动检测 Jenkins 的访问状态。访问失败可能的原因：Jenkins 服务器挂掉、网络问题、Jenkins 的用户或密码/Token 已变更等。 ![](https://2389253470-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LwaVKDFhf_vIPo5hDmS%2F-MF5fBFggInckfb6Orfn%2F-MF5g7cAcnz0HsXSKofJ%2Fimage.png?alt=media\&token=4d2abc46-9e1d-4ea2-9f79-aa3175b4f33d) #### 2.2 编辑关联 Jenkins 如果访问 Jenkins 的用户名或密码/Token 需要变更，你可以点击「编辑关联」按钮修改。编辑用户名或密码/Token 不会触发流水线的重新同步。 ![](https://2389253470-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LwaVKDFhf_vIPo5hDmS%2F-MF5fBFggInckfb6Orfn%2F-MF5g1C9buSx64uf1-mx%2Fimage.png?alt=media\&token=e2a33f01-de84-4aba-963a-cf17da125e4d) #### 2.3.移除关联 Jenkins 如果不想在当前团队展示某个 Jenkins 的流水线，你可以点击「移除关联」按钮。移除 Jenkins 后，你将获取不到当前 Jenkins 的数据，已同步的流水线数据也将清空。 ![](https://2389253470-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LwaVKDFhf_vIPo5hDmS%2F-MF5fBFggInckfb6Orfn%2F-MF5gJY3Gd6jLLfDxqE5%2Fimage.png?alt=media\&token=98bde2b1-401f-4fc1-bce9-29371fb9bfe0) ### 3.查看流水线 Pipeline 的流水线列表将显示不同来源的流水线，你可以根据“Jenkins URL”字段区分。 ![](https://2389253470-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LwaVKDFhf_vIPo5hDmS%2F-MBdKnb_v8SCop9cNr2L%2F-MBdVJ_DZnDddBv2hIEl%2Fimage.png?alt=media\&token=d0e966ab-3329-4934-8645-7c7ce0917630) 如果流水线是多分支类型，你可以根据“多分支”标签区分。系统通过父子结构展示多分支及其分支流水线。你可以通过点击“展开”查看多分支下的分支流水线。其中，分支流水线按“最近运行时间”降序排序，方便你查看最近在用的分支流水线。 ![](https://2389253470-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LwaVKDFhf_vIPo5hDmS%2F-MEuTP6mOS7UmeetncIX%2F-MEv3QjXqaU_LB_udmHz%2Fimage.png?alt=media\&token=115dc7ab-c21f-4193-b995-0d6bcb938cf1) 在 Pipeline 首页点击流水线名称，可以查看流水线的运行历史。在 Pipeline 首页点击最近运行的 ID、或者在运行历史页点击每行运行历史记录，可以查看流水线的运行详情。‌ ![](https://gblobscdn.gitbook.com/assets%2F-LwaVKDFhf_vIPo5hDmS%2F-M7DBD8klrJYV6mD-OIW%2F-M7DCNghlcLD2kuGONGK%2Fimage.png?alt=media\&token=c8bb3f52-d8c7-428d-ab7d-d9031d9639c0) ### 4.删除流水线 在流水线的更多页面里，可以删除流水线。删除流水线后，将同步删除持续集成服务器上的流水线。‌此外，如果你删除的是多分支流水线，其分支流水线也会被删除且不可恢复，请谨慎操作。 ![](https://gblobscdn.gitbook.com/assets%2F-LwaVKDFhf_vIPo5hDmS%2F-M7DBD8klrJYV6mD-OIW%2F-M7DCpqVmBr43Ps4L4Ol%2Fimage.png?alt=media\&token=69b5b89c-739f-4c56-a62a-d2f4779e04ea) ### 5.流水线关联业务对象 #### 5.1 项目关联流水线 项目支持「流水线」组件。你可以进入项目设置的项目组件页面中添加。 ![](https://2389253470-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LwaVKDFhf_vIPo5hDmS%2F-MCGpAZFU1f0UnHbeZvZ%2F-MCGtEp6S4T-DvytA_HT%2Fimage.png?alt=media\&token=4a7d90d3-f5ae-4b5a-ad60-feb2b4d91d8e) 具备项目管理员权限的用户，可以执行「关联已有流水线」的操作。此外，用户需要具备流水线的查看权限，才能看到或选到流水线。如果无相关流水线的权限，请联系流水线管理员添加。 ![](https://gblobscdn.gitbook.com/assets%2F-LwaVKDFhf_vIPo5hDmS%2F-M7DBD8klrJYV6mD-OIW%2F-M7DDMiVkX3HgX56ap8Y%2Fimage.png?alt=media\&token=d53450ba-6f94-4402-bd22-dae6224293c1) 如果你关联的是多分支流水线，其分支流水线会被自动关联到项目中。项目关联流水线后，我们就可以在项目中跟进相关的流水线运行情况。 ![](https://2389253470-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LwaVKDFhf_vIPo5hDmS%2F-MF5fBFggInckfb6Orfn%2F-MF5gYIm3imP29y-trEH%2Fimage.png?alt=media\&token=453c0edc-40cd-45d9-b0e9-fa5d85822610) #### ‌5.2 迭代关联流水线运行 迭代支持「流水线运行」功能，用于展示迭代关联的流水线运行数据，你可以在此功能中追踪和分析流水线运行情况。 通常的协作流程为： 1、项目管理员需提前为项目关联流水线（在「流水线」组件 > 关联已有流水线）; 2、迭代管理员需咨询技术人员配置“迭代关联流水线运行的规则” ； * *系统支持通过脚本的方式批量将「当前项目的迭代」和「项目已关联流水线」的运行情况关联起来，请根据团队需要调整。* * *默认规则「string.len(branch) > 0 and string.find(sprint\_name, branch, 1, true)」表示：如果流水线运行时的分支名称 包含迭代的数据，则建立关联关系。* 3、迭代管理员根据配置的“迭代关联流水线运行的规则”，修改迭代名称。 * *你需要在迭代名称中加入流水线运行的“分支名称”或“代码仓名称”；* * *以使用默认规则为例，如果期望在迭代中关联和 F2003分支 相关的流水线运行，则可以把迭代名称改成“F2003-XXX”* 4、迭代成员进入「流水线运行」功能后，可以查看和迭代相关的流水线运行记录。 ![](https://2389253470-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LwaVKDFhf_vIPo5hDmS%2F-M9b-PGHrZ5u6DfcBES_%2F-M9b-rHuZei3OSyK2JCq%2Fimage.png?alt=media\&token=211088ce-3f6a-408d-b197-6cf362307ddd) ![](https://2389253470-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LwaVKDFhf_vIPo5hDmS%2F-MCGw6Pm1b3F97klFq6Y%2F-MCGymCQRcuScpak3cOR%2Fimage.png?alt=media\&token=8b61a33f-80d4-43a0-8a66-683cc78b6bf0) ###