Documentación de Guardrail Ledger
La puerta y las excepciones
La puerta decide si un pull request pasa. Una excepción evita que un hallazgo aceptado lo haga fallar, hasta que la excepción caduca.
Definir la puerta
Un propietario o administrador abre la página Puertas y define:
- La severidad mínima que hace fallar un pull request: crítica, alta, media o baja. Los espacios de trabajo nuevos empiezan en alta.
- Los motores que cuentan para la puerta. Todos los escáneres se siguen ejecutando y todos los hallazgos se registran. Los hallazgos de un motor que no está en la lista no hacen fallar la puerta.
- El límite de contribuidores, contado como solicitantes únicos de compilación en 30 días. La puerta añade un elemento que falla cuando más personas que el límite han ejecutado compilaciones.
Elija Guardar. El cambio de la puerta se escribe en el registro de auditoría.
Leer el resultado
Cada ejecución responde con el resultado de la puerta. Cuando la puerta bloquea, la llamada de ingesta responde con el estado 409 y el paso o job falla, a menos que establezca failOnGate: false en la tarea o fail-on-gate: false en la Action. El resultado también se escribe en el comentario del pull request y, en GitHub, en el resumen del job. Los hallazgos permanecen en Hallazgos con el repositorio y el pull request en los que se encontraron.
Un escaneo resuelve solo los hallazgos de los motores que informaron en él. Un hallazgo que ya no aparece se marca como resuelto.
Registrar una excepción
- Un propietario o administrador abre la página Excepciones.
- Elija un hallazgo abierto, o pegue su huella.
- Elija el responsable, un miembro del espacio de trabajo que no sea usted. Usted queda registrado como aprobador.
- Escriba el motivo y establezca la caducidad, como máximo 90 días a partir de hoy.
- Elija Registrar excepción. Se aplica de inmediato.
Un hallazgo con excepción no hace fallar la puerta. Después de la fecha de caducidad, el siguiente escaneo vuelve a contarlo para la puerta. La consola no tiene ningún botón para revocar una excepción.