CI tools integration

2 minute read

Connect the CloudBees platform to your CloudBees CI and Jenkins® instances. Once you have created this integration, data is available in the CI insights for Jenkins dashboard.

To create a CI tool integration:

  1. Select an organization, and then select Configurations  Integrations.

  2. Select Create integration.

  3. Select CI tools, and then select one of the options.

    You can also create a CI tool integration at Jenkins management  Jenkins controllers. Select Create integration, and then select one of the options.

  4. Enter a Name and an (optional) Description.

  5. Configure as follows:

    • For CloudBees CI controllers and the operations center, the CloudBees Platform Insights Plugin requires CloudBees CI 2.440.3.7 or later.

    • For Jenkins® as a Service by CloudBees controllers, the CloudBees Platform Insights Plugin requires Jenkins as a Service by CloudBees version 2.440.3.7 or later.

    • For Jenkins, CloudBees Platform Insights Plugin requires Jenkins 2.414.3 or later.

    • For CloudBees CI controller and operations center:

      1. In Jenkins, go to Manage Jenkins  Plugins  Available Plugins.

      2. Search for CloudBees Platform Insights Plugin and then install it, restarting if necessary, to ensure that the plugin is updated to the most recent version.

    • For Jenkins as a Service by CloudBees:

      1. In Jenkins, go to Manage Jenkins  Plugins  Available Plugins.

      2. Search for CloudBees Platform Insights Plugin and then install it, restarting if necessary, to ensure that the plugin is updated to the most recent version.

    • For Jenkins:

      1. In Jenkins, go to Manage Jenkins  Plugins  Available Plugins.

      2. Search for CloudBees Installation Plugin and then install it.

      3. Search for CloudBees Platform Insights Plugin and then install it.

      4. Restart, if necessary, to ensure that the plugins are updated to the most recent version.

        Jenkins plugins
        Figure 1. CloudBees integration plugins in Jenkins.
  6. Go to Manage Jenkins  System, and search for CloudBees Platform Insights.

  7. Enter the authentication code from the CloudBees platform.

    {Authentication code
    Figure 2. Platform authentication code for a Jenkins integration.
    {Authentication code
    Figure 3. Pasted authentication code in Jenkins system configuration.
  8. Save the Jenkins configuration.

  9. Select Submit to save the integration in the platform.

The CI tools integration is connected and listed in Integrations.