GitLab Runner: Erste Schritte

Verbinden Sie Ihren Stackhero GitLab Runner mit GitLab.com, Stackhero for GitLab oder Ihrem eigenen GitLab-Server und führen Sie Ihre erste Pipeline in wenigen Minuten aus

👋 Willkommen in der Stackhero-Dokumentation!

Stackhero bietet Ihnen eine unkomplizierte GitLab Runner Cloud-Lösung, mit der Sie Ihre GitLab CI/CD-Jobs effizient und ohne Aufwand ausführen können. Das erwartet Sie:

• Unbegrenzte CI/CD-Minuten: Führen Sie Ihre Pipelines so oft aus, wie Sie möchten – ohne Abrechnung pro Minute oder unerwartete Zusatzkosten.
• Mehrere gleichzeitige Jobs: Beschleunigen Sie Ihre Entwicklung, indem Sie mehrere Jobs parallel ausführen.
• Der Docker Executor mit Docker-in-Docker-Unterstützung: Erstellen und pushen Sie Container-Images ganz einfach als Teil Ihres CI/CD-Prozesses.
• Funktioniert nahtlos mit GitLab.com und self-managed GitLab-Instanzen.
• Eine private, dedizierte Infrastruktur mit schneller NVMe/SSD-Speicherung sorgt für stabile und vorhersehbare Build-Performance.
• Verfügbar in den Regionen 🇪🇺 Europa und 🇺🇸 USA, passend zu den Anforderungen Ihres Teams.

Sparen Sie Zeit: Sie können Ihren ersten GitLab Runner verbinden und bereits nach wenigen Minuten mit Ihren Pipelines starten!

Einführung

Ein GitLab Runner ist der Agent, der Ihre GitLab CI/CD-Jobs ausführt. Jedes Mal, wenn eine Pipeline läuft, nimmt der Runner jeden Job entgegen, führt ihn in einem isolierten Docker-Container aus und meldet die Ergebnisse zurück an GitLab.

Mit Stackhero läuft Ihr Runner immer auf einer privaten, dedizierten Infrastruktur. Es gibt keine Abrechnung pro Minute oder Nutzungslimits: Ihre CI/CD-Minuten sind unbegrenzt. Je nach gewähltem Tarif kann Ihr Runner mehrere Jobs gleichzeitig verarbeiten, sodass Sie Ihre Build-Kapazität einfach skalieren können.

Diese Anleitung hilft Ihnen, Ihren Stackhero Runner mit GitLab zu verbinden und Ihre erste Pipeline schnell zum Laufen zu bringen.

Schritt 1: Erstellen Sie Ihren GitLab Runner auf Stackhero

Über Ihr Stackhero Dashboard können Sie einen neuen GitLab Runner-Service anlegen und einen Tarif wählen, der zu Ihrem Workflow passt. Der Tarif legt fest, wie viel CPU, RAM und wie viele parallele Jobs (entsprechend der GitLab Runner-Einstellung concurrent: wie viele Jobs der Runner gleichzeitig verarbeiten kann) Ihnen zur Verfügung stehen.

Ihr Runner ist in etwa 2 Minuten einsatzbereit.

Schritt 2: Runner in GitLab erstellen

Ihr Runner verbindet sich mit GitLab über ein Runner Authentication Token. Dieses Token generieren Sie in GitLab und wählen dabei auch den Gültigkeitsbereich des Runners:

• Projekt-Runner: Öffnen Sie Ihr Projekt und gehen Sie zu Settings > CI/CD > Runners > New project runner.
• Gruppen-Runner: Öffnen Sie Ihre Gruppe und gehen Sie zu Settings > CI/CD > Runners > New group runner.
• Instanz-Runner (nur für selbstverwaltetes GitLab): Gehen Sie in den Admin area > CI/CD > Runners > New instance runner.

Beim Erstellen des Runners können Sie:

• Tags hinzufügen (wie docker oder stackhero), um gezielt Jobs an diesen Runner zu senden.
• Zulassen, dass der Runner untagged Jobs ausführt, falls Sie möchten, dass er alle Jobs verarbeitet, auch solche ohne Tags.

GitLab stellt Ihnen ein Runner Authentication Token zur Verfügung, das mit glrt- beginnt. Bewahren Sie dieses Token sicher auf, da Ihr Runner es zur Authentifizierung bei GitLab verwendet.

Der bisherige Ablauf mit dem registration token ist veraltet. Bitte verwenden Sie das Runner Authentication Token (glrt-...), das beim Hinzufügen des Runners erstellt wird, wie oben beschrieben.

Weitere Details finden Sie in der offiziellen GitLab Runner Registrierungsdokumentation.

Schritt 3: Runner verbinden

Gehen Sie zurück zu Ihrem Stackhero Dashboard, öffnen Sie die Konfiguration Ihres GitLab Runner-Services und tragen Sie folgende Informationen ein:

• GitLab URL: Verwenden Sie https://gitlab.com für GitLab.com oder die URL Ihrer selbstverwalteten GitLab-Instanz. (Wenn Sie GitLab auf Stackhero betreiben, könnte dies z. B. https://git.ihr-unternehmen.com sein.)
• Runner Authentication Token (glrt-...), das Sie in Schritt 2 erhalten haben.
• Anzahl der parallelen Jobs, die Sie zulassen möchten.

Nachdem Sie Ihre Konfiguration gespeichert haben, verbindet sich Ihr Runner mit GitLab und erscheint als online auf der Runners-Seite, auf der Sie ihn eingerichtet haben.

Schritt 4: Ihre erste Pipeline ausführen

Fügen Sie eine .gitlab-ci.yml-Datei im Root-Verzeichnis Ihres Repositories hinzu, um Ihre Pipeline zu definieren:

stages:
  - build
  - test

build:
  stage: build
  image: node:22
  script:
    - npm ci
    - npm run build

test:
  stage: test
  image: node:22
  script:
    - npm test

Committen und pushen Sie Ihre Änderungen. GitLab startet eine Pipeline und Ihr Stackhero Runner führt die Jobs aus. Wenn Sie beim Erstellen des Runners Tags hinzugefügt haben, können Sie diese in Ihren Jobs wie folgt ansprechen:

build:
  stage: build
  tags:
    - stackhero
  image: node:22
  script:
    - npm ci
    - npm run build

Ihre Pipelines laufen nun auf Ihrem dedizierten Runner – mit unbegrenzten Build-Minuten und ohne Nutzungslimits.

Nächster Schritt

Wenn Sie Docker-Images aus Ihren Pipelines bauen und pushen möchten, machen Sie weiter mit Docker-Images bauen.