Skip to main content

Acerca de las verificaciones de estado

Las verificaciones de estado te permiten saber si tus confirmaciones cumplen con las condiciones establecidas para el repositorio con el que estás colaborando.

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.

Listado de confirmaciones y estados

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 de la última confirmación para una rama en la página de ramas de tu repositorio o en la lista de solicitudes de extracción de tu repositorio.

Si un repositorio requiere verificaciones de estado, éstas deben pasar antes de que fusiones tu rama con la rama protegida. Para más información, vea "Acerca de las ramas protegidas".

Tipos de verificaciones de estado en GitHub Enterprise Cloud

Hay dos tipos de verificaciones de estado en GitHub Enterprise Cloud:

  • Comprobaciones
  • Estados

Las comprobaciones son diferentes a los estados, 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 escritura a un repositorio pueden crear verificaciones y estados con la API de GitHub Enterprise Cloud. Para obtener más información, vea "Comprobaciones" y "Estados".

Comprobaciones

Cuando se configuran comprobaciones en un repositorio, las solicitudes de incorporación de cambios tienen una pestaña Comprobaciones donde puede ver los resultados de la compilación detallados desde las comprobaciones de estado y volver a ejecutar las comprobaciones erróneas.

Verificaciones de estado dentro de una solicitud de extracción

Nota: La pestaña Comprobaciones solo se rellena para las solicitudes de incorporación de cambios si configura comprobaciones, y no estados, en el repositorio.

Cuando una línea específica en una confirmación 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) de la solicitud de incorporación de cambios.

Detalles de una verificación de estado

Puede navegar entre los resúmenes de las comprobaciones para varias confirmaciones en una solicitud de incorporación de cambios mediante el menú desplegable de la confirmación en la pestaña Conversation (Conversación).

Resúmenes de verificación para diferentes confirmaciones en un menú desplegable

Omitir y solicitar verificaciones para confirmaciones individuales

Cuando un repositorio se configura para que solicite automáticamente las verificaciones para las subidas, puedes elegir omitir las verificaciones para una confirmación indvidual que subes. Cuando un repositorio no se configura a fin de que solicite automáticamente las comprobaciones para las subidas, puede solicitar comprobaciones para una confirmación individual que inserte. Para obtener más información sobre esta configuración, vea "Conjuntos de comprobaciones".

Para omitir o solicitar 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"

Retención de comprobaciones de estado

Comprueba que los datos anteriores a 400 días están archivados. Como parte del proceso de archivado, GitHub crea un estado de confirmación de acumulación que representa el estado de todas las comprobaciones de esa confirmación. Como consecuencia, el cuadro de combinación de cualquier solicitud de incorporación de cambios con comprobaciones archivadas necesarias estará en un estado bloqueado y tendrás que volver a ejecutar las comprobaciones antes de que puedas combinar la solicitud de incorporación de cambios.