Runner registrieren
In diesem Artikel erfahren Sie, wie Sie einen bestehenden GitLab Runner in einer GitLab-Instanz registrieren können.
Voraussetzungen:
- URL zur GitLab-Instanz
- GitLab Runner Token
- SSH-Zugang zum GitLab Runner
Executor-Modus Shell
Melden Sie sich per SSH auf dem zugehörigen GitLab Runner an und führen Sie einen der folgenden Befehle aus.
sudo gitlab-runner register --non-interactive \
--url https://<GitLab-Domain> \
--registration-token <Registration token aus GitLab> \
--executor shell \
-c /etc/gitlab-runner/config.toml
Ersetzen Sie den Parameter <GitLab-Domain>
durch die URL Ihrer GitLab-Instanz.
Bitte achten Sie darauf, dass Sie die gitlab-runner
Befehle mit dem Prefix sudo
ausführen, damit der GitLab Runner im System-Mode arbeitet. Andernfalls kann der Runner nicht im Hintergrund ausgeführt werden.
Executor-Modus Docker
sudo gitlab-runner register --non-interactive \
--url https://<GitLab-Domain> \
--registration-token <Registration token aus GitLab> \
--executor docker \
--docker-image "docker:20.10.16" \
--docker-volumes "/certs/client" \
-c /etc/gitlab-runner/config.toml
Ersetzen Sie den Parameter <GitLab-Domain>
durch die URL Ihrer GitLab-Instanz.
Dieser Befehl beinhaltet --docker-privileged
, wodurch die Sicherheitsmechanismen des Containers deaktiviert werden und die Privileg-Eskalation auf dem Host ermöglicht. Diese Aktion kann zum Ausbruch aus dem Container führen.
Bitte achten Sie darauf, dass Sie die gitlab-runner
Befehle mit dem Prefix sudo
ausführen, damit der GitLab Runner im System-Mode arbeitet. Andernfalls kann der Runner nicht im Hintergrund ausgeführt werden.
Executor-Modus Docker in Docker
sudo gitlab-runner register --non-interactive \
--url https://<GitLab-Domain> \
--registration-token <Registration token aus GitLab> \
--executor docker \
--docker-image "docker:20.10.16" \
--docker-privileged \
--docker-volumes "/certs/client" \
-c /etc/gitlab-runner/config.toml
Ersetzen Sie den Parameter <GitLab-Domain>
durch die URL Ihrer GitLab-Instanz.
Dieser Befehl beinhaltet --docker-privileged
, wodurch die Sicherheitsmechanismen des Containers deaktiviert werden und die Privileg-Eskalation auf dem Host ermöglicht. Diese Aktion kann zum Ausbruch aus dem Container führen.
Registrierungsstatus überprüfen
Nach einer erfolgreichen Registrierung wird der GitLab Runner in GitLab in der Übersicht der GitLab Runner als Online angezeigt.