CI: permissions: in e2e.yml wordt door Forgejo genegeerd (waarschuwing); push-rechten hangen aan instance-default #146

Closed
opened 2026-09-21 12:52:05 +02:00 by jelmer · 1 comment
Owner

Probleem

Forgejo toont bij elke run van e2e.yml deze waarschuwing:

Job test or its workflow has a permissions field, which is not supported in Forgejo and will be ignored. Use Authorized Integrations to grant capabilities to this job instead.
Job deploy or its workflow has a permissions field, which is not supported in Forgejo and will be ignored. Use Authorized Integrations to grant capabilities to this job instead.

Het permissions:-blok bovenaan .forgejo/workflows/e2e.yml (contents: write) heeft dus geen effect.

Waarom het nu toch werkt

De deploy-job doet git push origin main met ${{ github.token }} (staging -> main). Dat slaagt (bewezen op v2.30.1 en v2.30.2, main == staging), maar niet dankzij dat blok: onze instance geeft de automatische Actions-token standaard schrijfrechten.

Dat is een impliciete afhankelijkheid van een instance-instelling. De migratie-instructies gingen er ten onrechte van uit dat permissions: het regelt (zie de commentaar bij de checkout-stap in e2e.yml, die hetzelfde beweert).

Risico

Verandert de instance-default ooit naar read-only (upgrade, hardening), dan faalt de staging -> main-merge. Productie wordt dan niet meer bijgewerkt terwijl de tests groen zijn. De fout is alleen te zien in de deploy-job.

Voorstel

  • Kiezen: (a) Authorized Integrations inrichten zodat de deploy-job expliciet contents: write krijgt, of (b) bewust vertrouwen op de instance-default en dat vastleggen.
  • Het dode permissions:-blok uit e2e.yml halen (of vervangen door een commentaar met de werkelijke bron van de rechten), zodat de waarschuwing verdwijnt en de code niet meer iets beweert wat niet klopt.
  • Commentaar bij de checkout-stap corrigeren.
  • Optioneel: een controle in de deploy-job die vooraf duidelijk faalt ("Actions-token mag niet pushen") in plaats van pas bij git push.

Raakt alleen CI-configuratie; geen app-code.

## Probleem Forgejo toont bij elke run van `e2e.yml` deze waarschuwing: > Job `test` or its workflow has a `permissions` field, which is not supported in Forgejo and will be ignored. Use *Authorized Integrations* to grant capabilities to this job instead. > Job `deploy` or its workflow has a `permissions` field, which is not supported in Forgejo and will be ignored. Use *Authorized Integrations* to grant capabilities to this job instead. Het `permissions:`-blok bovenaan `.forgejo/workflows/e2e.yml` (`contents: write`) heeft dus geen effect. ## Waarom het nu toch werkt De `deploy`-job doet `git push origin main` met `${{ github.token }}` (staging -> main). Dat slaagt (bewezen op v2.30.1 en v2.30.2, `main == staging`), maar **niet dankzij dat blok**: onze instance geeft de automatische Actions-token standaard schrijfrechten. Dat is een impliciete afhankelijkheid van een instance-instelling. De migratie-instructies gingen er ten onrechte van uit dat `permissions:` het regelt (zie de commentaar bij de checkout-stap in `e2e.yml`, die hetzelfde beweert). ## Risico Verandert de instance-default ooit naar read-only (upgrade, hardening), dan faalt de `staging -> main`-merge. Productie wordt dan niet meer bijgewerkt terwijl de tests groen zijn. De fout is alleen te zien in de deploy-job. ## Voorstel - [ ] Kiezen: (a) *Authorized Integrations* inrichten zodat de `deploy`-job expliciet `contents: write` krijgt, of (b) bewust vertrouwen op de instance-default en dat vastleggen. - [ ] Het dode `permissions:`-blok uit `e2e.yml` halen (of vervangen door een commentaar met de werkelijke bron van de rechten), zodat de waarschuwing verdwijnt en de code niet meer iets beweert wat niet klopt. - [ ] Commentaar bij de checkout-stap corrigeren. - [ ] Optioneel: een controle in de deploy-job die vooraf duidelijk faalt ("Actions-token mag niet pushen") in plaats van pas bij `git push`. Raakt alleen CI-configuratie; geen app-code.
Author
Owner

Opgelost (commit 92f22b4, live via staging 4401c13, geen app-wijziging).

  • Het dode permissions:-blok is uit e2e.yml; de misleidende comments zijn gecorrigeerd. Gemeten via preExecutionWarnings van de run: 2 waarschuwingen vóór, 0 erna.
  • Nieuwe deploy-stap "Controleer push-rechten van de Actions-token": vraagt de repo-API of de token mag pushen en faalt vooraf, met een duidelijke melding die naar dit issue verwijst, alleen bij een expliciete false. Onbekend laat git push beslissen. In de echte run: push-recht van de Actions-token: true, en de merge naar main slaagde.
  • Lokaal getest tegen de echte API: true met de schrijf-token, false anoniem (zou dus terecht falen).
  • CLAUDE.md noemt het, zodat niemand het blok terugzet.

Gekozen voor de instance-standaard plus een vroege controle in plaats van Authorized Integrations. Wil je die route later alsnog (strakker: rechten per job), dan is dat een instellingswijziging op de instance; de voorcontrole blijft dan gewoon nuttig.

Opgelost (commit `92f22b4`, live via staging `4401c13`, geen app-wijziging). - Het dode `permissions:`-blok is uit `e2e.yml`; de misleidende comments zijn gecorrigeerd. Gemeten via `preExecutionWarnings` van de run: **2 waarschuwingen vóór, 0 erna**. - Nieuwe deploy-stap **"Controleer push-rechten van de Actions-token"**: vraagt de repo-API of de token mag pushen en faalt vooraf, met een duidelijke melding die naar dit issue verwijst, alleen bij een expliciete `false`. Onbekend laat `git push` beslissen. In de echte run: `push-recht van de Actions-token: true`, en de merge naar `main` slaagde. - Lokaal getest tegen de echte API: `true` met de schrijf-token, `false` anoniem (zou dus terecht falen). - `CLAUDE.md` noemt het, zodat niemand het blok terugzet. Gekozen voor de instance-standaard plus een vroege controle in plaats van Authorized Integrations. Wil je die route later alsnog (strakker: rechten per job), dan is dat een instellingswijziging op de instance; de voorcontrole blijft dan gewoon nuttig.
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
jelmer/topoquiz#146
No description provided.