Definire le impostazioni e i criteri del repository Git
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
Esistono diversi modi per personalizzare i repository Git di Azure Repos usando le impostazioni e i criteri del repository e dei rami. Questo articolo illustra le impostazioni e i criteri a livello di repository.
Le impostazioni e i criteri del repository configurano le opzioni globali per tutti i repository Git per un progetto o un'organizzazione o per singoli repository.
Questo articolo illustra le impostazioni e i criteri del repository sul lato server. Per informazioni sulle preferenze Git sul lato client, vedere Preferenze e impostazioni Git in Visual Studio.
Le politiche di ramo coprono i controlli specifici del ramo.
I criteri di ramo includono opzioni come la richiesta di una richiesta pull, una compilazione riuscita o una revisione del codice prima che le modifiche possano essere unite in un ramo. Per ulteriori informazioni, vedere le politiche e impostazioni del branch.
Le autorizzazioni di sicurezza nel repository e nel ramo controllano le assegnazioni degli utenti.
Queste autorizzazioni controllano chi può leggere, scrivere, contribuire alle richieste pull ed eseguire altre azioni specifiche. Per altre informazioni, vedere Impostare le autorizzazioni per un repository.
Riepilogo di tutte le impostazioni e i criteri del repository e dei rami
È possibile configurare impostazioni e criteri per tutti i repository in un progetto, per i singoli repository e per i rami di repository. Nel browser, configuri tutte queste impostazioni e criteri tramite Impostazioni del progetto>Repository.
Nota
È possibile impostare diverse impostazioni e criteri di ramo con l'interfaccia della riga di comando di Azure usando az repos policy.
Le tabelle seguenti riepilogano le impostazioni e i criteri che è possibile abilitare e configurare per repository e rami Git.
Tutte le impostazioni dei repository
La tabella seguente riepiloga le impostazioni che è possibile abilitare e configurare per tutti i nuovi repository Git in un progetto o in un'organizzazione.
Impostazione
Predefinita
Descrizione
Disattivato
Inizializzare nuovi repository con il nome predefinito del ramo specificato. È possibile modificare il ramo predefinito per un determinato repository in qualsiasi momento. Se non si abilita questa funzionalità, i repository vengono inizializzati con un ramo predefinito denominato main.
Attivato
Consentire agli utenti di gestire le autorizzazioni per i rami creati in tutti i nuovi repository.
Impostazioni repository
La tabella seguente riepiloga le impostazioni che è possibile abilitare o configurare per ogni singolo repository Git.
Impostazione
Predefinita
Descrizione
Attivato
Consentire agli utenti di creare fork dal repository.
Attivato
Creare automaticamente collegamenti per gli elementi di lavoro menzionati in un commento di commit.
Attivato
Consenti menzioni nei commenti di commit per chiudere gli elementi di lavoro. Richiede l'aggiornamento di Azure DevOps Server 2020.1 o versione successiva.
Attivato
Ricordare le preferenze dell'utente per completare gli elementi di lavoro con le pull request.
Attivato
Consentire agli utenti di gestire le autorizzazioni per i rami creati
Attivato
Abilitare Modalità di voto rigida per il repository, che richiede l'autorizzazione di contribuire per votare le pull request.
Attivato
Disabilitare l'accesso al repository, inclusi i build e le pull request, ma mantenere il repository visibile con un avviso.
Attivato
Criteri o opzioni del repository
La tabella seguente riepiloga i criteri o le opzioni che è possibile impostare per tutti o i singoli repository. I criteri impostati per Tutti i repository impostano il valore predefinito per i singoli repository aggiunti in un secondo momento.
Criterio o opzione
Predefinita
Descrizione
Disattivato
Blocca i push con un messaggio di posta elettronica dell'autore del commit che non corrisponde ai modelli specificati. Questa impostazione richiede Azure DevOps Server 2020.1 o versione successiva.
Disattivato
Blocca l'introduzione di percorsi di file che corrispondono ai modelli specificati. Questa impostazione richiede Azure DevOps Server 2020.1 o versione successiva.
Disattivato
Evitare conflitti di distinzione tra maiuscole e minuscole bloccando i push che modificano la combinazione di maiuscole e minuscole nei file, nelle cartelle, nei rami e nei tag.
Disattivato
Blocca i push che introducono file, cartelle o nomi di rami che includono nomi riservati della piattaforma o caratteri incompatibili.
Disattivato
Blocca i push che introducono percorsi che superano la lunghezza specificata.
Disattivato
Blocca i push che contengono file nuovi o aggiornati superiori al limite selezionato.
Politiche del ramo
La tabella seguente riepiloga i criteri che è possibile definire per personalizzare un ramo. Per altre informazioni sulla configurazione di queste impostazioni, vedere Migliorare la qualità del codice con i criteri dei rami. Quando si impostano criteri in un ramo, vengono applicati automaticamente i criteri seguenti:
- Le pull request devono essere effettuate per aggiornare il ramo.
- Il ramo non può essere eliminato.
Nota
I criteri di ramo vengono applicati alle richieste pull in base al ramo di destinazione della richiesta pull. Le politiche del ramo non dovrebbero essere impostate su rami temporanei che verranno eliminati dopo una pull request. L'aggiunta di criteri di ramo a rami temporanei causerà l'esito negativo dell'eliminazione automatica dei rami.
Politica
Predefinita
Descrizione
Disattivato
Richiedere l'approvazione da un numero specificato di revisori sulle pull request.
Disattivato
Incoraggiare la tracciabilità controllando la presenza di elementi di lavoro collegati nelle richieste pull.
Disattivato
Controllare che tutti i commenti siano stati risolti nei pull request.
Disattivato
Controllare la cronologia dei rami limitando i tipi di merge disponibili al termine delle richieste pull.
Disattivato
Aggiungere, abilitare o disabilitare uno o più criteri per convalidare il codice mediante l'unione preliminare e la compilazione delle modifiche delle richieste pull.
Disattivato
Aggiungere, abilitare o disabilitare uno o più criteri per richiedere ad altri servizi di pubblicare uno stato di successo per completare i pull request.
Disattivato
Aggiungere, abilitare o disabilitare uno o più criteri per designare i revisori del codice da includere automaticamente quando le richieste pull modificano determinate aree di codice.
Prerequisiti
| Categoria | Requisiti |
|---|---|
| Accesso al progetto | Membro di un progetto. |
| Autorizzazioni | - Visualizzare il codice nei progetti privati: almeno livello di accesso Basic . - Clonare o contribuire al codice nei progetti privati: membro del gruppo di sicurezza Contributors o con autorizzazioni corrispondenti nel progetto. - Impostare le autorizzazioni per il ramo o il repository: Gestisci le autorizzazioni per il ramo o il repository. - Modificare il ramo predefinito: Modificare le politiche le autorizzazioni per il repository. - Importare un repository: membro del gruppo di sicurezza , amministratori del progetto, o del gruppo di sicurezza Git a livello di progetto , Crea repository impostato su Consenti. Per altre informazioni, vedere Impostare le autorizzazioni del repository Git. |
| Servizi | Repos abilitato. |
| Strumenti | Opzionale. Usare i comandi az repos: l'interfaccia della riga di comando di Azure DevOps. |
Nota
Nei progetti pubblici, gli utenti con l'accesso degli stakeholder hanno accesso completo ad Azure Repos, inclusa la visualizzazione, la clonazione e il contributo al codice.
| Categoria | Requisiti |
|---|---|
| Accesso al progetto | Membro di un progetto. |
| Autorizzazioni | - Visualizzare il codice: almeno accesso di base. - Clonare o contribuire al codice: membro del gruppo di sicurezza Contributor o autorizzazioni corrispondenti nel progetto. |
| Servizi | Repos abilitato. |
Visualizzare e modificare impostazioni e criteri
È possibile configurare le impostazioni per tutti i repository in un'organizzazione o in un progetto o per singoli repository. È possibile configurare i criteri per tutti i repository, per i singoli repository o per i rami specificati tra i repository. Per informazioni sull'impostazione dei criteri dei rami, vedere Criteri di ramo.
Nota
È consigliabile configurare le impostazioni del repository a livello di progetto o per singoli repository, ma non entrambi. Se si configurano le impostazioni a più livelli, il sistema rispetta l'impostazione più restrittiva. La configurazione delle impostazioni a un solo livello riduce la confusione e i problemi di prestazioni git.
Per configurare le impostazioni di progetto e i criteri del repository tramite il portale web, aprire impostazioni progetto>Repository dal browser web.
Per visualizzare o modificare impostazioni o criteri per tutti i repository Git, aprire la pagina Tutti i repository e scegliere Impostazioni o criteri.
Per configurare impostazioni e criteri per un repository specifico, selezionare la scheda Repository , scegliere il repository e quindi scegliere la scheda Impostazioni o Criteri .
Lo screenshot seguente mostra la scheda Impostazioni selezionata. È possibile definire queste impostazioni per tutti i repository Git o per un singolo repository.
Lo screenshot seguente mostra la scheda Criteri selezionata. È possibile definire questi criteri per tutti i repository Git o per un singolo repository.
Nome del ramo predefinito
È possibile impostare un nome di ramo del repository predefinito a livello di organizzazione o progetto. L'impostazione a livello di organizzazione ha effetto per tutti i nuovi repository in tutti i progetti dell'organizzazione. L'impostazione a livello di progetto influisce su tutti i nuovi repository in un progetto e sostituisce qualsiasi nome impostato a livello di organizzazione.
È possibile:
- Scegliere un nome di ramo legale da usare quando viene inizializzato un repository.
- Modificare il nome predefinito in qualsiasi momento per influire su tutti i repository futuri.
- Modificare il nome predefinito del ramo per qualsiasi repository specifico in qualsiasi momento.
Se non si abilita la funzionalità del nome del ramo predefinito, i repository vengono inizializzati con il nome mainpredefinito del ramo di Azure Repos.
Per impostare un nome di ramo predefinito a livello di organizzazione:
- Nella pagina dell'organizzazione Azure DevOps selezionare Impostazioni organizzazione in basso a sinistra e quindi selezionare Repository nel riquadro di spostamento a sinistra.
- Nella pagina Tutti i repository impostare Nome ramo predefinito per i nuovi repository su Sì e quindi immettere un nome di ramo predefinito.
Per impostare un nome di ramo predefinito a livello di progetto:
- Nella pagina del progetto Azure DevOps selezionare Impostazioni progetto in basso a sinistra e quindi selezionare Repository nel riquadro di spostamento a sinistra.
- Nella scheda Impostazioni della pagina Tutti i repository impostare Nome ramo predefinito per i nuovi repository su Sì e quindi immettere un nome di ramo predefinito.
Nota
L'impostazione Nome ramo predefinito per i nuovi repository richiede Azure DevOps Server 2020.1 o versione successiva.
Gestione delle autorizzazioni del ramo
È possibile controllare chi può gestire le autorizzazioni per i rami del repository impostando un'impostazione di gestione delle autorizzazioni per tutti i repository Git o per singoli repository. Se si abilita l'impostazione Consenti agli utenti di gestire le autorizzazioni per i rami creati a livello di Tutti i repository , tutti i nuovi repository di progetto vengono configurati per consentire agli utenti di gestire le autorizzazioni per i rami creati.
Per gestire questa impostazione:
- Nella pagina del progetto Azure DevOps selezionare Impostazioni progetto in basso a sinistra e quindi selezionare Repository nel riquadro di spostamento a sinistra.
- Nella scheda Impostazioni della pagina Tutti i repository impostare Consenti agli utenti di gestire le autorizzazioni per i rami creati su Sì o No.
Per abilitare o disabilitare questa impostazione per singoli repository:
- Selezionare Impostazioni del Progetto>Repository, e quindi selezionare un repository.
- Nella scheda Impostazioni della pagina del <nome del repository>, impostare la Gestione autorizzazioni su Attivato o Disattivato.
Immagini Gravatar
Questa impostazione abilita o disabilita l'uso di immagini Gravatar per gli utenti esterni all'azienda.
Le immagini Gravatar sono un'impostazione a livello di organizzazione.
- Nella pagina dell'organizzazione Azure DevOps selezionare Impostazioni organizzazione in basso a sinistra e quindi selezionare Repository nel riquadro di spostamento a sinistra.
- Nella pagina Tutti i repository impostare Immagini Gravatar su Sì o No.
Le immagini Gravatar sono un'impostazione a livello di progetto per Tutti i repository.
- Nella pagina del progetto Azure DevOps selezionare Impostazioni progetto in basso a sinistra e quindi selezionare Repository nel riquadro di spostamento a sinistra.
- Nella scheda Impostazioni della pagina Tutti i repository impostare Immagini Gravatar su Attivato o Disattivato.
Abilitare i fork
Questa impostazione del repository controlla se gli utenti possono creare nuovi fork lato server. La disabilitazione di questa impostazione non rimuove i fork esistenti.
- Nelle Impostazioni del Progetto, selezionare Repository nella barra di navigazione a sinistra.
- Nella scheda Repository della pagina Tutti i repository, selezionare un repository.
- Nella scheda Impostazioni della <pagina Nome repository>, impostare Forks su On o Off.
Impostazioni di collegamento degli elementi di lavoro
Queste impostazioni del repository gestiscono il collegamento degli elementi di lavoro.
- Selezionare Impostazioni del progetto>Repository, e quindi selezionare un repository.
- Nella scheda Impostazioni della pagina <Nome repository>, attivare o disattivare le impostazioni.
Collegamento delle menzioni del commit
Se abilitata, i messaggi di commit contenenti # e un ID elemento di lavoro valido collegano automaticamente il commit a tale elemento di lavoro. Disabilitare questa impostazione se in precedenza il repository usava un account o un servizio diverso. Questi repository potrebbero avere messaggi di commit con # menzioni che non coincidono con gli ID degli elementi di lavoro nell'account attuale.
Indicare la risoluzione degli elementi di lavoro
Abilitare questa impostazione per completare automaticamente gli elementi di lavoro al termine delle richieste pull collegate. Questa impostazione consente anche di specificare altri stati di transizione degli elementi di lavoro nei messaggi di commit della richiesta pull. Per altre informazioni, vedere Completamento automatico degli elementi di lavoro con pull request.
Preferenze di transizione degli elementi di lavoro
Per impostazione predefinita, l'opzione per completare gli elementi di lavoro collegati durante il completamento della richiesta pull ricorda l'ultima scelta di ogni utente. I team che vogliono scoraggiare gli utenti a completare gli elementi di lavoro con le richieste pull possono disabilitare questa impostazione. Gli utenti devono quindi acconsentire esplicitamente al completamento degli elementi di lavoro ogni volta che completano una richiesta pull.
Impostazione Modalità di voto rigida
In determinate situazioni, gli utenti che non sono collaboratori di un repository possono inviare una pull request e farne eseguire il merge, a seconda dei criteri. Per evitare questa possibilità, abilita Strict Vote Mode per modificare il permesso richiesto per votare sulle richieste di pull del repository a Contribuire. Se si usa un fork utente in Azure Repos, è consigliabile abilitare questa impostazione.
- Selezionare Impostazioni del progetto>Repository, e quindi selezionare un repository.
- Nella scheda Impostazioni della pagina del <Nome repository>, impostare Strict Vote Mode su Attivato o Disattivato.
Disabilitare l'impostazione del repository
L'abilitazione di questa impostazione disabilita l'accesso al repository, incluse le compilazioni e le richieste pull, ma mantiene il repository individuabile con un avviso.
- Selezionare impostazioni del progetto>Repository e quindi selezionare un repository.
- Nella scheda Impostazioni della pagina del <repository>, in Disabilita repository, impostare Disabilita repository su Attivo o Disattivato.
Impostazione dei rami ricercabili
Per impostazione predefinita, la ricerca di codice nei file si applica solo al ramo predefinito. È possibile aggiungere fino a cinque rami per la ricerca.
Importante
Per cercare codice nei repository, è necessario installare l'estensione Code Search dal Marketplace. Se non vedi Rami Ricercabili nella scheda Impostazioni repository, assicurati di aver installato l'estensione.
Per aggiungere rami per la ricerca di codice:
- Selezionare
Impostazioni progetto Repository , e quindi selezionare un repository. - Nella scheda Impostazioni della pagina <Nome repository>, selezionare + in Rami ricercabili.
- Selezionare un ramo da includere nella ricerca e quindi selezionare Aggiungi ramo.
Criteri dei rami tra repository
È possibile impostare criteri per un nome di ramo specifico o nel ramo predefinito in tutti i repository di un progetto. Ad esempio, è possibile richiedere un minimo di due revisori per tutte le pull request in ogni main ramo per tutti i repository del progetto.
Per impostare i criteri per proteggere nomi di rami specifici o predefiniti in un progetto:
In Impostazioni del Progetto, selezionare Repository nella navigazione a sinistra.
Nella pagina Tutti i repository, selezionare la scheda Politiche.
Selezionare il segno più + in Criteri di ramo nella parte inferiore della pagina.
Nella schermata Aggiungi protezione ramo selezionare Proteggi il ramo predefinito di ogni repository oppure Proteggi rami correnti e futuri corrispondenti a un modello specificato.
Se si seleziona la seconda opzione, immettere il nome del ramo da proteggere. Un messaggio informativo consente di conoscere il numero di rami correnti interessati. Tenere presente che il nome del ramo (o il modello immesso) fa distinzione tra maiuscole e minuscole. Non è necessario che il ramo esista per proteggere il nome del ramo.
Seleziona Crea.
Nella pagina delle politiche inter-repository per il nome del ramo, imposta le politiche desiderate per i rami protetti. Per altre informazioni sui criteri dei rami, vedere Criteri di ramo.
Politica di convalida dell'email dell'autore del commit
Questo criterio blocca il commit in un repository da parte degli autori di commit i cui indirizzi di posta elettronica non corrispondono a un modello.
Selezionare Impostazioni progetto>Repository, e selezionare un repository se si vuole configurare solo quel repository.
Nella scheda Criteri della pagina Tutti i repository o <Nome repository>, sotto Criteri del repository, impostare la convalida dell'email dell'autore del commit su On o Off.
Se si attiva la politica, specificare l'indirizzo email o gli indirizzi da abbinare.
È possibile specificare indirizzi di posta elettronica esatti o usare caratteri jolly. Usare
;come separatore per più modelli di posta elettronica. I modelli di posta elettronica preceduti da!sono esclusi. L'ordine è importante.
Politica di convalida del percorso file
È possibile impostare un criterio che impedisce il commit in un repository da percorsi di file che corrispondono a un modello.
Selezionare Impostazioni Progetto>Repository, e selezionare un repository se si desidera configurare solo quel repository.
Nella scheda Criteri della pagina Tutti i repository o <Nome repository>, sotto Criteri del repository, impostare Convalida percorso file su Sì o No.
Se si attiva il criterio, specificare il percorso o i percorsi da bloccare.
È possibile specificare percorsi e caratteri jolly esatti. I percorsi esatti iniziano con
/. È anche possibile specificare più percorsi usando;come separatore. I percorsi preceduti da!sono esclusi. L'ordine è importante.
Politica di applicazione dei casi
Git fa distinzione tra maiuscole e minuscole, ovvero un file denominato Foo.txt è diverso da un file denominato foo.txt. Tuttavia, per impostazione predefinita, Windows e macOS sono sistemi di gestione dei file insensibili alle maiuscole, ovvero Foo.txt e foo.txt sono uguali. Questa discrepanza può causare problemi se un utente di un sistema senza distinzione tra maiuscole e minuscole esegue il push di file, cartelle, rami o tag che differiscono solo per maiuscole e minuscole. Per altre informazioni, vedere Compatibilità multipiattaforma Git.
Se la maggior parte dei collaboratori si trovano in Windows o macOS, è consigliabile abilitare i criteri di imposizione dei casi. L'imposizione delle maiuscole e minuscole commuta il server dalla modalità predefinita sensibile alla distinzione tra File.txt e file.txt, a una modalità compatibile con il comportamento di Windows e macOS, in cui File.txt e file.txt vengono considerati come lo stesso file. Questa impostazione interessa file, cartelle, rami e tag.
Questa impostazione impedisce ai collaboratori di introdurre differenze che riguardano solo l'uso di lettere maiuscole e minuscole. L'impostazione evita conflitti di distinzione tra maiuscole e minuscole bloccando i push che modificano la maiuscolatura dei nomi nei file, nelle cartelle, nei rami e nei tag. L'utente deve riscrivere la cronologia non crittografata per risolvere il problema, quindi riprovare a eseguire il push.
Questa impostazione non correggerà un repository che contiene già oggetti che differiscono solo per caso. È consigliabile risolvere questi problemi prima di attivare la politica. Rinominare file e cartelle o ricreare rami e tag per usare nomi che non causano conflitti.
Per impostare la politica di applicazione delle regole dei casi:
- Selezionare Impostazioni progetto>Repository e selezionare un repository se si vuole configurare solo quel repository.
- Nella scheda Criteri della pagina Tutti i repository o Nome <repository>, nella sezione Politiche del repository, impostare Applicazione delle maiuscole su Attivato o Disattivato.
Criteri per i nomi riservati
Non tutti i nomi file sono consentiti nei tre file system principali del sistema operativo: Windows, macOS e Linux. I commit in un repository condiviso possono contenere nomi di file o cartelle non validi in una o più piattaforme. Se i file o le cartelle non validi vengono recuperati ed estratti su queste piattaforme, le directory di lavoro possono diventare danneggiate. Per altre informazioni, vedere Compatibilità multipiattaforma Git.
È possibile abilitare o disabilitare i criteri per applicare restrizioni ai nomi di file e cartelle. L'impostazione Nomi riservati blocca il push in un repository che contiene nomi di file o cartelle non validi in tutte le piattaforme. Per vedere quali nomi sono non validi, vedere "Compatibilità Multipiattaforma di Git".
Per impostare i criteri dei nomi riservati:
- Selezionare Impostazioni Progetto>Repository, e selezionare un repository se si vuole configurare solo quel repository.
- Nella scheda Criteri della pagina Tutti i repository o Nome <repository>, sotto Criteri del repository, impostare Nomi riservati su Attivo o Disattivo.
Criterio di lunghezza massima del percorso
Non tutte le lunghezze di percorso sono consentite nei tre principali file system del sistema operativo: Windows, macOS e Linux. I commit in un repository condiviso possono contenere file o directory con lunghezze di percorso non valide in una o più piattaforme. Se questi file o directory vengono recuperati ed estratti su una piattaforma dove non sono validi, le directory di lavoro possono essere danneggiate. Per altre informazioni, vedere Compatibilità multipiattaforma Git.
L'impostazione Lunghezza massima percorso blocca i push che contengono file o directory con lunghezze di percorso non valide in qualsiasi piattaforma. Per vedere quali lunghezze del percorso sono non valide, consultare Compatibilità Git multipiattaforma. Quando si abilita questa impostazione, il valore massimo predefinito è 248, perché tale lunghezza massima è supportata al 100% in tutte e tre le piattaforme principali.
È possibile modificare il valore massimo del percorso. Ad esempio, se nell'organizzazione sono presenti solo sviluppatori macOS o Linux, è possibile scegliere di impostare la lunghezza massima sul valore supportato in entrambe le piattaforme, 1016. È anche possibile scegliere di impostare un valore massimo di percorso inferiore per rispettare le convenzioni di denominazione delle cartelle dell'organizzazione.
Per impostare i criteri di lunghezza massima del percorso:
- Selezionare Impostazioni del progetto>Repository, e selezionare un repository se si vuole configurare solo quel repository.
- Nella scheda Criteri della pagina Tutti i repository o <Nome del repository>, sotto Policy del repository, impostare la Lunghezza massima percorso su Attivo o Non attivo.
- Se è stata attivata l'impostazione, immettere una lunghezza massima del percorso.
Criteri di dimensioni massime dei file
I file di grandi dimensioni archiviati in Git rimangono nel repository a tempo indeterminato, aumentando i tempi di clonazione e l'utilizzo del disco. Per indicazioni sulla gestione di file di grandi dimensioni, vedere Gestire e archiviare file di grandi dimensioni in Git.
L'impostazione del criterio Dimensione massima del file impedisce ai file di dimensioni superiori a una determinata soglia dall'essere inseriti nel repository. Se un push contiene un file nuovo o aggiornato superiore al limite configurato in questa impostazione, il push viene bloccato. L'utente deve riscrivere la cronologia non crittografata per rimuovere il file di grandi dimensioni e riprovare a eseguire il push.
Per configurare il criterio Dimensioni massime del file:
- Selezionare Impostazioni di progetto>Repository e selezionare un repository se si vuole configurare solo quel repository.
- Nella scheda Criteri della pagina Tutti i repository o <Nome repository>, sotto Politiche dei repository, impostare le dimensioni massime dei file su Attivato o Disattivato.
- Se è stata attivata l'impostazione, selezionare una dimensione massima del file.
