Try It Out
In this example we will deploy GitLab Runner on a Kubernetes cluster using the Minimus GitLab Runner Helm chart. GitLab Runner will be configured to execute CI/CD jobs in your Kubernetes cluster.
Step 1: Start Cluster
If you have a cluster to work with, skip this step. Otherwise, start a Minikube cluster. Deployment instructions
Step 2: Create Namespace
Create a namespace:
kubectl create ns gitlab-runner
Step 3: Deploy the Helm Chart
Deploy the Minimus Helm chart:
helm install my-gitlab-runner oci://helm.mini.dev/gitlab-runner \
--version 0.90.1 \
--set gitlab-runner.gitlabUrl=https://gitlab.example.com \
--set gitlab-runner.runnerToken=YOUR_RUNNER_TOKEN \
-n gitlab-runner \
--wait
If you want to override the chart's defaults, go to the Values tab, save a copy locally with your changes. Deploy the chart with your overrides using -f values.yaml:
helm install my-gitlab-runner oci://helm.mini.dev/gitlab-runner \
--version 0.90.1 \
-f values.yaml \
--set gitlab-runner.gitlabUrl=https://gitlab.example.com \
--set gitlab-runner.runnerToken=YOUR_RUNNER_TOKEN \
-n gitlab-runner \
--wait
Step 4: Verify GitLab Runner is Running
Confirm the chart deployed successfully and GitLab Runner started:
kubectl get pods -n gitlab-runner -l app=gitlab-runner
You should see output similar to:
NAME READY STATUS RESTARTS AGE
my-gitlab-runner-xxxxxxxxx-xxxxx 1/1 Running 0 2m
Step 5: Test Runner Connection
Check the runner logs to verify it has started and is attempting to connect to your GitLab instance:
kubectl logs -n gitlab-runner -l app=gitlab-runner --tail=20
You should see logs indicating the runner has loaded its configuration and is checking for jobs. Navigate to your GitLab instance under Settings > CI/CD > Runners to verify the runner appears as registered and active.
Step 6: Clean Up
Uninstall the chart and delete the namespace to remove all resources:
helm uninstall my-gitlab-runner -n gitlab-runner
kubectl delete namespace gitlab-runner
Terms & Info
Trademark
This catalog is published by Minimus. All product names, logos, and marks, other than those belonging to Minimus, shown are owned by their respective rights holders and appear here only to identify the open source software each image contains. Minimus claims no ownership of those marks and implies no affiliation with, endorsement by, certification by, or sponsorship by any rights holder.
Disclaimer
Images are provided "as-is" without warranty of any kind. "Hardened" refers to the security configuration applied at the time of build and does not constitute a guarantee of ongoing security or absence of vulnerabilities. The free tier is provided without support, SLA, or guaranteed patching timelines. Security updates may be applied to paid subscriptions before or instead of free tier images. By pulling or using any image you agree to our Terms of Use.
gitlab-runner-helper 19.1.1