Zum Inhalt springen

Git

STACKIT Git ist ein vollständig verwalteter Git-Service, der die Versionskontrolle und Zusammenarbeit für Softwareentwicklungsteams vereinfacht. Er ermöglicht Entwicklern das sichere Hosten, Verwalten und Verfolgen ihrer Codebasis in der europäischen Cloud, während sie die volle Kontrolle über ihre Projekte behalten.

  • announcement

    Schnellere Image-Pulls und strengere Isolation für STACKIT Runner

    Abschnitt betitelt „Schnellere Image-Pulls und strengere Isolation für STACKIT Runner“

    Am 12. November 2026 aktualisieren wir die STACKIT Runner von STACKIT Git Pipelines. Runner-Jobs laden die von uns angebotenen Basis-Images aus einem internen Cache, und Docker-Operationen, die privilegierten Zugriff auf den Runner-Host benötigen, sind nicht mehr erlaubt. Dadurch werden Image-Pulls schneller und konsistenter, und Jobs sind stärker voneinander getrennt.

    Basis-Images werden aus einem internen Cache geladen

    Abschnitt betitelt „Basis-Images werden aus einem internen Cache geladen“

    Die Runner laden die von STACKIT angebotenen Basis-Container-Images aus einem Cache in einer internen Registry. Dadurch wartet ein Job kürzer auf sein Image. Die STACKIT Container Registry ist die Upstream-Quelle des Caches. Kann der Cache ein Image nicht bereitstellen, lädt der Runner es aus der STACKIT Container Registry, sodass Pulls auch bei hohem Datenverkehr weiterlaufen.

    Da die Basis-Images als geprüfte Kopien aus unserer eigenen Registry stammen, sind Ihre Jobs nicht von den Rate Limits externer Registries betroffen, und Ihre Builds laufen in einer konsistenten Umgebung.

    Docker-Operationen mit Zugriff auf den Runner-Host werden abgelehnt

    Abschnitt betitelt „Docker-Operationen mit Zugriff auf den Runner-Host werden abgelehnt“

    Um Jobs auf gemeinsam genutzten Runnern stärker voneinander zu trennen, lehnen die Runner Docker-Befehle ab, die einem Container privilegierten Zugriff auf den Runner-Host geben würden. Ein Job, der einen solchen Befehl ausführt, schlägt mit einer Fehlermeldung fehl, die mit Command denied by Stackit Classic runner security policy beginnt.

    Folgende Operationen sind nicht mehr erlaubt:

    • Privilegierte Container ausführen, zum Beispiel mit docker run --privileged.
    • Linux Capabilities hinzufügen, zum Beispiel mit docker run --cap-add=NET_ADMIN.
    • Den Prozess- oder IPC-Namespace des Hosts mit --pid=host oder --ipc=host teilen.
    • Pfade des Runner-Hosts wie /, /etc, /proc, /sys, /dev, /var oder /run oder darunterliegende Pfade einbinden. Dazu gehört auch das Einbinden des Docker-Sockets mit -v /var/run/docker.sock:/var/run/docker.sock.

    Images mit docker build und docker buildx build bauen, Images pullen und pushen sowie unprivilegierte Container ausführen, die den Workspace, /tmp oder benannte Docker Volumes einbinden, funktioniert weiterhin wie bisher.

    Wenn Ihre Pipeline auf eine der oben genannten Operationen angewiesen ist, wenden Sie sich an unser STACKIT Help Center.

    Wir haben ein intermittierendes Problem behoben, bei dem gleichzeitige Git-Operationen beim Klonen von Actions Fehler verursachten, durch die der Job abbrach. Workflows sollten bei Checkout-Schritten nun nicht mehr unerwartet fehlschlagen.

    Wir nehmen weitere Basis-Images in den Cache auf. Wenn Ihre Workflows ein Standard-Basis-Image benötigen, fragen Sie es über unser STACKIT Help Center an und geben Sie Folgendes an:

    • Den Namen des Images. Wir nehmen nur Anfragen für offizielle Images an.
    • Die genauen Tags, die Sie benötigen, zum Beispiel ubuntu:22.04 oder node:20-alpine.

    Wenn Sie Fragen haben, steht Ihnen unser STACKIT Help Center jederzeit zur Verfügung.

    Wir befüllen unseren vorab aufgewärmten Action-Cache aktiv, um die Laufzeiten von Schritten so kurz wie möglich zu halten. Wenn Ihre Workflows auf benutzerdefinierte, interne oder nicht standardmäßige Actions angewiesen sind, die auf unseren Runner-Images vorab im Cache gespeichert werden sollen, antworten Sie hier bitte mit dem Action-Repository und dem Versions-Tag (z. B. owner/action-name@vX). Wir werden häufig angefragte Actions evaluieren und in den Pool für den vorgewärmten Cache aufnehmen.

  • changed

    Forgejo Runner v13: Änderungen, die Ihre Workflows beeinträchtigen können

    Abschnitt betitelt „Forgejo Runner v13: Änderungen, die Ihre Workflows beeinträchtigen können“

    Wir haben die Runner von STACKIT Git auf Forgejo Runner v13 aktualisiert. Diese Version wertet Ausdrücke strenger aus, entfernt veraltete Workflow-Befehle, beschränkt Registry-Zugangsdaten auf den Job, der sie deklariert, und entfernt die verbliebene Gitea-Kompatibilität. Mehrere Fälle, die bisher nur eine Warnung erzeugt haben, lassen den Lauf jetzt fehlschlagen. Prüfen Sie Ihre Workflows daher auf die folgenden Änderungen.

    Ungültige Ausdrücke und Matrizen lassen den Lauf fehlschlagen

    Abschnitt betitelt „Ungültige Ausdrücke und Matrizen lassen den Lauf fehlschlagen“

    Ein Ausdruck, der nicht ausgewertet werden kann, zum Beispiel ein format()-Aufruf mit weniger Argumenten, als sein Format-String referenziert, lässt jetzt den Step oder Job fehlschlagen, statt eine Warnung zu erzeugen. Eine Matrix, die einen nicht definierten Wert ausschließt, ist jetzt ein Fehler, und der Workflow wird nicht ausgeführt.

    Prüfen Sie die Ausdrücke und matrix-Definitionen in Ihren Workflow-Dateien.

    Die Befehle ::set-output, ::set-env und ::add-path haben keine Wirkung mehr, und ACTIONS_ALLOW_UNSECURE_COMMANDS aktiviert sie nicht wieder. Schreiben Sie stattdessen direkt in die Umgebungsdateien:

    • Ersetzen Sie echo "::set-output name=var::value" durch echo "var=value" >> "$FORGEJO_OUTPUT".
    • Ersetzen Sie echo "::set-env name=VAR::value" durch echo "VAR=value" >> "$FORGEJO_ENV".
    • Ersetzen Sie echo "::add-path::/custom/bin" durch echo "/custom/bin" >> "$FORGEJO_PATH".

    Der Runner meldet sich nicht mehr mit den Secrets DOCKER_USERNAME und DOCKER_PASSWORD bei Registries an, da diese Zugangsdaten an eine Registry gesendet werden könnten, für die sie nicht bestimmt sind. Wenn ein Job ein Image aus einer privaten Registry nutzt, deklarieren Sie die Zugangsdaten in diesem Job:

    jobs:
    build:
    container:
    image: private.registry.example/app:latest
    credentials:
    username: ${{ secrets.REGISTRY_USER }}
    password: ${{ secrets.REGISTRY_TOKEN }}

    Der Kontext ${{ gitea.* }} wird nicht mehr unterstützt. Ersetzen Sie ihn in Ihren Workflows durch ${{ forgejo.* }}.

    Der Runner verbindet die Ausgabe eines Steps nicht mehr mit einem Terminal. Befehle, die Farben nur ausgeben, wenn sie ein Terminal erkennen, geben jetzt reinen Text aus. Setzen Sie FORCE_COLOR=1, um wieder eine farbige Ausgabe zu erhalten. Befehle, die ein Terminal voraussetzen, schlagen fehl. Ersetzen Sie zum Beispiel docker run -it durch docker run -i.

    • Docker Engine 25.0 oder neuer ist erforderlich. Wir empfehlen 28.0.1 oder neuer, da ältere Versionen mit Forgejo Runner v13 beim Anlegen von IPv6-Netzwerken fehlschlagen können.
    • Die Variablen GITEA_DEBUG, GITEA_TRACE, GITEA_RUNNER_CAPACITY, GITEA_RUNNER_FILE, GITEA_RUNNER_ENVIRON und GITEA_RUNNER_ENV_FILE werden ignoriert. Entfernen Sie sie aus der Konfiguration und der Umgebung Ihrer Runner.
    • Die Option container.network_mode wurde entfernt. Nutzen Sie stattdessen container.network.

    Weitere Details finden Sie in der Release-Ankündigung zu Forgejo Runner v13.0 und in den Release Notes von Forgejo Runner.

    Wenn Sie Fragen haben, steht Ihnen unser STACKIT Help Center jederzeit zur Verfügung.

  • announcement

    Am 27. Oktober 2026 von 20:00 bis 23:00 Uhr (UTC) wird der SSH-Zugriff auf STACKIT Git auf eine gemeinsame Adresse umgestellt. Der Name Ihrer Instanz wird dabei zum ersten Element im Pfad des Repositories. Das verringert die öffentlich erreichbare Angriffsfläche Ihrer Instanz und ermöglicht es uns, die Zuverlässigkeit von Git-Operationen über SSH an einer Stelle zu verbessern.

    • Bisherige Adresse: git@ssh.<instance>.git.onstackit.cloud:<owner>/<repository>.git
    • Adresse nach der Wartung: ssh://git@ssh.git.onstackit.cloud/<instance>/<owner>/<repository>.git

    Während der Wartung wird jede Git Instanz einmal neu gestartet und ist dabei etwa eine Minute nicht verfügbar. Die Neustarts erfolgen zeitversetzt, sodass nicht alle Instanzen gleichzeitig betroffen sind. Der Zugriff über HTTPS, Ihre Repositories, Ihre Benutzer, Ihre hinterlegten SSH-Schlüssel und Ihre IP-Allowlists bleiben unverändert.

    Die bisherige Adresse funktioniert nach der Wartung weiterhin, bis zum 27. April 2027. Ihre bestehenden Klone und Ihre Automatisierung bleiben also funktionsfähig, und Sie können die Umstellung in Ihrem eigenen Tempo vornehmen. Wir erinnern Sie, bevor wir die bisherige Adresse abschalten.

    • Erlauben Sie ausgehenden Datenverkehr zu 213.17.16.145 auf Port 22, falls Ihr Netzwerk ausgehende Verbindungen einschränkt.
    • Hinterlegen Sie den Host Key von ssh.git.onstackit.cloud, falls Ihre Systeme Host Keys strikt prüfen. Sein Fingerprint lautet SHA256:I4jgl6ALgx5qOWwpQVC2M613dV7R0Wy6LfQQ5LQKwR4 (ED25519).
    • Stellen Sie sicher, dass der SSH-Schlüssel, den Ihr Client an ssh.git.onstackit.cloud sendet, in Ihrer Instanz hinterlegt ist.
    • Ermitteln Sie alle Stellen, an denen die Adresse hinterlegt ist: lokale Klone, Build-Pipelines, Deployment-Automatisierung, Infrastructure-as-Code-Modulquellen und Repository-Mirrors.

    Aktualisieren Sie die Remote-Adresse jedes Repositories:

    Terminal-Fenster
    git remote set-url origin "$(git remote get-url origin | sed -E 's#^(ssh://)?git@ssh\.([^.]+)\.git\.onstackit\.cloud[:/]#ssh://git@ssh.git.onstackit.cloud/\2/#')"

    Die vollständige Anleitung, einschließlich der Auswahl des richtigen Schlüssels bei mehreren SSH-Schlüsseln, finden Sie unter Verbindung zu Ihren Repositories über SSH.

    Wenn Sie Fragen haben, steht Ihnen unser STACKIT Help Center jederzeit zur Verfügung.