Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022
Suggerimento
È possibile usare l'intelligenza artificiale per facilitare le attività di Azure DevOps. Per iniziare, vedere Abilitare l'assistenza AI con Azure DevOps MCP Server.
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 di ramo predefinito 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 automaticamente 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
Le policy di branch vengono applicate alle pull request in base al branch di destinazione della pull request. Non impostare i criteri di ramo nei rami temporanei che si prevede di eliminare dopo aver aperto una pull request. L'aggiunta di criteri di ramo ai rami temporanei causa 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
Verificare che tutti i commenti si siano risolti nelle 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 tramite l'unione e la compilazione preliminari delle modifiche delle pull request.
Disattivato
Aggiungere, abilitare o disabilitare uno o più criteri per richiedere ad altri servizi di pubblicare uno stato positivo per considerare completate le richieste pull.
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 le autorizzazioni corrispondenti nel progetto. - Impostare le autorizzazioni del ramo o del repository: le autorizzazioni di gestione sono autorizzazioni per il ramo o il repository. - Modifica ramo predefinito: i criteri di modifica sono 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. |
| Tools | Opzionale. Usare i comandi az repos: CLI di Azure DevOps. |
Nota
Nei progetti pubblici, gli utenti con accesso Stakeholder hanno pieno accesso 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 selezionare la scheda Impostazioni o criteri .
Per configurare impostazioni e criteri per un repository specifico, selezionare la scheda Repository , selezionare il repository e quindi selezionare la scheda Impostazioni o Criteri .
Nella scheda Impostazioni è possibile definire le impostazioni per tutti i repository Git o per un singolo repository.
Nella scheda Criteri è possibile definire i 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 nella barra laterale selezionare Repository.
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 nella barra laterale selezionare Repository.
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.
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 nella barra laterale selezionare Repository.
Nella scheda Impostazioni della pagina Tutti i repository impostare Consenti agli utenti di gestire le autorizzazioni per i rami creati su Attivato o Disattivato.
Per abilitare o disabilitare questa impostazione per singoli repository:
Selezionare Impostazioni del Progetto>Repository, e quindi selezionare un repository.
<Nella pagina Nome> repository, nella scheda Impostazioni impostare Gestione delle autorizzazioni su Sì o No.
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 nella barra laterale selezionare Repository.
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 nella barra laterale selezionare Repository.
- Nella scheda Impostazioni della pagina Tutti i repository impostare Immagini Gravatarsu 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.
Nella barra laterale di Project Settings (Impostazioni progetto) selezionare Repository.
Nella scheda Repository della pagina Tutti i repository selezionare un repository.
<Nella pagina del Nome> repository, nella scheda Impostazioni, impostare Forks su Attivato oppure Disattivato.
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 pagina <Nome repository>, nella scheda Impostazioni, impostare le impostazioni su Attivo o Disattivo.
Collegamento delle menzioni del commit
Se abilitata, i messaggi di commit che contengono # seguito da 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. Con questa impostazione, è anche possibile 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 richieste pull.
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. È consigliabile abilitare questa impostazione se si fa affidamento sui fork degli utenti in Azure Repos.
Selezionare Impostazioni del Progetto>Repository, e quindi selezionare un repository.
Nella pagina <Nome repository>, nella scheda Impostazioni, impostare Strict Vote Mode su On o Off.
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 pagina del nome del> repository, nella scheda Impostazioni, in Disabilita repository impostare Disabilita repository su Attivato 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 del repository, assicurati di avere installato l'estensione.
Per aggiungere rami per la ricerca di codice:
Selezionare Impostazioni del Progetto>Repository, e quindi selezionare un repository.
Nella pagina <Nome repository>, nella scheda Impostazioni, in Rami ricercabili selezionare il segno + più.
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:
Nella barra laterale di Project Settings (Impostazioni progetto) selezionare Repository.
Nella pagina Tutti i repository, selezionare la scheda Politiche.
In Criteri di ramo, nella parte inferiore della pagina, selezionare il segno più +.
Nella schermata Aggiungi protezione ramo selezionare Proteggi il ramo predefinito di ogni repository o 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 Criteri tra repository per <il nome> del ramo impostare i criteri desiderati 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 pagina Tutti i repository o <nome repository>, nella scheda Criteri, in Criteri del repository impostare Convalida email dell'autore del commit su Attivato o Disattivato.
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 vuole configurare solo quel repository.
Nella pagina Tutti i repository o <Nome repository>, nella scheda Politiche, in Politiche repository, impostare Convalida percorso file su Attivo o Disattivo.
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 distingue tra maiuscole e minuscole, il che significa che un file chiamato Foo.txt è diverso da un file chiamato foo.txt. Tuttavia, per impostazione predefinita Windows e macOS sono file system senza distinzione tra maiuscole e minuscole, il che significa che Foo.txt e foo.txt sono lo stesso nome. 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 usa Windows o macOS, è consigliabile abilitare la politica di applicazione dei casi. L'applicazione della distinzione tra maiuscole e minuscole commuta il server dalla modalità predefinita sensibile alle maiuscole e minuscole, in cui File.txt e file.txt sono distinti, a una modalità compatibile con Windows e macOS, in cui File.txt e file.txt vengono considerati 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 e quindi ritentare il push.
Questa impostazione non risolve un repository che contiene già oggetti che differiscono solo per caso. È consigliabile risolvere questi problemi prima di abilitare la politica. Rinominare file e cartelle o ricreare rami e tag per usare nomi non conflittuali.
Per impostare un criterio di imposizione dei casi:
Selezionare Impostazioni progetto>Repository, e selezionare un repository se si vuole configurare solo quel repository.
Nella pagina Tutti i repository o <Nome repository> , nella scheda Criteri , in Criteri repository impostare Applicazione del caso 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 non sono validi, vedere Compatibilità multipiattaforma Git.
Per impostare i criteri dei nomi riservati:
Selezionare Impostazioni progetto>Repository, e selezionare un repository se si vuole configurare solo quel repository.
Nella pagina Tutti i repository o <Nome repository> , nella scheda Criteri , in Criteri repository impostare Nomi riservati su Sì o No.
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 di percorso non sono valide, vedere Compatibilità tra piattaforme Git. Quando si abilita questa impostazione, il valore massimo predefinito è 248. Tale valore è supportato in tutte e tre le principali piattaforme.
È 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 su 1016. Questo valore è supportato in entrambe le piattaforme. È 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 progetto>Repository, e selezionare un repository se si vuole configurare solo quel repository.
Nella pagina Tutti i repository o <Nome repository>, nella scheda Criteri, in Criteri repository impostare Lunghezza massima percorso su On o Off.
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 su come gestire 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 i criteri di dimensioni massime dei file:
Selezionare Impostazioni progetto>Repository, e selezionare un repository se si vuole configurare solo quel repository.
Nella pagina Tutti i repository o <Repository Name>, nella scheda Criteri, sotto Criteri repository, imposta Dimensione massima file su Attivato o Disattivato.
Se è stata attivata l'impostazione, selezionare una dimensione massima del file.
