A GitLab Runner running on Zerops, using the built-in zCLI binary for deployments directly from your CI/CD pipelines.
You can either click the deploy button to import the recipe directly, or manually copy the import yaml into the import dialog in the Zerops app.
- Ubuntu 24.04 base with GitLab Runner installed via official binary
- zCLI available out of the box for Zerops deployments from your pipelines
- Shell executor for full control over the build environment
- Fixed container count — runners shouldn't scale horizontally automatically (adjust as needed)
- Health check using
gitlab-runner status
Set the following environment variables in the import yaml before importing:
| Variable | Description |
|---|---|
GITLAB_URL |
URL of your GitLab instance (e.g. https://gitlab.com/) |
GITLAB_TOKEN |
Runner authentication token from GitLab |
If your GitLab instance uses an IP blocklist, create the project first, allow its IP address in your GitLab settings, then import the
zclirunnerservice.
To adjust capacity for production workloads, increase minContainers/maxContainers and allocate more CPU/RAM to the service.
- Add zerops.yml to the repository
- Install runner dependencies (
git,zip,gcc,bzr,make) inprepareCommands - Download and install the GitLab Runner binary in
prepareCommands - Register the runner automatically on startup via
initCommands - Configure a health check using
gitlab-runner status
Need help setting your project up? Join Zerops Discord community.