GitLab Runner: Erste Schritte

Verbinden Sie Ihren Stackhero GitLab Runner mit GitLab.com oder einer selbstverwalteten GitLab-Instanz und führen Sie Ihre erste Pipeline aus

👋 Willkommen in der Stackhero-Dokumentation!

Stackhero bietet Ihnen eine benutzerfreundliche GitLab Runner Cloud-Lösung, die speziell dafür entwickelt wurde, Ihre GitLab CI/CD-Jobs effizient auszuführen. Das erwartet Sie:

Unbegrenzte CI/CD-Minuten: Es gibt keine Abrechnung pro Minute, sodass Ihre Pipelines jederzeit ausgeführt werden können.

Mehrere gleichzeitige Jobs: Führen Sie mehrere Jobs parallel aus, um Ihre gesamte Pipeline zu beschleunigen.

Der Docker Executor mit Docker-in-Docker-Unterstützung: Optimieren Sie das Erstellen und Pushen Ihrer Container-Images.

Kompatibel mit GitLab.com sowie jeder selbst gehosteten GitLab-Instanz.

Eine private, dedizierte VM mit schnellen NVMe/SSD-Festplatten für konsistente und zuverlässige Builds.

Verfügbar in den Regionen 🇪🇺 Europa und 🇺🇸 USA.

Sparen Sie Zeit: Sie können Ihren ersten GitLab Runner verbinden und Ihre Pipelines in nur wenigen Minuten starten!

Einführung

Ein GitLab Runner ist der Agent, der für die Ausführung Ihrer GitLab CI/CD-Jobs verantwortlich ist. Jedes Mal, wenn eine Pipeline ausgelöst wird, übernimmt der Runner jeden Job, führt ihn in einem sauberen Docker-Container aus und meldet anschließend die Ergebnisse an GitLab zurück.

Mit Stackhero läuft Ihr Runner auf einer privaten, dedizierten VM. Es gibt keine Abrechnung pro Minute oder Nutzungslimits, und Ihre CI/CD-Minuten sind unbegrenzt. Je nach gewähltem Tarif kann Ihr Runner Dutzende gleichzeitige Jobs parallel verarbeiten.

Diese Anleitung zeigt Ihnen, wie Sie Ihren Stackhero Runner in wenigen Minuten mit GitLab verbinden.

Schritt 1: Erstellen Sie Ihren GitLab Runner auf Stackhero

Über Ihr Stackhero Dashboard können Sie einen neuen GitLab Runner-Service anlegen und den Tarif wählen, der zu Ihren Anforderungen passt. Der Tarif bestimmt die verfügbare CPU-Leistung, den RAM und die Anzahl gleichzeitiger Jobs (dies entspricht der GitLab Runner-Einstellung concurrent, also der Anzahl der Jobs, die parallel ausgeführt werden können).

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, wobei Sie auch den Gültigkeitsbereich des Runners festlegen:

Project Runner: Öffnen Sie Ihr Projekt und gehen Sie zu Settings > CI/CD > Runners > New project runner.
Group Runner: Öffnen Sie Ihre Gruppe und gehen Sie zu Settings > CI/CD > Runners > New group runner.
Instance 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 diesen Runner gezielt aus Ihren Jobs anzusprechen.
Zulassen, dass er untagged Jobs ausführt, wenn Sie möchten, dass er alle Jobs übernimmt.

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 verwendet.

Der alte Ablauf mit dem registration token ist veraltet. Bitte verwenden Sie das Runner Authentication Token (glrt-...), das zusammen mit dem Runner erstellt wird, wie oben beschrieben.

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:

Ihre GitLab-URL: Verwenden Sie https://gitlab.com für GitLab.com oder die URL Ihrer selbstverwalteten GitLab-Instanz (zum Beispiel, wenn Sie GitLab auf Stackhero betreiben, könnte dies https://git.ihr-unternehmen.com sein).
Das Runner Authentication Token (glrt-...), das Sie in Schritt 2 erhalten haben.
Die Anzahl gleichzeitiger Jobs, die Sie zulassen möchten.

Nach dem Speichern Ihrer Konfiguration verbindet sich Ihr Runner automatisch mit GitLab und erscheint als online auf der Runners-Seite, auf der Sie ihn erstellt haben.

Schritt 4: Ihre erste Pipeline ausführen

Fügen Sie zu Beginn eine .gitlab-ci.yml-Datei im Root-Verzeichnis Ihres Repositories hinzu:

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. Falls Sie beim Erstellen des Runners Tags vergeben haben, können Sie diese in Ihren Jobs gezielt ansprechen, zum Beispiel so:

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

Das war's. Ihre Pipelines laufen jetzt auf Ihrem eigenen dedizierten Runner mit unbegrenzten Build-Minuten.

Nächster Schritt

Sie möchten Docker-Images aus Ihren Pipelines heraus bauen und pushen? Machen Sie weiter mit Docker-Images bauen.