Logo

Anleitung zur Nutzung von Runnern auf git.nrw

Zuletzt aktualisiert: 19.02.2026 2 Min. Auf GitLab bearbeiten
Auf dieser Seite
Zusammenfassung

GitLab Runner auf git.nrw führen Ihre CI/CD-Pipelines aus und bauen, testen und deployen Ihre Projekte automatisch bei jedem Commit oder Merge. Bitte registrieren und nutzen Sie nach Möglichkeit Gruppen-/Projektrunner, da die Anzahl der Instanzrunner sehr begrenzt ist und diese nur zu Testzwecken verwendet werden sollten.

Runner sind die Agenten, die die GitLab Runner -Anwendung ausführen, um GitLab-CI/CD-Jobs in einer Pipeline zu verarbeiten. Sie sind dafür verantwortlich, Ihre Builds, Tests, Deployments und andere CI/CD-Aufgaben auszuführen, die in .gitlab-ci.yml-Dateien definiert sind. Vereinfacht ausgedrückt: Ihre Pipelines übergeben Ihren Code an einen verfügbaren Runner, der Ihren Code an einen vordefinierten Executor weitergibt, welcher ihn in einer vordefinierten Umgebung ausführt.

Es gibt zwei verschiedene Kategorien von Runnern:

  • Gruppen-/Projektrunner: einem bestimmten Projekt oder einer Gruppe zugeordnet, selbst verwaltet, nutzen die Ressourcen der Maschine, auf der die Runner verwaltet werden
  • Instanzrunner: von der GitLab-Instanz (git.nrw) gehostet, nutzen die Ressourcen der Server, auf denen die Git-Instanz betrieben wird

Auch wenn es einfacher sein mag, die von git.nrw verwalteten Runner zu nutzen, empfehlen wir dringend, stattdessen selbst verwaltete Runner zu verwenden. Die Anzahl der Instanzrunner ist sehr begrenzt, um die Serverlast nicht unnötig zu erhöhen, was zu langen Warteschlangen und noch längeren Verzögerungen führen kann, bis Ihre Jobs und Pipelines ausgeführt werden.

GitLab Runner installieren

Runner verarbeiten Jobs normalerweise auf derselben Maschine, auf der Sie GitLab Runner installiert haben. Sie können jedoch auch einen Runner Jobs in einem Container, in einem Kubernetes-Cluster oder in automatisch skalierten Instanzen in der Cloud verarbeiten lassen.

Sie können GitLab Runner installieren auf:

Bleeding-Edge-Binaries sind ebenfalls verfügbar.

Sie können GitLab Runner mit folgenden Containern installieren:

Registrierung eines Projekt-/Gruppenrunners

Nach der Installation von GitLab Runner finden Sie den Runner-Authentifizierungstoken in der config.toml-Datei. Runner-Authentifizierungstoken haben das Präfix glrt-.

Je nach verwendetem Betriebssystem/Container folgen Sie bitte den Anweisungen in der GitLab-Dokumentation zur Registrierung Ihres Runners .

Während und nach der Registrierung gibt es einige Optionen zur Charakterisierung des erstellten Runners:

  • Executors — Bei der Registrierung eines Runners müssen Sie einen Executor wählen. Ein Executor bestimmt die Umgebung, in der jeder Job ausgeführt wird.
  • Tags — Wenn ein CI/CD-Job ausgeführt wird, weiß er anhand der zugewiesenen Tags, welchen Runner er verwenden soll. Tags sind die einzige Möglichkeit, die Liste der verfügbaren Runner für einen Job zu filtern.
  • Konfiguration — Konfigurieren Sie einen bestimmten oder alle Runner durch Bearbeitung der config.toml-Datei.

Für weitere Informationen oder Fehlerbehebung besuchen Sie bitte die offizielle GitLab-Dokumentation zu Runnern .