Acerca de las verificaciones de estado

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.

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.

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 cambios tienen una pestaña Checks donde puedes ver los resultados de la compilación detallados desde las comprobaciones y volver a ejecutar las comprobaciones erróneas.

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 se configura a fin de que solicite automáticamente las comprobaciones para las inserciones, puede solicitar comprobaciones para una confirmación individual que inserte. 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 de su confirmación, antes de las comillas de cierre, agregue 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 confirmación, 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á al principio 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

Los administradores del sitio pueden controlar la directiva de retención para comprobar los datos de tu instancia de GitHub Enterprise Server. Para más información, consulta Configuración de aplicaciones.

Para combinar una solicitud de incorporación de cambios con comprobaciones necesarias y archivadas, debe volver a ejecutar las comprobaciones.