Compass Connector

Link jobs to Compass Components to share build and deployment events with Compass.

1. Integrate Jenkins with Jira using this Jenkins Integration for Jira app,
2. Install the Jenkins for Compass app,
3. Link Jobs to Components, with suggestions based on the build-issue index.

Configuration

In order to integrate Jenkins with Compass, you will first need to have the Jenkins Integration for Jira app, installed and configured with at minimum one Jenkins site, see the Getting Started guide for details. After this you can install the Jenkins for Compass app.

The Compass app will automatically register with the Jira app to enable the integration.

Manage the Connector

If you want to rest the connector token, this is the authentication token used by the Jira app when making calls to Compass app, you can do this by going to the administration page of the Compass app Apps > Manage your apps scroll to locate the Jenkins for Compass app, and click on the Configure button.

On this page you can, depending on the state of the connector, either:

1. Initiate a call to set up the connector. This can be used to resolve connection issues in case the automated registration didn’t complete successfully.
2. Initiate a call to reset the authentication token of the connector.

Linking Jobs to Components

To link a component in Compass to a job from Jenkins, simply navigate to your component and go to the Jenkins page, the link is on the left menu under Apps.

On this page you can manage all the Jenkins job connections with the component.

To link a specific job, or a job that is not listed as a suggestion, simply click on the + button to open a dialog to search for the job you want to add. Removing a job from a component can be done just as easily by clicking the trashcan button next to the job you want to remove.

As soon as a link is created between a component and a job, all the event related to that job will be forwarded to Compass. This includes back filling historic events as well as any new events related to the job.