Jenkins

Jenkins is the leading open source automation server. It provides hundreds of plugins to support building, deploying and automating any project.

Summary - Creating a Jenkins Credential

1. Create an API token. Copy the token to a secure location.

2. Go to configure8 app -> Settings -> Credentials -> Add Credential and select Jenkins credential provider.

3. Set up name for the Credential and fill info based on this.

4. Hit Save. The credentials will be checked and a discovery job will start. Done!

You can see Jenkins information directly inside any configure8 service detail page. Follow the instructions below to create a Jenkins credential and configure the Jenkins plugin on your service pages.

Prerequisite

In order to get started connecting Jenkins to configure8, you'll need the following information:

• Your Jenkins username

• A user API token

• The host URL of your Jenkins instance

To create a user API token

1. Go to your Jenkins instance and login with the appropriate user

2. Open the user profile page

3. Click on Configure to open the user configuration page:

   1. If you already have an API Token: click on Show API Token

   2. If you want to update an existing API Token: click on Change API Token

   3. If you want to create a new API Token: click on Add new Token

Create a New Jenkins Credential

1. Navigate to the Credentials page

2. Click Add Credential

3. Select Jenkins from the drop-down list

4. Enter a friendly name for the credential along with your Jenkins user name, API token, and Jenkins URL you gathered above.

Make sure your firewall rules will allow the configure8 app to access your Jenkins URL from outside your organization. configure8 can connect to domain based URLs (e.g. https://gitlab.mycompany.com) but not IP addresses (e.g. https://255.255.255.255) for security reasons.

IP's used by configure8 are:

3.134.237.30

18.190.3.63

3.131.181.75

Adding a Jenkins Plug-in to your Services

To add a Jenkins plug-in to your service, start by selecting a service from your catalog Services listing.

From your service detail page, select the Add Plug-in button.

From the Plugins dialog, browse through the list of available plugins and select the Jenkins plug-in by clicking on the Add button.

In the configuration wizard, select the appropriate Jenkins credential and enter the following information:

• Plugin Title: the title of the plug-in to display on the service overview page

Once you have entered all the required configuration information, select Done. Your Jenkins plug-in is added to your service overview page. You can now select the view you wish to be the default if desired.