Integrating third-party services

CloudBees SDM is a preview, with early access for select preview members. Product features and documentation are frequently updated. If you find an issue or have a suggestion, please contact CloudBees Support. Learn more about the preview program.

Integrations allow you to use information from external sources like GitHub and Jenkins. The more services that are integrated, the more complete the picture you can create.

Engineering Efficiency uses data from these third-party services to provide metrics and actionable insights. Some integrations are required to use the screens; others are optional. The table below details which integrations are required and optional using icons:

  • A required integration uses the check circle icon .

  • An optional integration uses the plus circle icon .

  • No impact from an integration uses the minus circle icon .

Table 1. Required and optional integrations for each screen
Screen Jira Cloud and Jira Server GitHub and GitHub Enterprise Jenkins

Investment area

Activity

CI/CD performance

Cycle time

Open pull requests

Requirements

You can integrate any third-party services with an available app for CloudBees SDM. Refer to Viewing a list of active integrations for instructions.

In general, for any app you wish to install, you need:

  • A CloudBees SDM account with an admin role.

  • An account with admin rights on the third-party service, for example, admin rights for a GitHub organization or admin rights on a Jira account.

Refer to Setting up integrations for instructions.

Viewing a list of active integrations

From the Integrations screen, you can see all of the external systems that are connected to CloudBees SDM.

To view a list of active integrations:

  1. Select User profile  Settings.

  2. Select Engineering Efficiency  Apps.

  3. Select an app to view more information about it.

Viewing connected GitHub repositories

All repositories that are available within CloudBees SDM are listed on Manage repositories. By default, they are sorted alphabetically by repository name. However, you can filter them by organization name instead.

Knowing the organization associated with the repository helps you to locate it.

When GitHub integration is configured, either all repositories from an organization are included or only selected repositories are included. If the repository you are looking for is not listed when linking a repository to a product, the CloudBees SDM app may be set to only import specific repositories.

To view connected GitHub repositories:

  1. Select User profile  Settings.

  2. Select Engineering Efficiency  Apps.

  3. Select GitHub.

  4. Select Configuration.

  5. Select the organization that contains the repository you want to find.

You should be able to locate the repository in the Repository name column. You can select the repository name to go to that repository in GitHub.

Viewing a list of connected Jenkins controllers

The Jenkins integration uses the connected Jenkins controllers.

To view a list of connected Jenkins controllers:

  1. Select User profile  Settings.

  2. Select Engineering Efficiency  Apps.

  3. Select Jenkins from the list of apps.

  4. Select the Configuration tab.