Prueba - Acerca de las ramas - prueba

Publicación de pruebas 16/12

Utilice una rama para aislar el trabajo de desarrollo sin afectar a otras ramas del repositorio. Cada repositorio tiene una rama predeterminada y puede tener varias otras ramas. Puede combinar una rama en otra con una solicitud de extracción.  

Acerca de las ramas

Las ramas le permiten desarrollar características, corregir errores o experimentar de forma segura con nuevas ideas en un área contenida de su repositorio. 

Siempre se crea una rama a partir de una rama existente. Por lo general, es posible que cree una rama a partir de la rama predeterminada del repositorio. A continuación, puede trabajar en esta nueva rama de forma aislada frente a los cambios que otras personas están realizando en el repositorio. Una rama que cree para crear una característica se denomina normalmente rama de características o rama de temas. Para obtener más información, consulte "Creación y eliminación de ramas en el repositorio".

También puedes usar una rama para publicar un sitio páginas de GitHub. Para obtener más información, consulte "Acerca de las páginas de GitHub".

Debe tener acceso de escritura en un repositorio para crear una rama, abrir una solicitud de extracción o eliminar y restaurar ramas en una solicitud de extracción. Para obtener más información, consulte "Permisos de acceso en GitHub".

Acerca de la rama predeterminada

Al crear un repositorio con contenido en GitHub, GitHub crea el repositorio con una sola rama. Esta primera rama del repositorio es la rama predeterminada. La rama predeterminada es la rama que GitHub muestra cuando alguien visita su repositorio. La rama predeterminada también es la rama inicial que Git extrae localmente cuando alguien clona el repositorio. A menos que especifique una rama diferente, la rama predeterminada de un repositorio es la rama base para nuevas solicitudes de extracción y código confirmación.

De forma predeterminada, GitHub nombra la rama predeterminada principal en cualquier nuevo repositorio.

Puede cambiar la rama predeterminada de un repositorio existente. Para obtener más información, consulta "Cambiar la rama predeterminada".

Puede establecer el nombre de la rama predeterminada para nuevos repositorios. Para obtener más información, consulte "Administrar la rama predeterminada para sus repositorios", "Administrar el nombre de rama predeterminado para repositorios de su organización" y "Aplicar directivas de administración de repositorios en su cuenta de empresa".

Trabajar con ramas

Una vez que estés satisfecho con tu trabajo, puedes abrir una solicitud de extracción para combinar los cambios de la rama actual (la rama principal) en otra rama (la rama base). Para obtener más información, vea "Acerca de las solicitudes de extracción."

Después de combinar o cerrar una solicitud de extracción, puedes eliminar la rama principal, ya que ya no es necesario. Debe tener acceso de escritura en el repositorio para eliminar ramas. No puede eliminar ramas que estén asociadas directamente con solicitudes de extracción abiertas. Para obtener más información, consulte "Eliminar y restaurar ramas en una solicitud de extracción"

Si elimina una rama principal después de combinar su solicitud de extracción, GitHub comprueba si hay solicitudes de extracción abiertas en el mismo repositorio que especifiquen la rama eliminada como su rama base. GitHub actualiza automáticamente estas solicitudes de extracción, cambiando su rama base a la rama base de la solicitud de extracción combinada. Los diagramas siguientes muestran esto.

Aquí alguien ha creado una rama denominada característica1 a partir de la rama principal y, a continuación, ha creado una rama denominada feature2 a partir de feature1. Hay solicitudes de extracción abiertas para ambas ramas. Las flechas indican la rama base actual para cada solicitud de extracción. En este punto, feature1 es la rama base para feature2. Si la solicitud de extracción de feature2 se combina ahora, la rama feature2 se combinará con feature1.

En el siguiente diagrama, alguien ha combinado la solicitud de extracción de feature1 en la rama maestra y ha eliminado la rama feature1. Como resultado, GitHub ha retargeted automáticamente la solicitud de extracción de feature2 para que su rama base sea ahora maestra.

Ahora, al combinar la solicitud de extracción de Feature2, se combinará en la rama principal.

Trabajar con ramas protegidas

Los administradores del repositorio pueden habilitar las protecciones en una rama. Si estás trabajando en una rama que está protegida, no podrás eliminar ni forzar el empuje a la rama. Los administradores del repositorio también pueden habilitar otras configuraciones de rama protegidas para exigir varios flujos de trabajo antes de que se pueda combinar una rama.

Para ver si la solicitud de extracción se puede combinar, busque en el cuadro de combinación de la parte inferior de la pestañaConversation de la solicitud de extracción. Para obtener más información, consulta "Acerca de las ramas protegidas".

Cuando una rama está protegida:

• No podrás eliminar ni forzar el empuje a la rama.

• Si se habilitan las comprobaciones de estado necesarias en la rama, no podrá combinar los cambios en la rama hasta que pasen todas las pruebas CI necesarias. Para obtener más información, consulte "Acerca de las comprobaciones de estado".

• Si las revisiones de solicitudes de extracción necesarias están habilitadas en la rama, no podrás combinar los cambios en la rama hasta que se cumplan todos los requisitos de la directiva de revisión de solicitudes de extracción. Para obtener más información, vea "Combinar una solicitud de extracción".

• Si se habilita la revisión obligatoria de un propietario de código en una rama y una solicitud de extracción modifica el código que tiene un propietario, un propietario de código debe aprobar la solicitud de extracción antes de que se pueda combinar. Para obtener más información, consulte "Acerca de los propietarios de códigos".

• Si la firma de confirmación necesaria está habilitada en una rama, no podrás insertar ninguna confirmación en la rama que no esté firmada ni verificada. Para obtener más información, consulta "Acerca de confirmar la verificación de firma" y "Acerca de las ramas protegidas".

• Si usas el editor de conflictos de GitHub para solucionar conflictos de una solicitud de extracción que creaste a partir de una rama protegida, GitHub te ayuda a crear una rama alternativa para la solicitud de extracción, para que puedas combinar la resolución de los conflictos. Para obtener más información, consulte "Resolver un conflicto de combinación en GitHub".

Lectura adicional

"Acerca de las solicitudes de extracción"

"Rama" en el glosario de GitHub

"Branches in a Nutshell" en la documentación de Git