Configura la protección de ramas

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

La protección de ramas permite que los administradores de repositorios establezcan reglas para controlar quién puede realizar cambios en las ramas, quién debe aprobar o revisar los cambios y qué condiciones se deben cumplir antes de 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 la descripción general de la protección de ramas.

Antes de comenzar

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

Roles requeridos

Para obtener los permisos que necesitas para configurar reglas de protección de ramas para un repositorio de Secure Source Manager, pídele a tu administrador que te otorgue los siguientes roles de IAM:

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

También puedes obtener los permisos necesarios a través de roles personalizados o cualquier otro rol predefinido.

Para obtener información sobre cómo otorgar roles de Secure Source Manager, consulta Control de acceso con IAM y Cómo otorgar acceso a la instancia a los usuarios.

Crea una regla de protección de ramas

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

  1. En la interfaz web de Secure Source Manager, selecciona el repositorio que deseas proteger con una regla de protección de ramas.
  2. En la página del repositorio, haz clic en Configuración.
  3. Haz clic en la pestaña Branch rule.
  4. Haz clic en Agregar regla de rama.

  5. En el campo ID de regla de rama, ingresa un nombre para la regla de rama.

    Los IDs de las reglas de la rama se restringen a 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 bifurcación tienen un máximo de 63 caracteres.

  6. En el campo Branch filter, ingresa el nombre de la rama a la que deseas que se aplique la regla o, si quieres que se aplique a todas las ramas, ingresa .*. No se admite la coincidencia completa de expresiones regulares.

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

    Cuando varias reglas son aplicables a una rama, la regla de rama con un nombre de rama específico como filtro de rama anulará la regla de comodín. Por ejemplo, una regla de rama con el filtro de rama main anulará una regla de rama con el filtro de rama .*. Las reglas no se combinan.

  7. En la sección Branch protection rule details, especifica los requisitos para tu regla de rama con las siguientes opciones:

    • Require a solicitud de extracción before merging: Si está habilitada, se bloquearán las confirmaciones directas en la rama. Se debe abrir una solicitud de extracción antes de combinarla con la rama protegida.

    • Cantidad requerida de revisores: Especifica la cantidad de revisores necesarios para aprobar la solicitud de extracción y, así, combinarla.

    • Cantidad requerida de responsables de aprobación: Especifica la cantidad de responsables de aprobación que se requieren para aprobar la solicitud de extracción y, así, combinarla.

      Los revisores y aprobadores son usuarios con roles de IAM específicos. Para saber qué roles se requieren para los revisores y aprobadores, consulta la Descripción general de la protección de ramas.

    • Bloquear la combinación en revisiones y aprobaciones obsoletas: Si está habilitada, se quita una revisión o aprobación si se envían nuevos commits a la solicitud de extracción después de que se otorga la revisión o aprobación.

    • Require conversation resolution before merging: Si está habilitada, se deben resolver todos los comentarios del código y las revisiones de solicitudes de cambio antes de combinar.

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

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

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

Se muestra la pestaña Reglas de rama, con la nueva regla de rama en la lista.

Cómo modificar una regla de protección de rama

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

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

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

Borra una regla de protección de ramas

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

  1. En la interfaz web de Secure Source Manager, selecciona el repositorio del que deseas quitar la regla de rama.
  2. En la página del repositorio, haz clic en Configuración.
  3. Haz clic en la pestaña Branch rule.
  4. En la fila de la regla que deseas borrar, haz clic en el ícono Borrar borrar.
  5. En la pantalla de confirmación Remove branch rule, haz clic en Yes.

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

¿Qué sigue?