Runner erstellen
In diesem Artikel erfahren Sie, wie Sie in dem GitLab Webinterface einen neuen GitLab Runner erzeugen können.
Voraussetzungen:
- GitLab Instanz
- GitLab Runner
- SSH-Zugang zum GitLab Runner
- Administrator-Zugang für das GitLab Webinterface
GitLab Runner in GitLab konfigurieren
Um einen GitLab-Runner in GitLab zu registrieren, melden Sie sich zunächst im Webinterface der betreffenden GitLab Instanz an und navigieren Sie anschließend in die Admin Area.
Navigieren Sie im Anschluss über CI/CD → Runners zur Übersicht der GitLab Runner und klicken Sie auf die Schaltfläche New instance runner.
Wählen Sie im folgenden Formular das Operating System Linux aus.
Optional vergeben Sie eine Beschreibung für den Runner im Feld Runner description, damit Runner später besser identifiziert werden können.
Wenn der GitLab Runner auch für Jobs ohne Tags verwendet werden soll, wählen Sie die Checkbox Run untagged jobs aus.
Wenn die Konfiguration Ihren Wünschen entspricht, schließen Sie mit der Schaltfläche Create runner die Konfiguration ab.
Nach dem Erstellen werden Ihnen die benötigten Informationen zum Registrieren des Runners angezeigt. Im folgenden Schritt benötigen Sie die Angaben aus Step 1.
GitLab Runner in GitLab registrieren
Melden Sie sich per SSH auf dem GitLab-Runner-Server an und führen Sie den gitlab-runner-Befehl aus, der im GitLab-Webinterface als Step 1 angezeigt wurde.
Soll der GitLab Runner als Docker in Docker Runner registriert werden, modifizieren Sie den Befehl aus Step 1 wie folgt:
gitlab-runner register -n \
--url https://<GitLab-Domain> \
--registration-token <Registration token aus GitLab> \
--executor docker \
--docker-image "docker:20.10.16" \
--docker-privileged \
--docker-volumes "/certs/client"
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.
Nach einer erfolgreichen Registrierung wird der GitLab Runner in GitLab in der Übersicht der GitLab Runner als Online angezeigt.