Update the Private Action Runner

This product is not supported for your selected Datadog site. ().
Cette page n'est pas encore disponible en français, sa traduction est en cours.
Si vous avez des questions ou des retours sur notre projet de traduction actuel, n'hésitez pas à nous contacter.

Overview

This page explains how to update the private action runner (PAR). You can update the PAR using Docker, Docker Compose, or Helm.

Currently, the PAR is on v1.9.0.

Docker mode

Navigate to the directory where you started the PAR. Next, navigate to the config directory, then the config.yaml file.

Find the current ID of your container:

docker ps

Stop the container:

docker stop <id>

Start a new container with the latest image. Environment variables are not needed. Everything is configured in the config/config.yaml file.

Run:

docker run -d \
 --cpus="0.25" \
 --memory="1g"  \
 -e DD_PRIVATE_RUNNER_CONFIG_DIR=/etc/dd-action-runner/config 
 -v ./config:/etc/dd-action-runner/config \
 --health-cmd "curl http://localhost:9016/liveness" \
 --health-interval 10s \
 --health-timeout 10s \
 --health-retries 3 gcr.io/datadoghq/private-action-runner:v1.9.0

After confirming the new PAR version is working as expected, remove the old version:

docker rm <id>

To check the PAR logs:

docker logs <id-of-container>

Docker Compose mode

Navigate to the directory containing your docker-compose.yaml file.

services:
  private-actions-runner:
    image: gcr.io/datadoghq/private-action-runner:<latest_version>
    cpus: 25
    mem_limit: 1g
    deploy:
      replicas: 1
    environment:
      - DD_BASE_URL=https://app.datadoghq.com
      - DD_PRIVATE_RUNNER_CONFIG_DIR=/etc/dd-action-runner/config 
      - RUNNER_ENROLLMENT_TOKEN=<the_token>
      - STATSD_ENABLED=true
    volumes:
      - "./config:/etc/dd-action-runner/config"

Start the container again:
```bash
docker compose up -d

To check the logs:

docker compose logs runner

Helm mode

When using Helm, there are two options for upgrading the PAR:

  1. (Recommended) Upgrade the chart, which uses the latest version of the PAR. There may be changes to the chart; please review the changelog.
  2. Upgrade the runner without upgrading the chart.

Navigate to the directory containing your values.yaml file and run:

helm repo update
helm upgrade <RELEASE_NAME> datadog/private-action-runner -f ./values.yaml

Upgrading the PAR only

Specify the PAR version in your values.yaml under the common.image.tag key with the values found here:

common:
  image:
    repository: gcr.io/datadoghq/private-action-runner # optional
    # latest image https://api.datadoghq.com/api/v2/on-prem-management-service/runner/latest-image
    tag: v1.0.0

Then run:

helm upgrade <RELEASE_NAME> datadog/private-action-runner -f ./values.yaml

To check the logs:

kubectl get pods
kubectl logs <name-of-the-pod>