Comprender por qué está bloqueado el pull request
Los administradores de repositorios y los propietarios de la organización pueden establecer puertas de calidad mediante GitHub Code Quality. Al abrir una solicitud de incorporación de cambios, las comprobaciones se ejecutan automáticamente para evaluar los cambios con respecto a estos estándares.
Hay dos tipos de bloques:
- Resultados de calidad del código: los cambios presentan problemas que se encuentran por debajo del umbral de calidad necesario.
- Umbral de cobertura: los cambios hacen que la cobertura de código se encuentre por debajo de un mínimo necesario o haga que la cobertura se quite por más de una cantidad permitida en relación con la rama predeterminada.
Estas comprobaciones ayudan a mantener un código base saludable y fácil de mantener y evitar que la deuda técnica se acumula.
Resolución de un bloqueo por hallazgos de calidad del código
Si la solicitud de incorporación de cambios introduce código que está por debajo del umbral de calidad necesario, verá un banner de bloque de combinación en la parte inferior de la solicitud de incorporación de cambios en la sección "Comprobaciones": "La combinación está bloqueada: se detectaron resultados de calidad del código".
La puerta de calidad establecida por el administrador del repositorio o el propietario de la organización define el nivel de gravedad mínimo que bloqueará la combinación. Todos los resultados en ese nivel de gravedad o superior deben corregirse o descartarse antes de poder combinarse. Si el aviso de bloqueo de fusión no especifica un nivel de gravedad, su repositorio requiere que se resuelvan todos los hallazgos.
Para desbloquear la solicitud de incorporación de cambios, debe corregir o descartar los resultados que cumplen o superan la gravedad de bloqueo:
- Revise los comentarios que dejó el/la
github-code-quality[bot]en su solicitud de incorporación de cambios. Cada comentario se etiqueta por gravedad (Error, Advertencia, Nota). - Corrija o descarte los resultados pertinentes. Para obtener instrucciones detalladas, consulte Corregir las incidencias de calidad del código en una pull request.
- Compruebe que el aviso de bloqueo de fusión ya no aparece en la sección «Checks» de su pull request.
Resolver un bloqueo por umbral de cobertura
Si tu pull request está bloqueada por una regla de umbral de cobertura, verás un aviso de bloqueo de fusión en la sección "Checks" con un mensaje que indica qué umbral no se alcanzó. Por ejemplo:
- "La cobertura del 22,0 % es inferior al mínimo del 50,0 %": la cobertura de ramas de su solicitud de incorporación de cambios está por debajo del porcentaje mínimo de cobertura configurado en el conjunto de reglas.
- "La cobertura disminuyó en 2,5%, la caída máxima permitida es de 1,0%": los cambios provocaron que la cobertura bajase por más de la cantidad permitida en relación con la rama predeterminada.
Para desbloquear la solicitud de incorporación de cambios, debe agregar o modificar pruebas para que se ejecute más del código base:
- Revise el comentario de resumen de cobertura en la solicitud de incorporación de cambios para identificar qué archivos o áreas carecen de cobertura.
- Agregue o actualice pruebas para aumentar la cobertura de ejecución. Copilot puede ayudarle a escribir y actualizar las pruebas. Consulta Probar el código.
- Envíe los cambios. La comprobación de cobertura se volverá a ejecutar automáticamente.