IBM Cloud Docs
配置 Jenkins

配置 Jenkins

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