Gitlab Runner¶

Set up a runner on your machine¶

The following lines are valid for a machine that runs Debian (trixie).

Your gitlab-repository needs access to your machine via tcp/443, that is your firewalls shall be configured accordingly.

If you contribute directly to the root MTPPy2.0 repository, no action is needed - the runner is ready to go.

Step 1: prepare your package manager and install¶

Load the script that configures your package manager, i.e. makes the repository for the gitlab-runner known, then install as usual.

curl -L "https://packages.gitlab.com/install/repositories/runner/gitlab-runner/script.deb.sh" -o script.deb.sh
sudo bash script.deb.sh
sudo apt install gitlab-runner

Step 2: become gitlab-runner and install uv in¶

At the time of writing, the only prerequisite to the runner is a installed and findable uvexecutable. Everything else is loaded on demand (and cached) by the pipeline definition file .gitlab-ci.yml

sudo su gitlab-runner
curl -LsSf https://astral.sh/uv/install.sh | sh

Step 3: create runner in the gitlab Web-GUI¶

Menu can be found under Settings/CI.CD/Runners/Create project runner

Step 4: register your runner¶

Copy the full cmd-line including the token from the gitlab Web-GUI and execute on your machine:

sudo gitlab-runner register  --url https://gitlab.hrz.tu-chemnitz.de  --token glrt-....