Las verificaciones de estado se basan en procesos externos, como compilaciones de integración continua, que se ejecutan para cada subida que haces a un repositorio. Puede ver el estado pending (pendiente), passing (aprobado) o failing (error) de las verificaciones de estado al lado de las confirmaciones individuales en su solicitud de incorporación de cambios.
Cualquier persona con permisos de escritura a un repositorio puede determinar el estado de cualquier comprobación de estado en el repositorio.
Puedes ver el estado general del último commit para una rama en la página de ramas de tu repositorio o en la lista de pull requests de tu repositorio.
Si se requieren comprobaciones de estado para un repositorio, deben completarse con éxito antes de que puedas fusionar tu rama en la rama protegida. Para más información, consulta Acerca de las ramas protegidas.
Nota:
Si se omite un trabajo, se notificará su estado como "Success". No impedirá que una solicitud de incorporación de cambios se combine, incluso si es una comprobación necesaria.
Tipos de verificaciones de estado en GitHub
Hay dos tipos de verificaciones de estado en GitHub:
- Comprobaciones
- Estados de confirmación
Las comprobaciones son diferentes a los estados de commit, ya que proporcionan anotaciones de líneas, mensajes más detallados y solo están disponibles para usarse con GitHub Apps.
Nota:
GitHub Actions genera comprobaciones, no estados de confirmaciones, cuando se ejecutan los flujos de trabajo.
Los propietarios de la organización y los usuarios con acceso de inserción a un repositorio pueden crear verificaciones y estados de confirmación con la API de GitHub. Para más información, consulta Puntos de conexión de la API de REST para comprobaciones y Puntos de conexión de la API de REST para estados de confirmaciones.
Comprobaciones
Las solicitudes de extracción tienen una pestaña Checks donde puedes ver los resultados detallados de la compilación de las comprobaciones y volver a ejecutar las comprobaciones fallidas.
Nota:
La pestaña Checks solo se rellena para los pull requests si configuras checks, en lugar de commit statuses, en el repositorio.
Cuando una línea específica en un commit provoca que una comprobación produzca un error, verá los detalles acerca del error, advertencia o aviso al lado del código relevante en la pestaña Files (Archivos) del pull request.
Puedes navegar entre los resúmenes de comprobaciones de varias confirmaciones en una solicitud de incorporación de cambios utilizando el menú desplegable de confirmaciones en la pestaña Checks.
Omitir y solicitar verificaciones para confirmaciones individuales
Cuando un repositorio se configura para que solicite automáticamente las comprobaciones para los envíos, puedes elegir omitir las comprobaciones para un commit individual que envíes. Cuando un repositorio no está configurado para solicitar automáticamente verificaciones para los empujes, puede solicitar verificaciones para un commit individual que suba. Para obtener más información acerca de esta configuración, consulta Puntos de conexión de la API de REST para conjuntos de comprobación.
También puedes omitir las ejecuciones de flujo de trabajo que desencadenan los eventos push y pull_request al incluir un comando en tu mensaje de confirmación. Para obtener más información, consulta Saltarse las ejecuciones de flujo de trabajo.
De forma alternativa, para omitir o solicitar todas las verificaciones para tu confirmación, agrega una de las siguientes lineas de introducción al final de tu mensaje de confirmación:
-
A fin de omitir comprobaciones para una confirmación, escriba su mensaje de confirmación, y una descripción corta y significativa de sus cambios. Después de la descripción del commit, antes de la cita de cierre, añada dos líneas vacías seguidas de
skip-checks: true:$ git commit -m "Update README > > skip-checks: true" -
A fin de solicitar comprobaciones para una confirmación, escriba su mensaje de confirmación, y una descripción corta y significativa de sus cambios. Después de la descripción de su commit, antes de las comillas de cierre, agregue dos líneas vacías seguidas de
request-checks: true:$ git commit -m "Refactor usability tests > > request-checks: true"
De forma predeterminada, Git quita automáticamente las nuevas líneas consecutivas. Para dejar el mensaje de confirmación exactamente como lo escribiste, usa la opción --cleanup=verbatim en la confirmación. Para más información, vea --cleanup=<mode> en la documentación de Git.
Comprobación de estados y conclusiones
Las comprobaciones pueden tener muchos estados diferentes. Los estados describen el estado de una comprobación desde que se crea hasta que se completa. Algunos estados no se pueden establecer manualmente y están reservados para GitHub Actions. Cuando una comprobación tiene un estado de completed, tiene una conclusión. La conclusión describe el resultado de la comprobación. A continuación se enumeran todos los estados de comprobación y conclusiones posibles.
| Estado | Descripción | ¿Solo GitHub Actions? |
|---|---|---|
completed | La verificación se ha completado y tiene una conclusión (consulta a continuación). | No |
expected | La ejecución de comprobación espera a que se notifique un estado. | Sí |
failure | Se ha producido un error en la ejecución de comprobación. | No |
in_progress | La ejecución de comprobación está en curso. | No |
pending | La ejecución de comprobación está en la parte delantera de la cola, pero se ha alcanzado el límite de simultaneidad basada en grupos. | Sí |
queued | La ejecución de comprobación se ha puesto en cola. | No |
requested | La ejecución de comprobación se ha creado, pero no se ha puesto en cola. | Sí |
startup_failure | Se ha producido un error al iniciar el conjunto de comprobaciones. Este estado no es aplicable a las ejecuciones de comprobación. | Sí |
waiting | La ejecución de comprobación espera a que se cumpla una regla de protección de implementación. | Sí |
| Conclusión | Descripción |
|---|---|
action_required | La ejecución de comprobación ha proporcionado acciones requeridas una vez completada. Para más información, consulta Uso de la API REST para interactuar con comprobaciones. |
cancelled | La ejecución del proceso de verificación fue cancelada antes de que se completara. |
failure | Se ha producido un error en la ejecución de comprobación. |
neutral | La ejecución de comprobación se ha completado con un resultado neutro. Esto se considera un éxito para las verificaciones dependientes en GitHub Actions. |
skipped | La ejecución de comprobación se ha omitido. Esto se considera un éxito para las verificaciones dependientes en GitHub Actions. |
stale | La ejecución de comprobación se ha marcado como obsoleta por GitHub porque ha tardado demasiado tiempo. |
success | La ejecución de comprobación se ha completado correctamente. |
timed_out | Se agotó el tiempo de ejecución de la comprobación. |
Retención de cheques
GitHub.com retiene los datos de comprobación durante 400 días. Después de 400 días, los datos se archivan. 10 días después del archivado, los datos se eliminan permanentemente.
Para combinar una solicitud de incorporación de cambios con comprobaciones necesarias y archivadas, debe volver a ejecutar las comprobaciones.