GitHub Actions Lockfile: gh actions-lock ersetzt SHA-Pinning durch Tags plus actions.lock

GitHub Actions unterstützt jetzt Lockfiles für Workflows. Hugo van Kemenade beschreibt das am 11. November 2026 auf hugovk.dev: Das Kommando gh actions-lock setzt Versions-Tags wie v7.0.1 oder v3.1.0 zurück in die Workflow-Datei und hält die zugehörigen Commit-Hashes getrennt in .github/workflows/actions.lock fest, was heißt: Der Workflow bleibt lesbar, die Sicherheit zieht ins Lockfile um. Das SHA-Pinning im Workflow fällt damit weg, die Festlegung auf einen überprüfbaren Commit übernimmt die Lockdatei.

  • Die Installation läuft über die GitHub CLI: gh extension install github/gh-actions-lock, danach prüft und aktualisiert gh actions-lock alle Workflows im Repo.
  • Das Tool erzeugt .github/workflows/actions.lock; die geänderte Workflow-Datei und das Lockfile müssen gemeinsam committet werden.
  • Renovate und Dependabot unterstützen die Lockdatei bereits, regelmäßige Abhängigkeits-Updates bleiben also an Bord.

Warum war bei GitHub Actions bisher der volle Commit-SHA Pflicht?

Weil Actions aus Git geladen werden und Git-Tags veränderbar sind. Ein Angreifer kann einen früher harmlosen Tag nachträglich auf bösartigen Code umbiegen, eine klassische Supply-Chain-Attacke. Deshalb lautete die Empfehlung bisher: kompletter Commit-SHA in den Workflow. Van Kemenade zeigt das im Beitrag an actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 mit Kommentar # v7.0.1. Diese Festlegung übernimmt nun die Lockdatei.

Ich hatte selbst mal einen Workflow mit einer Handvoll SHA-Kolonnen. Gelesen hat die niemand, aktualisiert schon gar niemand freiwillig. Genau dafür ist so ein Lockfile eigentlich erfunden worden.

Wie nutzt man gh actions-lock im eigenen Repo?

gh actions-lock ist eine Erweiterung der GitHub CLI. Nach der Installation läuft der Befehl direkt im Repo, meldet alle Workflows als gültig und schreibt .github/workflows/actions.lock. In den Workflow-Dateien stehen danach normale Versions-Tags, committet werden müssen Workflow und Lockfile zusammen.

Das ist gut, aber noch nicht rund. Ein Lockfile ist eine zweite Datei, die gepflegt werden will, und der Beitrag von van Kemenade bricht im übermittelten Text genau an der Stelle ab, wo es Richtung Validierung mit zizmor geht. Zur Sicherheitsseite des Lockfiles selbst sagt die Meldung damit weniger, als ich mir gewünscht hätte.

Kurz beantwortet

Ersetzt das Lockfile das SHA-Pinning vollständig? Im Workflow ja: Dort stehen wieder Tags, die Commit-Fixierung liegt in actions.lock. Renovate und Dependabot unterstützen die Lockdatei laut dem Beitrag auf hugovk.dev bereits, Updates laufen also weiter.

Was passiert, wenn ich das Lockfile beim Committen vergesse? Dann passen Tag im Workflow und fixierter Commit nicht mehr zusammen, der Artikel betont deshalb, dass Workflow und Lockfile zusammen in denselben Commit gehören. Wie GitHub so einen Drift abfängt, beschreibt der Beitrag nicht.

Meine offene Frage an alle, die das schon ausrollen: Was passiert bei einem Pull Request, in dem jemand den Workflow auf v7.0.1 biegt, das Lockfile aber auf dem alten Stand lässt und die Checks trotzdem grün werden? Den Happy Path zeigt der Beitrag sauber, diesen Drift-Fall lässt er offen.

Nachzulesen bei Hugo van Kemenade auf hugovk.dev, erschienen diese Woche.

Schreibe einen Kommentar