Aller au contenu principal

Relancer les analyses de pull request

Chaque pull request est analysée automatiquement à son ouverture et à chaque push. Les analyseurs — dépendances (fremforge/dep-scan), SAST (fremforge/sast), licences (fremforge/license-scan), image de conteneur (fremforge/image-scan) et vérification de signature (fremforge/cosign-verify, à titre informatif) — publient leurs résultats sous forme de statuts de commit sur la PR, sur lesquels s’appuient vos règles de protection de branche.

Il arrive que les statuts d’analyse d’une PR deviennent obsolètes, par exemple lorsqu’un incident passager de la plateforme a empêché la publication d’un statut. Inutile de pousser un commit vide (et de subir un build CI complet) simplement pour relancer des analyseurs qui durent environ une minute : relancez-les directement.

Relancer les analyseurs d’une PR

curl -sS -X POST \
  -H "Authorization: Bearer <token with findings:write>" \
  https://frem.sh/_app/api/v1/orgs/<org>/repos/<repo>/pulls/<number>/rescan
  • Portée : findings:write.
  • Relance les analyseurs sur le commit de tête actuel de la pull request et republie les statuts de commit fremforge/*. Les analyseurs se terminent généralement en quelques secondes.
  • Idempotent : vous pouvez l’appeler autant de fois que nécessaire ; les résultats sont dédupliqués par dépôt + commit + analyseur. Aucun nouveau build CI n’est lancé.
  • Respecte la politique d’analyse de votre organisation (un analyseur réglé sur off pour l’organisation ou le dépôt n’est pas exécuté), exactement comme l’analyse automatique au push.

Réussite

{
  "repo_full_name": "acme/api",
  "pr_number": 42,
  "head_sha": "a1b2c3d4…",
  "scanners_enqueued": 5
}

Autres réponses

StatutSignification
404Pull request introuvable.
409Rien n’a été relancé : le champ detail en donne la raison (l’analyse centralisée des PR n’est pas activée pour l’organisation, l’organisation n’est pas couverte, ou le commit de tête n’a pas pu être résolu).
503L’analyse des PR n’est pas disponible sur cette instance.

Quand l’utiliser

  • Une PR est bloquée par un statut d’analyse qui n’a jamais été publié ou qui semble obsolète.
  • Vous avez modifié la politique d’analyse de votre organisation ou de votre dépôt et souhaitez réévaluer une PR ouverte selon la nouvelle politique sans pousser de commit.

Pour le comportement de l’analyse automatique et le détail de chaque analyseur, consultez Analyse des dépendances, SAST, Analyse des licences, Analyse des images et Vérification de signature. Le schéma complet des requêtes et des réponses figure dans la référence de l’API.