Configurar la protección de ramas

En esta página se explica cómo configurar la protección de ramas en repositorios de Secure Source Manager.

La protección de ramas permite a los administradores de repositorios definir reglas para controlar quién puede hacer cambios en las ramas, quién debe aprobar o revisar los cambios y qué condiciones se deben cumplir para que un cambio aprobado se pueda combinar en una rama.

Para obtener más información sobre las reglas de protección de ramas, consulta el resumen de la protección de ramas.

Antes de empezar

  1. Crea una instancia de Secure Source Manager.
  2. Crea un repositorio de Secure Source Manager.

Roles obligatorios

Para obtener los permisos que necesitas para configurar reglas de protección de ramas en un repositorio de Secure Source Manager, pide a tu administrador que te conceda los siguientes roles de gestión de identidades y accesos:

Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar el acceso a proyectos, carpetas y organizaciones.

También puedes conseguir los permisos necesarios a través de roles personalizados u otros roles predefinidos.

Para obtener información sobre cómo conceder roles de Secure Source Manager, consulta los artículos Control de acceso con gestión de identidades y accesos y Conceder acceso a instancias a los usuarios.

Crear una regla de protección de ramas

Para crear una regla de protección de rama, sigue estos pasos:

  1. En la interfaz web de Secure Source Manager, selecciona el repositorio que quieras proteger con una regla de protección de ramas.
  2. En la página del repositorio, haga clic en Configuración.
  3. Haga clic en la pestaña Regla de ramificación.
  4. Haz clic en Añadir regla de ramificación.

  5. En el campo ID de regla de ramificación, introduce un nombre para la regla de ramificación.

    Los IDs de las reglas de ramificación solo pueden contener letras minúsculas, números y guiones. El primer carácter debe ser una letra y el último, una letra o un número. Los IDs de las reglas de ramificación tienen un máximo de 63 caracteres.

  6. En el campo Filtro de rama, introduce el nombre de la rama a la que quieras aplicar la regla. Si quieres que la regla se aplique a todas las ramas, introduce .*. No se admite la coincidencia completa de expresiones regulares.

    Los filtros de reglas de ramificación habilitados deben ser únicos en su repositorio. Los usuarios pueden tener varios filtros de reglas de ramificación inhabilitados. Por ejemplo, no puedes tener dos reglas de rama habilitadas en un mismo repositorio con el filtro de rama main.

    Si se aplican varias reglas a una rama, la regla de rama con un nombre de rama específico como filtro de rama prevalecerá sobre la regla de comodín. Por ejemplo, una regla de ramificación con el filtro de ramificación main anulará una regla de ramificación con el filtro de ramificación .*. Las reglas no se combinan.

  7. En la sección Detalles de la regla de protección de la rama, especifica los requisitos de la regla de la rama entre las siguientes opciones:

    • Requerir una solicitud de extracción antes de combinar: si esta opción está habilitada, se bloquearán las confirmaciones directas en la rama. Se debe abrir una solicitud de extracción antes de combinarla en la rama protegida.

    • Número de revisores necesarios: especifica el número de revisores que deben aprobar la solicitud de extracción para que se pueda combinar.

    • Número de aprobadores necesarios: especifica el número de aprobadores que deben aprobar la solicitud de extracción para que se pueda combinar.

      Los revisores y aprobadores son usuarios con roles de gestión de identidades y accesos específicos. Para saber qué roles se necesitan para los revisores y aprobadores, consulta el resumen de la protección de ramas.

    • Bloquear la combinación en revisiones y aprobaciones obsoletas: si esta opción está habilitada, una revisión o una aprobación se elimina si se insertan nuevas confirmaciones en la solicitud de extracción después de que se haya concedido la revisión o la aprobación.

    • Requerir que se resuelvan las conversaciones antes de combinar: si esta opción está habilitada, todos los comentarios del código y las revisiones de solicitudes de cambios deben resolverse antes de combinar.

    • Requerir historial lineal: si está habilitada, las solicitudes de extracción que crearían un historial de Git no lineal no se pueden combinar.

    • Requerir comprobaciones de estado: si está habilitada, las comprobaciones de estado de compilación seleccionadas deben completarse correctamente para que se pueda combinar una solicitud de extracción. Debes configurar los activadores en tu archivo de activadores antes de poder seleccionarlos como comprobaciones de estado para la protección de ramas.

  8. Para guardar la regla de ramificación, haga clic en Enviar.

Se muestra la pestaña Reglas de ramificación, con la nueva regla de ramificación.

Modificar una regla de protección de ramas

Para modificar una regla de protección de ramas, haz lo siguiente:

  1. En la interfaz web de Secure Source Manager, seleccione el repositorio con la regla de protección de la rama que quiera modificar.
  2. En la página del repositorio, haga clic en Configuración.
  3. Haga clic en la pestaña Reglas de ramificación.
  4. Haz clic en el nombre de la regla de ramificación que quieras modificar.
  5. Edita la regla de protección de la rama.
  6. Haz clic en Actualizar.

Se actualiza la regla de protección de la rama.

Eliminar una regla de protección de rama

Para eliminar una regla de protección de rama, haz lo siguiente:

  1. En la interfaz web de Secure Source Manager, selecciona el repositorio del que quieras quitar la regla de rama.
  2. En la página del repositorio, haga clic en Configuración.
  3. Haga clic en la pestaña Regla de ramificación.
  4. En la fila de la regla que quieras eliminar, haz clic en el icono Eliminar delete.
  5. En la pantalla de confirmación Eliminar regla de ramificación, haz clic en Sí.

Se elimina la regla de protección de la rama.

Siguientes pasos