Aller au contenu principal

Échec d’écriture dans Forgejo

typehttps://docs.frem.sh/reference/api/errors/forgejo-write-failed
Statut HTTP502 Bad Gateway

Ce que cela signifie

Vous avez demandé à fremforge d’appliquer la politique de risque par défaut (POST /orgs/{org}/risk-tier/template/apply), et Forgejo a refusé d’écrire .fremforge/risk.yaml dans le dépôt de politique pour une autre raison que la protection de branche. Une branche par défaut protégée n’est pas une erreur en soi : fremforge place alors le fichier sur une branche fremforge/risk-template et ouvre une pull request. Cette erreur survient aussi quand ce repli échoue, parce que la branche n’a pas pu être écrite ou que la pull request n’a pas pu être ouverte. Les paramètres des niveaux de risque ne sont pas modifiés.

Exemples de messages detail renvoyés avec cette erreur :

  • Could not write .fremforge/risk.yaml to acme/.rules.
  • main of acme/.rules is protected, and the template could not be written on fremforge/risk-template.
  • main of acme/.rules is protected, and the pull request for fremforge/risk-template could not be opened.

Que faire

Lisez detail : il indique le dépôt et la branche. Vérifiez que le dépôt de politique existe, qu’il n’est ni archivé ni un miroir, qu’il a une branche par défaut, et qu’aucune de vos règles n’empêche d’y créer une branche fremforge/risk-template. Puis réessayez. L’application peut être répétée sans risque : le fichier n’est jamais écrit deux fois, et une branche fremforge/risk-template laissée par une tentative précédente est réutilisée si elle contient déjà le modèle.

Forme de la réponse

Toutes les erreurs de l’API fremforge sont au format problem+json de la RFC 9457 :

{
  "type": "https://docs.frem.sh/reference/api/errors/forgejo-write-failed",
  "title": "Bad Gateway",
  "status": 502,
  "detail": "..."
}

Basez votre logique sur type, et non sur title ou detail : ces champs sont destinés à être lus par un humain et peuvent être reformulés.