Versión del artículo: Enterprise Server 2.17
Acerca de las verificaciones de estado requeridas
Las verificaciones de estado requeridas garantizan que todas las pruebas de integración continua (CI) requeridas sean aprobadas antes de que los colaboradores puedan realizar cambios en una rama protegida.
Las ramas protegidas se encuentran disponibles en los repositorios públicos con GitHub Free y GitHub Free para organizaciones, y en los repositorios públicos y privados con GitHub Pro, GitHub Team, GitHub Enterprise Cloud, y GitHub Enterprise Server.
Acerca de las verificaciones de estado requeridas
Si has implementado protecciones de rama en tu repositorio, puedes configurar las revisiones de estado requeridas. Para obtener más información, consulta "Configurar ramas protegidas" y "Activar verificaciones de estado requeridas". Las verificaciones de estado requeridas pueden ser verificaciones o estados. Para obtener más información, consulta "Acerca de las verificaciones de estado ".
Una vez activadas las verificaciones de estado requeridas, todas las verificaciones de estado requeridas deber ser aprobadas antes de que se puedan fusionar las ramas en la rama protegida. Una vez que hayan pasado todas las verificaciones de estado requeridas, cualquier confirmación deberá ya sea subirse en otra rama y después fusionarse, o subirse directo a la rama protegida.
Nota: Cualquier persona o integración con permisos de escritura en un repositorio puede establecer el estado de cualquier comprobación de estado en el repositorio. GitHub Enterprise no verifica que el autor de una comprobación está autorizado para crear un determinado nombre o modificar un estado existente. Antes de fusionar una solicitud de extracción, deberás verificar que se esté esperando al autor de cada estado, los cuales se encuentran listados en la caja de fusión.
Los administradores de un repositorio pueden fusionar una rama protegida incluso si las verificaciones de estado requeridas han fallado o están pendientes. Le puedes solicitar a los administradores que estén sujetos a las verificaciones de estado requeridas. Para obtener más información, consulta "Habilitar las verificaciones de estado requeridas."
Los administradores también pueden fusionar una rama protegida incluso si la rama está desactualizada con la rama base.
Configuración de las verificaciones de estado requeridas
Puedes configurar las verificaciones para que sean laxas o estrictas, dependiendo de lo que quieras que tu rama tenga actualizado con respecto a la rama base antes de la fusión. Para obtener más información, consulta "Tipos de verificación de estado requerido."
Solución de problemas para verificaciones de estado requeridas
Si tienes una revisión y un estado con el mismo nombre y seleccionas el nombre como una verificación de estado requerida, tanto la revisión como el estado se requerirán. Para obtener más información, consulta "Verificaciones" en la documentación del programador de GitHub.
Una vez que has configurado las verificaciones de estado requeridas, tu rama debe estar actualizada con la rama base antes de fusionarse. Esto garantiza que tu rama ha sido probada con el último código desde la rama base. Si tu rama no está actualizada, necesitarás fusionar la rama base en tu rama.
Nota: También puedes actualizar tu rama con la rama base utilizando Git rebase. Para obtener más información, consulta Accerca del rebase de Git."
No podrás subir cambios locales a una rama protegida hasta que se hayan aprobado todas las verificaciones de estado requeridas. En su lugar, recibirás un mensaje de error similar al siguiente:
remote: error: GH006: Protected branch update failed for refs/heads/master.
remote: error: Required status check "ci-build" is failingNota: Las solicitudes de extracción que están actualizadas y aprobaron las verificaciones de estado requeridas pueden ser fusionadas localmente y subidas a la rama protegida. Esto se puede hacer sin las verificaciones de estado ejecutándose en la propia confirmación de fusión.