An integration in a CloudBees platform organization provides a standard interface that connects two or more systems. You can use integrations to facilitate communication and data exchange between different applications, resources, or services.
The following types of integrations are available:
-
Bitbucket Access Token
-
GitHub App
-
GitHub Access Token
-
Jira
Access an integration
Access the integrations which are key to connecting your repositories and project issues.
To access an integration:
-
Select the next to Configurations on the left pane, and then select Integrations.
-
(Optional) Search for a specific integration, by entering all or part of an integration name into Search.
-
(Optional) Select an option in Sort by to sort the integration list by either ASCENDING or DESCENDING alphanumerical sort order.
The integrations are displayed according to your search or sort criteria.
Create an integration
Create an integration to connect your repository or Jira project.
| The CloudBees platform redirects you briefly to the external provider in order to set up or test the integration. |
To create an integration:
-
Select the next to Configurations on the left pane, and then select Integrations.
-
Select CREATE INTEGRATION.
-
Select an integration category from the options, or enter all or part of a category name to Search.
-
Enter the connector details:
-
Enter the Name.
-
(Optional) Enter a Description.
-
Enter any other required information (marked with an ).
-
(Optional) Test by selecting TEST INTEGRATION (not available for all integration types).
Figure 1. Creating a Bitbucket integration, with TEST INTEGRATION highlighted.
-
-
Select SUBMIT.
Your integration is created, and listed in Integrations.
Update an integration
From your CloudBees integration list, make updates to any integrations.
To update an integration:
-
Select the next to Configurations on the left pane, and then select Integrations.
-
Select the next to the integration you want to update.
-
Select Edit integration.
-
Make any desired changes.
-
(Optional) Select TEST INTEGRATION.
-
Select SAVE.
Your integration is updated accordingly.
Delete an integration
Delete any of your integrations. A deleted integration is completely removed from the CloudBees platform, and deletion is irreversible.
To delete an integration:
-
Select the next to Configurations on the left pane, and then select Integrations.
-
Select the next to the integration you want to delete.
-
Select Delete integration.
-
Select DELETE.
Your integration is deleted, and removed from your integration list.