👋 We've unified all of GitHub's product documentation in one place! Check out the content for REST API, GraphQL API, and Developers. Learn more on the GitHub blog.


Frecuentemente publicamos actualizaciones de nuestra documentación. Es posible que la traducción de esta página esté en curso. Para conocer la información más actual, visita la documentación en inglés. Si existe un problema con las traducciones en esta página, por favor infórmanos.
Versión del artículo: Enterprise Server 2.19

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.

En este artículo

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.

Fusionar una 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."

Fusión del administrador de la rama protegida

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. For more information, see "Checks."

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."

Rama desactualizada

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 failing

Nota: 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.

Leer más

Pregunta a una persona

¿No puedes encontrar lo que estás buscando?

Contáctanos