Harness

Perform the following procedure to install the Harness Delegate, a service that runs locally and connects your resources (artifact servers, infrastructure, and collaboration and verification providers) with the Harness Manager.

To install the Harness Delegate:

1. To start using Harness, sign up.

2. Install the Harness Delegate according to these instructions.
   

   When you have downloaded, unzipped, and run the shell script, the Delegate is installed and should be listed on the Delegates page shortly.

   Important: Before creating the artifact, make sure all Delegates are running (if you installed more than one). If any Delegate is down, click Provision Again.

As an artifact server, you can use either Jenkins or Atlassian Bamboo. In this step, we will walk you through setting it up in Jenkins. You may also refer to the Harness documentation about adding an artifact server.

To add a Jenkins artifact server:

1. Click Setup > Connectors > Artifact Servers > Add Artifact Server.

2. In the Jenkins Artifacts dialog box, do the following:

   1. From the Type list, select Jenkins.
   2. In the Display Name field, provide a name for the artifact server. This is the name you will use to identify this connection when adding an artifact source to a Harness service. 
   3. In the Jenkins URL field, provide your Jenkins URL, for example HTTP://localhost:8080.
   4. Under Authentication Mechanism, select UserName/Password or Bearer Token (if available) and provide the credentials. 
   5. Under Usage Scope, do the following:
      • Under Applications, click the list and select the name of the application.
      • Under Environments, select the type of the environment.
   6. To test if the Jenkins server is reachable, click Test. If successful, a confirmation message appears.
   7. Click Submit.

This section guides you through adding a Jenkins build process to the workflow. You may also refer to the Harness documentation on configuring Jenkins.

To add Jenkins to the pipeline:

1. In the Prepare Steps section of the workflow, click Add Step and select Jenkins.

2. In the Jenkins Configuration dialog box, do the following:

   1. In the Jenkins server field, select the Jenkins server you added as a Harness artifact server in step 3 above.
   2. In the Job Name field, select the Jenkins job to build the artifact. The job parameters configured in the Jenkins job are loaded with their default values.
   3. (Optional) Change the parameter values as needed.

This step walks you through your first deployment.

To start deployment:

1. Click Continuous Deployment and select Start New Deployment.

2. In the Start New Deployment dialog box, to the following:

   1. Select the deployment type.
   2. From the Application list, select the application.
   3. From the Pipeline list, select the pipeline to which you added the Jenkins step.
   4. From the Build/Version list, select the relevant build version.

   5. Click Submit.
      

      You should see results of a successful completion. If the Jenkins job fails, the deployment is rolled back.

      The following image shows results of a successful completion.