Skip to main content

Install the Harness Shell Script Delegate

The Harness Delegate is a service you run in your deployment target environment, such as your local network, VPC, or cluster. The Delegate connects all of your artifact, infrastructure, collaboration, verification and other providers with the Harness Manager.

Most importantly, the Delegate performs all deployment operations.

There are several types of Delegates. This topic describes how to install the Shell Script Delegate.

In this topic:

Before You Begin

Visual Summary

The following diagram shows how the Delegate enables Harness to integrate with all of your deployment resources:

Review: Requirements

Step 1: Download the Delegate

  1. Sign into the Harness Manager.
  2. Click Setup., and then click Harness Delegates.
  3. In the Delegate tab, click Install Delegate.
  4. In Download Type, select Shell Script.
  5. In Name, enter a name for your Delegate.
  6. In Profile, select a Delegate Profile. See Run Scripts on the Delegate using Profiles.

A Delegate Profile is mandatory. The Primary Profile is the default and contains no script. You can add a script to it, or create and apply new Profiles for your Delegate.

  1. Click Download or Copy Download Link.
    If you clicked Download, copy the downloaded file to the host where you want to run the Delegate.
    If you clicked Copy Download Link, connect to the machine or VM instance where you want to run the Delegate, paste in the cURL command, and press Enter to download the Delegate.

Step 2: Run the Shell Script Delegate Script

  1. Ensure the host where you run the Delegate meets the Delegate Requirements and Limitations.
  2. On the host where you want to run the Delegate, unzip the file (tar -zxvf harness-delegate.tar.gz), open the harness-delegate folder (cd harness-delegate) and run the script ($ ./

If you see a ulimit warning, see WARNING: ulimit -n is too low (1024).

The Delegate will start and in a few moments you will see it listed in the Harness Delegates page.

The Harness Delegates page provides a list of installed Delegates. The information displayed includes:

  • Hostname.
  • IP Address.
  • Status.
  • Last heartbeat. This is the last time the Delegate communicated with the Harness Manager. The Delegate pings the Manager once per minute.
  • Available Versions
  • Selectors
  • Profiles
  • Scopes

See Also