Delegate Task Category Mapping
Harness deployments are broken down into separate tasks performed by Harness Delegates.
Tasks are organized by category. For example, all the connections and images pulled using Docker Hub are part of the Docker Hub Task Category.
By default, Harness performs tasks using any available Delegates. If you want Harness to prioritize a specific Delegate for a task category, you can map the task category to a Selector, and apply that Selector to a Delegate.
This topic describes how to map task categories to Selectors, and then apply the Selector to one or more Delegates.
In this topic:
- Before You Begin
- Supported Platforms and Technologies
- Visual Summary
- Step 1: Set Permissions
- Step 2: Map a Selector to a Task Category
- Review: Applying Selectors to Delegates and Profiles
- Review: Task Categories
Before You Begin
The Delegate is a key component of your Harness setup. Please review the following topics to ensure you have a solid understanding of the Delegate:
- Harness Key Concepts
- Harness Delegate Overview
- Select Delegates with Selectors
- Run Scripts on Delegates using Profiles
Supported Platforms and Technologies
Here is example of adding a new Selector to a Delegate, and then mapping the Selector to a Task Category:
Here is an example of adding a Selector to a Task Category Mapping, and then applying the Selector to a Delegate:
Step 1: Set Permissions
To map Selectors to Task Categories a user must belong to a User Group with the Account Permission Manage Delegates enabled.
Step 2: Map a Selector to a Task Category
- To map a Selector to a Task Category, in Setup, click Harness Delegates.
- Click Task Category Map.
- Click Map Task Category.
- In Task Category, select the category you want to map. See Review: Task Categories.
- Select or create selectors to map to this Task Category.
- You can simply enter the name of a new Selector and click Create.
- If you have an existing Selector, one that is perhaps already used by a Delegate or Delegate Profile, you can start entering its name and it will appear. Next, click its name to select it.You must select or create at least one Selector.
- Click Submit. The Task Category is now mapped to the Selector.
If this Selector is not being used by a Delegate or Profile, you can now add it to one or both.
Review: Applying Selectors to Delegates and Profiles
Once you have mapped a Selector to a Task Category, you can apply the Selector to a Delegate using the following options:
- Add the Selector to the Delegate's Custom Selectors setting.
- Add the Selector to a Delegate Profile, and then add the Profile to any Delegates. All the Delegates using that Profile are thereby mapped to the Task Category.
For steps on adding Custom Selectors, see Select Delegates with Selectors.
For steps on adding Profile Selectors, see the Selector option in Run Scripts on Delegates using Profiles.
Which option to use?
If your task requires a Delegate Profile, it is best to map the Task Category to a Selector and apply that Selector to the Profile. All Delegates assigned that Profile will then perform the mapped tasks.
If your task can only be performed by specific Delegates because of their location or credentials, it is best to map it to specific Delegate using a Delegate's Custom Selectors setting.
Review: Task Categories
The following table describes the different task categories.
Amazon Machine Image (AMI)
Perform tasks related to AMI Deployments.
Amazon Elastic Container Registry (ECR)
Connect and pull images from ECR.
Connect and pull artifacts and files from Amazon S3.
Perform AppDynamics verification tasks.
Connect using any Harness AWS Cloud Provider.
Delegate can perform any APM task
Connect to JFrog Artifactory using the Artifactory Artifact Server credentials.
Azure Container Registry
Connect and pull Azure Container Registry images and artifacts.
Perform Bamboo related tasks using the Bamboo Artifact Server credentials.
Perform tasks for any Build Workflow.
Perform CloudFormation tasks such as CloudFormation Create Stack and CloudFormation Delete Stack Workflow steps. See CloudFormation Provisioning with Harness.
Perform configuration and verification using AWS CloudWatch.
Connect and configure Harness Collaboration Providers.
Delegate will be used first for Service commands.
Tests connectivity with resources, such as Harness Cloud Providers.
Performs the following container-related tasks:
Custom Artifact Source
Collect artifacts using Custom Artifact Sources.
Custom Log Collection and Bugsnag
Perform configuration and verification using Dynatrace.
Connect to Docker Hub and pull down metadata associated with the artifact.
Perform configuration and verification using ELK.
Perform configuration and tasks Git Source Repo Providers.
Google Cloud Build
Perform Google Cloud Build related tasks.
Google Cloud Storage
Connect and pull artifacts from Google Cloud Storage.
Google Container Registry
Connect and pull artifacts from GCR.
Delegate can perform Native Helm deployment tasks.
Helm Repo Config Validation
Validate the Helm Repo connection.
Helm Values Fetch
Perform the HTTP step in a Workflow.
Validating target hosts availability. For example, see Select Nodes Workflow Step.
Connect and perform tasks for Jenkins.
Connect and perform tasks for Jira.
Key Management Service
Connect and perform tasks for Harness Secrets Managers.
Performs Kubernetes rollouts for Kubernetes deployments.
Connect to LDAP server and perform LDAP tasks.
Connect and perform Logz tasks.
Connect to Nexus and pull down metadata associated with the artifact.
Connect and perform New Relic tasks.
Connect and perform Prometheus tasks.
Connect and perform Pivotal (PCF) deployments.
Perform 24/7 Service Guard tasks.
Connect and perform ServiceNow tasks.
Delegate can perform SFTP (email server) tasks such as sending emails.
Connect and perform Splunk tasks.
Perform Shell Script step in a Workflow.
Shell Script Provision
Delegate can perform Shell Script Provisioner tasks.
Delegate can perform tasks related to sending Slack notifications.
Delegate can perform tasks related to SMB Artifact Servers.
Delegate can perform Terraform tasks.
Delegate can perform tasks related to Harness Triggers.
Artifact Collection In Pipeline
Delegate can perform the artifact collection step in a Pipeline.