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 repositorios públicos con GitHub gratis y en repositorios privados y públicos con with GitHub Pro, Equipo de GitHub, Nube de GitHub Enterprise yServidor de GitHub Enterprise.
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 verificacióniones 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. Toda confirmación debe ser subida a otra rama y luego fusionada o subida directamente a la rama protegida, una vez que se han aprobado todas las verificaciones de estado requeridas.
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. Deberías verificar al autor de cada estado enumerado en el cuadro de fusión que se espera antes de fusionar una solicitud de extracción.
Si tienes una verificación y un estado con el mismo nombre y seleccionas ese nombre como una verificación de estado requerida, tanto la verificación como el estado serán requeridos. 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 usando el cambio de base 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.
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 verificacione de estado requeridas.
Los administradores también pueden fusionar una rama protegida incluso si la rama está desactualizada con la rama base.
Puedes configurar verificaciones de estado estrictas o poco estrictas, dependiendo de si quieres solicitarle a tu rama que esté actualizada con la rama base antes de realizar la fusión.