Configurare la protezione dei rami

Questa pagina spiega come configurare la protezione dei rami per i repository Secure Source Manager.

La protezione dei rami consente agli amministratori del repository di impostare regole per controllare chi può apportare modifiche ai rami, chi deve approvare o rivedere le modifiche e quali condizioni devono essere soddisfatte prima che una modifica approvata possa essere unita a un ramo.

Per saperne di più sulle regole di protezione dei rami, consulta la panoramica della protezione dei rami.

Prima di iniziare

  1. Crea un'istanza Secure Source Manager.
  2. Crea un repository Secure Source Manager.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per configurare le regole di protezione dei rami per un repository Secure Source Manager, chiedi all'amministratore di concederti i seguenti ruoli IAM:

Per ulteriori informazioni sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Per informazioni sulla concessione dei ruoli Secure Source Manager, consulta Controllo dell'accesso con IAM e Concedere agli utenti l'accesso all'istanza.

Crea una regola di protezione del ramo

Per creare una nuova regola di protezione dei rami:

  1. Nell'interfaccia web di Secure Source Manager, seleziona il repository che vuoi proteggere con una regola di protezione dei rami.
  2. Nella pagina del repository, fai clic su Impostazioni.
  3. Fai clic sulla scheda Regola di ramificazione.
  4. Fai clic su Aggiungi regola di ramificazione.

  5. Nel campo ID regola di diramazione, inserisci un nome per la regola di diramazione.

    Gli ID regola del ramo sono limitati a lettere minuscole, numeri e trattini. Il primo carattere deve essere una lettera e l'ultimo carattere deve essere una lettera o un numero. Gli ID delle regole di ramificazione hanno un massimo di 63 caratteri.

  6. Nel campo Filtro filiale, inserisci il nome della filiale a cui vuoi che si applichi la regola oppure, se vuoi che la regola si applichi a tutte le filiali, inserisci .*. La corrispondenza completa delle espressioni regolari non è supportata.

    I filtri delle regole di ramificazione abilitati devono essere univoci per il repository. Gli utenti possono avere più filtri di regole di ramificazione disattivati. Ad esempio, non puoi avere due regole di ramificazione abilitate in un singolo repository con il filtro di ramificazione main.

    Quando a un ramo si applicano più regole, la regola del ramo con un nome del ramo specifico come filtro del ramo sostituirà la regola jolly. Ad esempio, una regola di filiale con il filtro filiale main sostituirà una regola di filiale con il filtro filiale .*. Le regole non vengono combinate.

  7. Nella sezione Dettagli regola di protezione del ramo, specifica i requisiti per la regola del ramo tra le seguenti opzioni:

    • Richiedi una richiesta pull prima dell'unione: se attivata, i commit diretti al ramo verranno bloccati. Una richiesta di pull deve essere aperta prima dell'unione nel ramo protetto.

    • Numero di revisori richiesti: specifica il numero di revisori richiesti per l'approvazione al fine di unire la richiesta di pull.

    • Numero di approvatori richiesti: specifica il numero di approvatori necessari per approvare l'unione della richiesta di pull.

      Revisori e approvatori sono utenti con ruoli IAM specifici. Per scoprire quali ruoli sono richiesti per i revisori e gli autori dell'approvazione, consulta la panoramica della protezione dei rami.

    • Blocca unione in caso di revisioni e approvazioni obsolete: se questa opzione è abilitata, una revisione o un'approvazione viene rimossa se vengono inviati nuovi commit alla richiesta di pull dopo la concessione della revisione o dell'approvazione.

    • Richiedi la risoluzione della conversazione prima dell'unione: se questa opzione è abilitata, tutti i commenti al codice e le revisioni delle richieste di modifica devono essere risolti prima dell'unione.

    • Richiedi cronologia lineare: se questa opzione è attivata, le richieste di pull che creerebbero una cronologia Git non lineare non possono essere unite.

    • Richiedi controlli di stato: se questa opzione è attivata, i controlli di stato della build selezionati devono essere superati prima che una richiesta di pull possa essere unita. Devi configurare i trigger nel file dei trigger prima di poterli selezionare come controlli di stato per la protezione dei rami.

  8. Per salvare la regola di ramificazione, fai clic su Invia.

Viene visualizzata la scheda Regole di filiale, con la nuova regola di filiale elencata.

Modificare una regola di protezione del ramo

Per modificare una regola di protezione del ramo:

  1. Nell'interfaccia web di Secure Source Manager, seleziona il repository con la regola di protezione del ramo che vuoi modificare.
  2. Nella pagina del repository, fai clic su Impostazioni.
  3. Fai clic sulla scheda Regole filiali.
  4. Fai clic sul nome della regola di ramificazione da modificare.
  5. Modifica la regola di protezione del ramo.
  6. Fai clic su Aggiorna.

La regola di protezione del ramo è aggiornata.

Eliminare una regola di protezione del ramo

Per eliminare una regola di protezione del ramo:

  1. Nell'interfaccia web di Secure Source Manager, seleziona il repository da cui vuoi rimuovere la regola del ramo.
  2. Nella pagina del repository, fai clic su Impostazioni.
  3. Fai clic sulla scheda Regola di ramificazione.
  4. Nella riga della regola da eliminare, fai clic sull'icona Elimina elimina.
  5. Nella schermata di conferma Rimuovi regola filiale, fai clic su Sì.

La regola di protezione del ramo viene eliminata.

Passaggi successivi