配置 Jenkins

DevOps Insights 该服务将于 2026 年 8 月 31 日停止提供并终止。Continuous Delivery 将于 2027 年 2 月 12 日在以下区域停止提供：au-syd、ca-tor、us-east。 Code Risk Analyzer 也将于该日期在所有地区停止提供服务。 如果某个区域未实际使用这些功能，该区域内的相关功能可能会提前停用，并停止接受新实例。 了解更多

Jenkins 是基于服务器的开放式源代码工具，其可持续构建并测试软件，支持持续集成和持续交付的实践。

创建 Jenkins 工具集成之前，您必须具有 Jenkins 服务器。

使用 Jenkins 工具集成，您可以将 Jenkins 作业通知发送到工具链中的其他工具，如 Slack 和 PagerDuty。 要跟踪部署中的代码，可以向 Git 提交及相关的 Git 或 JIRA 问题添加部署消息。 您还可以在“工具链连接”页面上查看您的部署。 您可以将测试结果提供给 DevOps Insights、添加自动化质量检测点并跟踪您的部署风险。

配置 Jenkins 以自动持续构建、测试和部署应用程序：

  1. 如果您在创建工具链时配置此工具集成，请在“可配置的集成”部分中，单击 Jenkins。

  2. 若您已拥有工具链并需向其中添加此工具集成，请在控制 IBM Cloud 台中点击菜单图标 （汉堡图标 ）> 平台自动化 > 工具链。 在“工具链”页面上，单击某个工具链以打开其“概述”页面。

    a. 单击 “添加工具”。

    b. 在“工具集成”部分中，单击 Jenkins。

  3. 在工具链的 Jenkins 卡上，输入您要针对此工具集成显示的名称。

  4. 输入在您单击工具链中 Jenkins 卡时想要打开的 Jenkins 服务器的 URL。

  5. 复制生成的工具链 Webhook。

  6. 在 Jenkins 服务器中，完成以下步骤：

    a. 安装IBM Cloud DevOps插件。

    b. 配置 Jenkins 以通知工具链。

    c. 返回到“配置集成”页面，以进行 Jenkins 工具集成。

  7. 单击创建集成。

  8. 在“工具链的概述”页面上的 第三方工具 卡上，单击 Jenkins 以查看 Jenkins 服务器。

使用 API 配置 Jenkins

工具 Jenkins 集成支持以下配置参数，您可在 创建、读取和 更新工具集成时 通过工具链 HTTP API 和 SDK 使用这些参数。

必须在请求主体中使用 jenkins 值指定 tool_type_id 属性。

Jenkins工具集成参数
参数 用途 类型 Terraform 自变量 描述
API令牌 可选，可更新 密码 API令牌 用于 Jenkins REST API 调用的 API 令牌，以便 DevOps Insights 可以从 Jenkins收集数据。 您可以在 Jenkins 实例的“配置”页面上找到 API 令牌。 您可以将工具链私钥引用用于此参数。 有关私钥引用的更多信息，请参阅 在 Continuous Delivery中保护敏感数据。
API用户名 可选，可更新 字符串 API用户名 用于 Jenkins 服务器的 API 令牌的用户名，需要此用户名才能使 DevOps Insights 从 Jenkins收集数据。 您可以在 Jenkins 实例的“配置”页面上找到 API 用户名。
dashboard_url 必需，可更新 字符串 dashboard_url 此 JenkinsURL 工具集成的服务器仪表板的。 在图形化用户界面中，当您点击工具集成 Jenkins 卡片时，浏览器将跳转至此仪表板。
名称 必需，可更新 字符串 名称 此工具集成的名称。
webhook_url 可选，可更新 字符串 webhook_url 要在 Jenkins 作业中使用的 Webhook，用于向工具链中的其他工具发送通知。