Gestione las acciones permitidas para una sucursal con las reglas de la sucursal

Al crear una rama, se permiten ciertas acciones para esa rama en función de los permisos de esa función. Puedes cambiar las acciones que se permiten en una rama específica configurando las reglas de la sucursal. Las reglas de sucursal se basan en la función que desempeña un usuario en el proyecto. Puedes optar por limitar algunas acciones predefinidas, como enviar las confirmaciones a una sucursal, a los usuarios con un rol concreto en un proyecto. Esto puede ayudarte a proteger ramas específicas de un proyecto al limitar los roles que pueden realizar determinadas acciones. Por ejemplo, si configuras una regla de ramificación para que solo los usuarios con el rol de administrador del proyecto puedan fusionarse o transferirse a esa rama, los usuarios con otros roles en el proyecto no podrán realizar cambios en el código de esa rama.

Deberías considerar detenidamente todas las implicaciones de crear una regla para una rama. Por ejemplo, si decide limitar las entradas a una rama a los usuarios con la función de administrador del proyecto, los usuarios con la función de colaborador no podrán crear ni editar flujos de trabajo en esa rama, ya que el flujo de trabajo YAML se almacena en esa rama y esos usuarios no pueden confirmar ni enviar los cambios a la YAML misma. Como práctica recomendada, pruebe las reglas de las sucursales después de crearlas para asegurarse de que no tengan ningún impacto que no fuera su intención. También puedes usar las reglas de sucursal junto con las reglas de aprobación para las solicitudes de atracción. Para obtener más información, consulte Gestión de los requisitos para fusionar una solicitud de extracción con las reglas de aprobación.

nota

Debes tener la función de administrador de proyectos para gestionar las reglas de ramificación de los repositorios de origen de los CodeCatalyst proyectos. No puedes crear reglas de ramificación para los repositorios enlazados.

Solo puede crear reglas de ramificación que sean más restrictivas que los permisos predeterminados para el rol. No puede crear reglas de ramificación que sean más permisivas de lo que permite el rol de un usuario en el proyecto. Por ejemplo, no puedes crear una regla de ramificación que permita a los usuarios con el rol de revisor acceder a la rama.

Las reglas de bifurcación que se aplican a la rama predeterminada del repositorio de origen se comportarán de forma un poco diferente a las reglas de bifurcación que se aplican a otras ramas. Cualquier regla que se aplique a la rama predeterminada se aplicará automáticamente a cualquier rama que especifiques como la rama predeterminada. La rama que se estableció anteriormente como la rama predeterminada conservará las reglas que se le apliquen, excepto que ya no estará protegida contra la eliminación. Esa protección solo se aplica a la rama predeterminada actual.

Las reglas de sucursal tienen dos estados: Estándar y Personalizado. El estándar indica que las acciones permitidas en una sucursal son las que coinciden con los permisos del rol que desempeña el usuario en las acciones CodeCatalyst de la sucursal. Para obtener más información sobre qué roles tienen qué permisos, consulteConcesión de acceso con roles de usuario. La opción Personalizado indica que una o más acciones de sucursal tienen acciones que tienen una lista específica de roles permitidos para realizar esa acción y que difieren de los permisos predeterminados que otorga el rol de un usuario en el proyecto.

nota

Si creas una regla de rama para restringir una o más acciones de una rama, la acción Eliminar la rama se establece automáticamente para permitir que solo los usuarios con el rol de administrador del proyecto eliminen esa rama.

En la siguiente tabla se enumeran las acciones y la configuración predeterminada de los roles que pueden realizar estas acciones en una sucursal.

Acciones y funciones de la sucursal
Acción de ramificación	Los roles pueden realizar esta acción cuando no se aplica ninguna regla de ramificación
Fusiona con la rama (esto incluye fusionar una solicitud de extracción con la sucursal)	Administrador del proyecto, colaborador
Dirígete a la sucursal	Administrador del proyecto, colaborador
Elimine la rama	Administrador del proyecto, colaborador
Eliminar la rama (rama predeterminada)	No permitido

No puedes eliminar las reglas de ramificación, pero puedes actualizarlas para permitir acciones de todos los roles que estarían autorizados a realizar esta acción en una rama, lo que elimina la regla de manera efectiva.

nota

Debe tener el rol de administrador de proyectos para configurar las reglas de ramificación de los repositorios de origen de los CodeCatalyst proyectos. Esto no se aplica a los repositorios enlazados. Los repositorios enlazados no admiten las reglas de ramificación de. CodeCatalyst

Para ver y editar las reglas de ramificación de un repositorio

1. Navegue hasta el proyecto en el que reside su repositorio.

2. Elige el nombre del repositorio de la lista de repositorios de origen del proyecto. Como alternativa, en el panel de navegación, selecciona Código y, a continuación, selecciona Repositorios de origen.

   Elija el repositorio en el que desee ver las reglas de las sucursales.

3. En la página de información general del repositorio, selecciona Sucursales.

4. En la columna Reglas de sucursal, consulta el estado de las reglas de cada rama del repositorio. El estándar indica que las reglas para la acción de ramificación son las predeterminadas para cualquier rama creada en un repositorio de origen y coinciden con los permisos otorgados a esas funciones en un proyecto. La opción Personalizado indica que una o más acciones de rama tienen reglas que restringen una o más acciones permitidas para esa rama a un conjunto diferente de roles.

   Para ver los detalles de las reglas de sucursal de una sucursal, elige la palabra Estándar o Personalizada junto a la sucursal que deseas revisar.

5. Para crear o cambiar una regla de sucursal, selecciona Administrar configuración. En la página de configuración del repositorio de origen, en Reglas de sucursal, selecciona Editar.

6. En Branch, elija el nombre de la rama para la que quiere configurar una regla en la lista desplegable. Para cada uno de los tipos de acciones permitidos, elija los roles a los que desea permitir que realicen esa acción en la lista desplegable y, a continuación, elija Guardar.