gitlab-runner-helper

Helper image for GitLab Runner, used to clone repositories and upload artifacts.

Download this Image

The image is available on cgr.dev:

docker pull cgr.dev/chainguard-private/gitlab-runner-helper:latest

Usage

Please refer to the following Helm chart documentation, for instructions on how to deploy GitLab in Kubernetes: see here.

The GitLab Helm chart, is composed of multiple sub-charts, one of which deploys GitLab Runner Helper.

Create the toml config for GitLab Runner Helper:

cat <<EOF > config.toml
[[runners]]
  [runners.kubernetes]
      helper_image = "cgr.dev/chainguard-private/gitlab-runner-helper:latest"
      image = "ubuntu:22.04" 
EOF

Below is an example of how to deploy the Helm chart, using the Chainguard image for GitLab Runner Helper. Note, it is not intended to be a replacement for the official documentation:

helm repo add gitlab https://charts.gitlab.io/
helm repo update
helm upgrade --install gitlab gitlab/gitlab \
  --timeout 600s \
  --set gitlab-runner.runners.config="$(cat ./config.toml)"

GitLab Runner Helper can also be installed via means of a Helm chart if there is a core GitLab deployment in place. For more information, refer here

helm repo add gitlab https://charts.gitlab.io
helm search repo -l gitlab/gitlab-runner
helm install gitlab-runner gitlab/gitlab-runner \
    --set gitlabUrl=<Gitlab Url> \
    --set runnerRegistrationToken=<registration token>