Gearset Integration with Jenkins

This guide outlines the steps to integrate Jenkins with Gearset for seamless deployment and automated testing.

Jenkins Setup

Step 1: Create a Jenkins Account

• Sign up for a Jenkins account by navigating to the Jenkins website and completing the registration process.

Step 2: Create a Jenkins Job

• From the Jenkins dashboard, click on New Item.

• Select Freestyle project, name the job, and click OK.

Step 3: Configure Jenkins Job to Execute Qualitia Test Cases

• In the job configuration, add build steps to trigger Qualitia test cases as per project requirements.

Step 4: Create a Personal Access Token (PAT)

How to Generate a Personal Access Token (PAT):

1. Log in to Jenkins

   • Access Jenkins by entering the Jenkins URL in your web browser.

2. Navigate to Manage Jenkins

   • From the Jenkins dashboard, click on Manage Jenkins in the left-hand sidebar.

3. Manage Users

   • Under the Security section, select Manage Users.

4. Select User Account

   • Choose the user account for which the PAT will be generated.

5. Add New Token

   • Scroll to the API Token section.

   • Click Add new Token.

6. Generate and Name the Token

   • Enter a token name (e.g., "My Jenkins PAT").

   • Click Generate.

7. Save the Token

   • Copy the token immediately after generation. The token will not be retrievable once you leave the page.

2. Gearset Setup

Step 1: Create a Gearset Account

• Sign up for a Gearset account via the Gearset website.

Step 2: Create a Team-Shared Deployment Job

• In Gearset, navigate to Deployment Jobs and create a new team-shared deployment job.

• Configure the job to include a custom webhook.

How to Add a Custom Webhook:

1. Choose Basic Authentication

   • Username: Jenkins username

   • Password: Jenkins PAT token (generated in previous steps)

2. Set the Request URL

   • Format the URL as:

     http://<Jenkins_URL>/job/<Job_Name>/build?token=<jenkins_token_name>
     

3. Save the Job

   • Click Save to finalize the configuration.