Install a delegate on Google Cloud Run

Important Note

Google Cloud Run automatically scales your service based on incoming traffic. While you can configure minimum and maximum replicas, actual scaling is managed by Google depending on load.

Each new revision receives 100% of traffic by default, causing older revisions to scale down.
You can split traffic between revisions using the Cloud Run UI.
To maintain multiple instances, set min and max replicas—but note that scaling still depends on real-time demand.

Harness Delegate is essential for connecting your infrastructure with the Harness platform, enabling seamless deployments. Harness Delegates typically run on VMs, Kubernetes clusters, or ECS Fargate, but Google Cloud Run presents a lightweight, cost-efficient, and scalable alternative.

This guide provides step-by-step instructions to configure a Harness Delegate on Google Cloud Run.

Prerequisites

Ensure you have an active Harness account with the necessary permissions.

A Google Cloud service account with appropriate IAM roles:

roles/run.admin # - Cloud Run Admin
roles/iam.serviceAccountUser # - Service Account User
roles/artifactregistry.reader # - For pulling images from GAR

Harness Delegate on Google Cloud Run

To configure a delegate on Google Cloud Run:

Login to Google Cloud Run, Select an existing project or create a new one as needed.
- Check for Deploy container → Service as shown below:
To create a service, follow these steps:

2.1. Add Container Image URL. You can select it from Artifact Registry or provide a Docker Hub Image URL.

2.2. To configure a service, enter a name, select a region, choose a billing method (request-based or instance-based), and set up scaling. You can configure Auto Scaling by setting the minimum number of instances based on your requirements or switch to Manual Scaling.

For now, we will opt for Manual Scaling and set the number of instances to 1.

2.3. Configure Ingress to control access to Cloud Run services. For now, select "All" to allow direct access from the internet.
To edit container configuration, click Container(s), Volumes, Networking, Security section to expand the options and set the following details accordingly.
- Container Port: 3460
- Settings → Container Name: Set an appropriate name (this will be used as the container image name).
- Resources → Memory: At least 2Gi, CPU: 1
Click Add Health Checks, then configure the Startup Probe and Liveness Probe as follows:
- Select Protocol: HTTP
- Set Path: /api/health
- Startup Probe: Set an initial delay of 120s
- Liveness Probe: Set an initial delay of 0s (all other settings remain the same as Startup probe) as shown in image below.
- Click Add to proceed.

To configure Environment Variables, scroll up and select Variables & Secrets next to Settings.

These environment variables are the same as those in the delegate installation step available in the Harness UI, as shown below.

Click New Delegate to access the installation steps as show below:

    docker run --cpus=1 --memory=2g \
    -e DELEGATE_NAME=docker-delegate-demo \
    -e NEXT_GEN="true" \
    -e DELEGATE_TYPE="DOCKER" \
    -e ACCOUNT_ID=gVcEXXXXXXXXA3JqA \
    -e DELEGATE_TOKEN=ZmY5MXXXXBlMTIwOXXXXXXXQ2Zjc1NjI4MDQ= \
    -e DELEGATE_TAGS="" \
    -e MANAGER_HOST_AND_PORT=https://app.harness.io/gratis 24.10.84107

Set the variables in Variables & Secrets by adding the following key-value pairs:

    DELEGATE_NAME="<your_delegate_name>"
    NEXT_GEN="true"
    DELEGATE_TYPE="DOCKER"
    ACCOUNT_ID="<your_account_id>"
    DELEGATE_TOKEN="<delegate_token_from_step1>"
    MANAGER_HOST_AND_PORT="<manager_host_and_port_from_step1>"

    # (Optional) Add delegate tags if needed
    DELEGATE_TAGS="tag1"

Click Create to complete the setup.
To confirm the delegate is created and running, check its status in the Harness UI on Delegate page as shown in image below.

Prerequisites​

Harness Delegate on Google Cloud Run​

Prerequisites

Harness Delegate on Google Cloud Run