Documentation Guardrail Ledger
Le contrôle et les exceptions
Le contrôle décide si une pull request passe. Une exception empêche un constat accepté de la faire échouer, jusqu'à l'expiration de l'exception.
Définir le contrôle
Un propriétaire ou un administrateur ouvre la page Contrôles et définit :
- La gravité minimale qui fait échouer une pull request : critique, élevée, moyenne ou faible. Les nouveaux espaces de travail démarrent à élevée.
- Les moteurs pris en compte pour le contrôle. Chaque scanner s'exécute quand même et chaque constat est enregistré. Les constats d'un moteur absent de la liste ne font pas échouer le contrôle.
- Le plafond de contributeurs, compté en demandeurs de build uniques sur 30 jours. Le contrôle ajoute un élément en échec lorsque plus de personnes que le plafond ont lancé des builds.
Choisissez Enregistrer. La modification du contrôle est écrite dans le journal d'audit.
Lire le résultat
Chaque exécution répond avec le résultat du contrôle. Lorsque le contrôle bloque, l'appel d'ingestion répond avec le statut 409 et l'étape ou le job échoue, sauf si vous définissez failOnGate: false sur la tâche ou fail-on-gate: false sur l'Action. Le résultat est aussi écrit dans le commentaire de la pull request et, sur GitHub, dans le résumé du job. Les constats restent sous Constats avec le dépôt et la pull request dans lesquels ils ont été trouvés.
Un scan ne résout que les constats des moteurs qui y ont rapporté des résultats. Un constat qui n'apparaît plus est marqué comme résolu.
Enregistrer une exception
- Un propriétaire ou un administrateur ouvre la page Exceptions.
- Choisissez un constat ouvert, ou collez son empreinte.
- Choisissez le propriétaire, un membre de l'espace de travail qui n'est pas vous. Vous êtes enregistré comme approbateur.
- Rédigez le motif et définissez la date d'expiration, au plus 90 jours à compter d'aujourd'hui.
- Choisissez Enregistrer l'exception. Elle s'applique immédiatement.
Un constat avec exception ne fait pas échouer le contrôle. Après la date d'expiration, le scan suivant le compte de nouveau dans le contrôle. La console n'a aucun bouton pour révoquer une exception.