Permission Denied to github-actions[bot] (403): Lösung
Zuletzt aktualisiert am
Permission to <owner>/<repo>.git denied to github-actions[bot] bedeutet, dass ein Workflow versucht hat zu pushen (einen Commit, ein Tag oder einen Branch), das GITHUB_TOKEN dafür aber nur Lesezugriff hat. Die Lösung ist eine Zeile im Workflow und in manchen Organisationen eine Einstellung. Diese Seite behandelt außerdem die anderen Gründe, aus denen ein Push durch den Bot fehlschlägt.
Die genaue Meldung
remote: Permission to my-org/my-repo.git denied to github-actions[bot].
fatal: unable to access 'https://github.com/my-org/my-repo/': The requested URL returned error: 403
Lösung 1: Dem Job contents: write geben
permissions:
contents: write
jobs:
release:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- run: |
git config user.name "github-actions[bot]"
git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
git add CHANGELOG.md
git commit -m "Update changelog" || echo "nothing to commit"
git push
actions/checkout speichert das Token des Workflows standardmäßig für spätere Git-Befehle, daher verwendet ein einfaches git push es. Setzen Sie permissions auf den Job, der pusht, und nicht auf den gesamten Workflow, damit andere Jobs weiterhin nur lesend arbeiten.
Lösung 2: Standardeinstellung der Organisation und des Repositorys prüfen
Unter Settings, Actions, General kann "Workflow permissions" auf "Read repository contents and packages permissions" (nur lesend) stehen. Ein Organisationsinhaber kann dies für alle Repositorys erzwingen. Ein permissions:-Block im Workflow kann die Berechtigung erhöhen, sofern die Organisationseinstellung dies nicht verhindert. Wenn der Block keine Wirkung hat, wenden Sie sich an einen Inhaber.
Lösung 3: Der Push wird durch eine Branch-Regel blockiert
Ein geschützter Branch, der Pull Requests, Reviews oder Status-Checks verlangt, lehnt auch einen direkten Push des Bots ab, mit einer anderen Meldung wie GH006: Protected branch update failed. Der Bot kann die Regel standardmäßig nicht umgehen. Möglichkeiten sind, in einen neuen Branch zu pushen und einen Pull Request zu öffnen, oder die App bzw. den Bot in die Bypass-Liste des Rulesets aufzunehmen, sofern Ihr Tarif dies unterstützt.
- uses: peter-evans/create-pull-request@v7
with:
branch: auto/changelog
title: Update changelog
Diese Aktion benötigt contents: write und pull-requests: write sowie die Repository-Einstellung "Allow GitHub Actions to create and approve pull requests", die aktiviert sein muss.
Lösung 4: Forks können nicht pushen
Bei Workflows, die durch einen Pull Request aus einem Fork ausgelöst werden, ist das Token nur lesend, und keine Berechtigungseinstellung ändert das. Der Workflow kann nicht in den Branch des Forks pushen. Führen Sie den Schreibschritt in einem separaten Workflow aus, der durch workflow_run ausgelöst wird, oder bitten Sie Mitwirkende, den Formatierer lokal auszuführen.
Lösung 5: Der Workflow soll pushen und weitere Workflows auslösen
Ein Push mit dem GITHUB_TOKEN startet keine weiteren Workflow-Runs, was GitHub verhindert, um Endlosschleifen zu vermeiden. Wenn ein gepushter Commit oder Tag einen Workflow auslösen muss, pushen Sie stattdessen mit einem GitHub-App-Token oder einem persönlichen Zugriffstoken.
Lösung 6: Tags pushen oder Workflow-Dateien bearbeiten
Das Pushen eines Tags benötigt ebenfalls contents: write. Das Ändern einer Datei unter .github/workflows ist mit dem GITHUB_TOKEN gar nicht möglich, siehe refusing to allow a GitHub App to update workflow.
So verhindern Sie den Fehler
- Halten Sie die Standardberechtigungen nur lesend und fügen Sie
contents: writenur dem einen Job hinzu, der pusht. - Planen Sie für Branch-Regeln: Pushen Sie in einen Branch und öffnen Sie einen Pull Request, anstatt direkt in
mainzu pushen. - Verwenden Sie ein GitHub-App-Token, wenn ein Push einen nachfolgenden Workflow auslösen muss.
- Testen Sie den Workflow in einem Branch, bevor Sie ihn für Releases verwenden.
FAQ
Warum kann der Bot lesen, aber nicht schreiben?
Neuere Repositorys und Organisationen setzen das GITHUB_TOKEN aus Sicherheitsgründen standardmäßig auf nur lesend. Schreibzugriff aktivieren Sie pro Job.
Ist das dasselbe wie "Resource not accessible by integration"?
Die Ursache ist dieselbe (eine fehlende Token-Berechtigung), nur wird sie über Git statt über die API sichtbar. Siehe Resource not accessible by integration.
Verursacht persist-credentials: false dieses Problem?
Ja. Damit wird das Token nicht für spätere Git-Befehle gespeichert, sodass git push keine Zugangsdaten hat. Lassen Sie die Einstellung für Jobs, die pushen, auf dem Standardwert oder übergeben Sie das Token explizit.
Kann ich aus einem zeitgesteuerten Workflow pushen?
Ja, mit contents: write. Zeitgesteuerte Workflows laufen auf dem Standard-Branch, daher gelten die Regeln für geschützte Branches weiterhin.
Verwandt
- Permission Denied (publickey) in GitHub Actions: BehebenBehebt "git@github.com: Permission denied (publickey)" in GitHub Actions: SSH-Schlüssel oder Deploy-Key hinzufügen oder für private Repos auf HTTPS-Token wechseln.
- GitHub App darf Workflow nicht aktualisieren: LösungBehebung von „refusing to allow a GitHub App to create or update workflow without workflows permission“: PAT oder App-Token mit Schreibrecht nutzen.
- Cache Service Responded With 429: So beheben Sie den FehlerFix "Failed to restore: Cache service responded with 429" in GitHub Actions: zu viele Cache-Anfragen. actions/cache aktualisieren, einmal wiederherstellen, einmal speichern.
- fatal: could not read Username for github.com: BehebenBehebe "fatal: could not read Username for 'https://github.com'" in GitHub Actions: Private Repos, Submodules und Git-Abhängigkeiten benötigen einen Token.