本文档演示如何在 KubeSphere 企业版上使用流水线模板创建流水线。

DevOps 提供图形编辑面板,支持通过交互式操作来定义 Jenkins 流水线的阶段和步骤。内置多个流水线模板,如 Node.js、Maven 以及 Golang,使用户能够快速创建对应模板的流水线。DevOps 还提供 CI 以及 CI & CD 流水线模板,但是这两个模板难以满足定制化需求,建议您采用其它内置模板或直接自定义流水线。

  • CI 流水线模板

    CI 流水线模板包含两个阶段。clone code 阶段用于检出代码,build & push 阶段用于构建镜像并将镜像推送至 Docker Hub。先为代码仓库和 Docker Hub 仓库创建凭证,然后在相应的步骤中设置仓库的 URL 以及凭证。完成编辑后,流水线即可开始运行。

  • CI & CD 流水线模板

    CI & CD 流水线模板包含六个阶段。有关每个阶段的更多信息,请参阅使用 Jenkinsfile 创建流水线。先为代码仓库、Docker Hub 仓库创建凭证,然后在相应的步骤中设置仓库的 URL 以及凭证。完成编辑后,流水线即可开始运行。

前提条件

  • KubeSphere 企业版平台需要安装并启用 DevOps 扩展组件。

  • 已创建一个企业空间、一个 DevOps 项目和一个用户 (例如 project-regular),并已邀请该用户至 DevOps 项目且授予 operator 角色。请参阅角色和成员管理

操作步骤

下面以 Node.js 为例演示如何使用内置流水线模板。使用 Maven 以及 Golang 流水线模板的操作基本相同。

  1. project-regular 用户登录 KubeSphere 企业版 Web 控制台。

  2. 点击企业空间管理并进入您的 DevOps 项目,在流水线页面点击创建

  3. 在弹出的对话框中,输入流水线名称,点击下一步,然后点击创建

  4. 点击已创建的流水线,在流水线配置页签下,点击编辑流水线

  5. 创建流水线对话框,点击 Node.js,然后点击下一步

  6. 参数设置页签,按照实际情况设置以下参数,点击创建

    参数 描述

    GitURL

    需要克隆的项目仓库的地址。

    GitRevision

    需要检出的分支。

    NodeDockerImage

    Node.js 的 Docker 镜像版本。

    InstallScript

    安装依赖项的 Shell 脚本。

    TestScript

    项目测试的 Shell 脚本。

    BuildScript

    构建项目的 Sell 脚本。

    ArtifactsPath

    制品文件所在的路径。

  7. 在左侧的可视化编辑页面,系统默认已添加一系列步骤,点击添加步骤添加并行阶段进行修改。

  8. 点击一个步骤,在页面右侧,您可以执行以下操作。编辑完成后,点击确定

    • 修改阶段名称。

    • 删除阶段。

    • 设置代理类型。

    • 添加条件。

    • 编辑或删除某一任务。

    • 添加步骤或嵌套步骤。

    说明

    请参阅使用图形编辑面板创建流水线,了解如何在流水线模板中自定义步骤和阶段。

  9. 在右侧的代理区域,选择代理类型,默认值为 kubernetes,点击确定

    代理类型 说明

    any

    调用默认的 base pod 模板创建 Jenkins agent 运行流水线。

    node

    调用指定类型的 pod 模板创建 Jenkins agent 运行流水线,可配置的 label 标签为 base、java、nodejs、maven、go 等。

    kubernetes

    通过 yaml 文件定义的标准 kubernetes pod 模板运行 agent,执行流水线任务。

  10. 查看已创建的流水线模板详情,点击运行即可运行该流水线。