CI tools integration

Connect the CloudBees platform to your CloudBees CI and Jenkins® instances, so the platform can then interact with the CI system to collect build execution details or to trigger jobs in the remote system.

Once you have created this integration, data is available in the CI insights for Jenkins dashboard.

To create a CI tool integration:

Select an organization, and then select Configurations Integrations.
Select Create integration.
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.
Enter a Name and an (optional) Description.

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.
  
  Figure 1. CloudBees integration plugins in Jenkins.

Go to Manage Jenkins System, and search for CloudBees Platform Insights.
Enter the authentication code from the CloudBees platform.

Figure 2. Platform authentication code for a Jenkins integration.

Figure 3. Pasted authentication code in Jenkins system configuration.
Save the Jenkins configuration.
Select Submit to save the integration in the platform.

The CI tools integration is connected and listed in Integrations.