Audits et banc d'essai

Prérequis et lancement

La page Audits d'un projet lance un audit sur un dépôt et liste les audits passés. Elle indique aussi ce qu'il manque quand un audit ne peut pas démarrer.

Qui peut le faire : l'Opérateur, le Responsable et l'Administrateur lancent un audit. Le Lecteur ne voit que la carte Historique des audits. Aucune vérification récente n'est demandée.

Ouvrir la page Audits#

  1. Ouvrez le projet depuis Projets.
  2. Dans la barre Espace projet, cliquez sur Audits.

La page s'affiche à l'adresse /projects/<projectId>/audits.

Prérequis#

NiveauPrérequisQui le règle
InstanceAudits de dépôt activésL'exploitant
InstanceGitHub App configuréeL'exploitant
DépôtDépôt actif : case Autoriser les travaux sur ce dépôt cochéeLe Responsable, voir Rattacher un dépôt
DépôtDépôt rattaché : Vérifier et rattacherL'Administrateur, voir Lier le dépôt à la GitHub App

Un dépôt nouvellement déclaré démarre à l'arrêt : pensez à cocher Autoriser les travaux sur ce dépôt puis à enregistrer.

La surveillance des issues n'est pas nécessaire pour un audit statique. Elle l'est pour les contrôles dynamiques, qui demandent aussi un accord de recette.

Ce que la page affiche quand il manque quelque chose#

La carte Audit du dépôt ne masque plus le formulaire sans explication. Elle affiche :

  • Audits désactivés sur cette instance : l'exploitant doit activer les audits pour le web et le worker, puis redéployer ;
  • GitHub App non configurée : l'exploitant doit renseigner les identifiants de la GitHub App ;
  • Dépôts à préparer avant l'audit : chaque dépôt bloqué, avec un lien vers sa fiche et la consigne (« arrêté : cocher « Autoriser les travaux sur ce dépôt » dans sa fiche » ou « non rattaché : cliquer sur « Vérifier et rattacher » dans sa fiche ») ;
  • Aucun dépôt dans ce projet : déclarez un dépôt depuis la page du projet, puis rattachez-le.

Lancer un audit, pas à pas#

  1. Dans la carte Audit du dépôt, choisissez le Dépôt à auditer. Seuls les dépôts prêts sont proposés.
  2. Pour un audit statique seul, ne cochez rien d'autre.
  3. Pour ajouter des contrôles dynamiques, cochez dans Contrôles sur la recette autorisée les contrôles voulus et renseignez leur Budget de requêtes (voir Contrôles dynamiques).
  4. Cliquez sur Lancer l'audit.
  5. La page du dossier d'audit s'ouvre. Son badge passe de En file à En cours, puis à Terminé ou Partiel.

Pendant un arrêt global, l'audit est accepté et reste En file : le dossier affiche l'encadré En attente de la levée de l'arrêt global, et l'audit démarre une seule fois après la levée. Les contrôles dynamiques demandés sont acceptés si l'accord les couvre ; l'accord est relu avant l'envoi.

Sur le dossier, le bouton Actualiser recharge l'état tant que l'audit ou ses contrôles dynamiques sont en cours.

Historique des audits#

La carte Historique des audits liste les audits du projet : dépôt, date et état, 30 par page. Le lien Audits suivants affiche la suite.

Refus courants#

Les refus de lancement portent un code stable, le même dans l'interface et dans l'API :

CodeMessage affichéQue faire
repository_audits_disabled (503)« Audits de dépôt désactivés sur cette instance : définir MVP_REPOSITORY_AUDITS_ENABLED=true pour le web et le worker (variable de la ressource Coolify), puis redéployer. »Transmettre à l'exploitant
repository_stopped (409)« Dépôt arrêté : cocher « Autoriser les travaux sur ce dépôt » dans sa fiche, puis enregistrer. »Activer le dépôt
repository_not_bound (409)« Dépôt non rattaché à la GitHub App : ouvrir sa fiche et cliquer sur « Vérifier et rattacher ». »Demander le rattachement à l'Administrateur

Autres messages possibles :

MessageCause
« Aucun accord actuel ne couvre ces contrôles dynamiques et leur budget. »Contrôle dynamique demandé sans accord compatible
« Audit indisponible ou accès refusé. »Rôle insuffisant ou projet hors de votre périmètre
« Service temporairement indisponible. »Réessayer plus tard

L'API utilise les mêmes codes : voir Erreurs de l'API.

Pour continuer#

Lire un audit