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 están disponibles en los repositorios públicos con GitHub gratis y en los repositorios públicos y privados con el GitHub Pro, el Equipo de GitHub, la Nube de GitHub Enterprise y el Servidor 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. After all required status checks have passed, any commits must either be pushed to another branch and then merged or pushed directly to the protected branch.
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. Before merging a pull request, you should verify that the author of each status, listed in the merge box, is expected.
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. 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.
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. For more information, see "Enabling required status checks."
Los administradores también pueden fusionar una rama protegida incluso si la rama está desactualizada con la rama base.
You can set up either loose or strict status checks, depending on whether you want to require your branch to be up to date with the base branch before merging. For more information, see "Types of required status checks."