Usare i tag Git

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

Azure DevOps supporta tag sia annotati che leggeri. I tag leggeri sono un puntatore a un commit specifico, mentre i tag con annotazioni contengono altre informazioni, ad esempio tagger, messaggio e data. È possibile creare tag con annotazioni usando il portale Web. È possibile creare tag leggeri e annotati da Visual Studio. Per altre informazioni sui tag Git, vedere 2.6 Git Basics - Tagging dal libro Pro Git.

Questo articolo offre una panoramica dell'uso dei tag Git in Azure DevOps e Visual Studio.

Importante

La visualizzazione Tag in Visual Studio è stata introdotta in Visual Studio 2017 Update 6. Se si riguardano versioni precedenti a questa, è possibile visualizzare e creare tag dalle visualizzazioni dettagli cronologia e commit a partire da Visual Studio 2015, ma non sarà possibile eseguire le operazioni nella visualizzazione Tag , come descritto in questo articolo.

Visualizzare e filtrare i tag

Browser

È possibile visualizzare i tag nella visualizzazione Tag e nella visualizzazione Commit nel portale Web.

Nota

Con Azure DevOps Services, il formato per l'URL del progetto è dev.azure.com/{your organization}/{your project}. Tuttavia, il formato precedente che fa riferimento al visualstudio.com formato è ancora supportato. Per altre informazioni, vedere Introduzione ad Azure DevOps, Cambiare le organizzazioni esistenti per usare il nuovo URL del nome di dominio.

Visualizzare i tag nella visualizzazione Tag

1. Per visualizzare i tag nel repository, passare al progetto nel portale Web, scegliere Repository, Tag e selezionare il repository desiderato.

   

   I tag con annotazioni vengono visualizzati con un nome di tag, un messaggio, un commit, un tagger e una data di creazione. I tag leggeri vengono visualizzati con un nome di tag e un commit.

2. Per filtrare l'elenco dei tag, digitare un termine di ricerca nella casella Nome tag di ricerca e premere INVIO.

   

Visualizzare i tag nella visualizzazione Commit

Per visualizzare i tag per un ramo specifico nella visualizzazione Commit , passare al repository nel portale Web, scegliere Repository, Commit e selezionare il ramo.

Visual Studio

Visualizzare i tag nella visualizzazione Cronologia

È possibile visualizzare i tag nella visualizzazione Cronologia .

1. Dal menu Git nella barra dei menu selezionare Gestisci rami.

2. Per visualizzare la cronologia, selezionare un ramo.

   

   Le forme rosse sono rami e le forme verdi sono tag.

Visualizzare i tag nella visualizzazione Tag

Nota

Visual Studio 2019 versione 16.8 e versioni successive offrono un nuovo menu Git per la gestione del flusso di lavoro Git con un cambio di contesto inferiore rispetto a Team Explorer. Le procedure fornite in questo articolo nella scheda Visual Studio forniscono informazioni per l'uso dell'esperienza Git e di Team Explorer. Per altre informazioni, vedere Confronto side-by-side di Git e Team Explorer.

1. Per visualizzare tutti i tag in un repository, selezionare Tag dalla visualizzazione Home .

   

2. I tag vengono visualizzati sotto il nome del repository attualmente connesso.

   

   I tag con annotazioni visualizzano una descrizione comando contenente il nome del tag, il tagger, la data del tag e il messaggio. I tag leggeri hanno solo il nome del tag nella descrizione comando.

   

   Per altre informazioni sul commit con tag, fare clic con il pulsante destro del mouse sul tag e selezionare Visualizza dettagli commit.

   

3. Per filtrare l'elenco dei tag, digitare un termine di ricerca in Digitare qui per filtrare la casella di riepilogo .

   

Per recuperare l'elenco corrente di tag dal repository di origine, eseguire un'operazione di recupero .

Crea tag

Per creare un tag, è necessario disporre dell'autorizzazione Crea tag , inclusa per impostazione predefinita nel gruppo Collaboratori e versioni successive.

Nota

I nomi dei tag non possono contenere caratteri di controllo ASCII, ad esempio spazi, tilde e due punti. È pratica comune usare caratteri minuscoli e separare le parole con un trattino. La lunghezza del nome del tag non deve superare i 250 caratteri ASCII. Per evitare ambiguità tra nomi di tag e hash di commit, non usare nomi di tag costituiti da 40 caratteri esadecimali. Per altre informazioni sulla denominazione dei tag, vedere git-check-ref-format.

Browser

È possibile creare tag con annotazioni usando il portale Web sia dalla visualizzazione Tag che dalla visualizzazione Commit .

Importante

È possibile creare tag con annotazioni solo nel portale Web o in Visual Studio. Per creare un tag leggero, è possibile usare la riga di comando Git.

Creare tag dalla visualizzazione Tag

1. Selezionare Crea tag dalla visualizzazione Tag nel portale Web per creare un nuovo tag con annotazioni.

   

2. Specificare un nome, selezionare il ramo da tag, immettere una descrizione (obbligatoria perché si sta creando un tag con annotazioni) e selezionare Crea.

   

3. Il nuovo tag viene visualizzato nell'elenco di tag.

   

Creare tag dalla visualizzazione Commit

Per creare un tag direttamente dalla visualizzazione commit, fare clic con il pulsante destro del mouse sul tag desiderato e scegliere Crea tag.

Visual Studio

È possibile creare tag annotati e leggeri in Visual Studio sia dalla visualizzazione Cronologia che dalla visualizzazione Tag . Per creare un tag con annotazioni, specificare sia un nome che un messaggio durante la creazione del tag. Per creare un tag leggero, omettere il messaggio e specificare solo un nome.

Creare tag dalla visualizzazione Cronologia

È possibile visualizzare i tag nella visualizzazione Cronologia .

1. Dal menu Git nella barra dei menu selezionare Gestisci rami.

2. Selezionare un ramo per visualizzare la cronologia, fare clic con il pulsante destro del mouse su un commit e selezionare Nuovo tag.

   

3. Nella finestra di dialogo Crea un nuovo tag immettere un nome tag solo per un tag leggero o un nome tag e un messaggio tag per un tag con annotazioni. Seleziona Crea.

Creare tag dalla visualizzazione Tag

Nota

Visual Studio 2019 versione 16.8 e versioni successive offrono un nuovo menu Git per la gestione del flusso di lavoro Git con un cambio di contesto inferiore rispetto a Team Explorer. Le procedure fornite in questo articolo nella scheda Visual Studio forniscono informazioni per l'uso dell'esperienza Git e di Team Explorer. Per altre informazioni, vedere Confronto side-by-side di Git e Team Explorer.

1. Selezionare Nuovo tag nella visualizzazione Tag per creare un nuovo tag.

   

2. Per creare un tag sulla punta del ramo corrente, specificare un nome nella casella Immettere un nome di tag, specificare facoltativamente un messaggio di tag e selezionare Crea tag.

   

   Per selezionare il ramo da cui creare il tag, deselezionare la casella di controllo Crea tag in base alla punta del ramo corrente e selezionare un ramo dall'elenco a discesa Seleziona un ramo .

   

3. Il nuovo tag viene creato in locale. Fare clic con il pulsante destro del mouse sul nuovo tag e scegliere Push per eseguirne il push nel repository remoto. Selezionare Push All (Esegui push tutto ) per eseguire il push di tutti i nuovi tag locali nel repository remoto.

   

È possibile creare tag annotati a livello di codice tramite l'API REST di Azure DevOps. Per creare tag tramite una pipeline di Azure usando il git tag comando . Per altre informazioni, vedere Git Tag.

Eliminare un tag

Importante

Prestare attenzione quando si eliminano tag dal repository. Se il repository è stato trascinato, copiato tramite fork o clonato da un altro utente, il tag continuerà a esistere nella copia del repository. È consigliabile eliminare solo i tag locali o se si è certi che il repository non sia stato estratto, clonato o copiato tramite fork dopo aver creato il tag.

Per eliminare un tag, è necessario disporre dell'autorizzazione Force push a livello di repository o del livello Tutti i tag (che eredita le relative autorizzazioni dal livello del repository se non impostato in modo esplicito). L'autore eredita anche le autorizzazioni di forza push per un tag.

Browser

Eliminare un tag nel repository remoto

I passaggi descritti in questa procedura illustrano come eliminare un tag nel repository remoto usando il portale Web di Azure DevOps Services.

1. Per eliminare un tag, selezionare i puntini di sospensione a destra del nome del tag e scegliere Elimina tag.

   

2. Seleziona Elimina per confermare.

   

3. Il tag viene eliminato e non verrà visualizzato al successivo passaggio alla visualizzazione Tag .

   

Visual Studio

Nota

Visual Studio 2019 versione 16.8 e versioni successive offrono un nuovo menu Git per la gestione del flusso di lavoro Git con un cambio di contesto inferiore rispetto a Team Explorer. Le procedure fornite in questo articolo nella scheda Visual Studio forniscono informazioni per l'uso dell'esperienza Git e di Team Explorer. Per altre informazioni, vedere Confronto side-by-side di Git e Team Explorer.

I passaggi di questa procedura illustrano come eliminare un tag nel repository locale usando Visual Studio 2019 Team Explorer.

Fare clic con il pulsante destro del mouse sul tag da eliminare e scegliere Elimina localmente

Importante

Se il tag è già stato eseguito il push nel repository remoto, non è consigliabile eliminarlo. Se il repository è stato trascinato, copiato tramite fork o clonato da un altro utente, il tag continuerà a esistere nella copia del repository. È consigliabile eliminare solo i tag locali.

Creare un ramo da un tag

Browser

1. Per creare un ramo da un tag, selezionare i puntini di sospensione a destra del nome del tag e scegliere Nuovo ramo.

   

2. Specificare un nome, selezionare facoltativamente gli elementi di lavoro da collegare e scegliere Crea ramo.

   

3. Il ramo viene creato e si viene inseriti nel nuovo ramo nel portale Web.

   

Visual Studio

I passaggi di questa procedura illustrano come creare un ramo da un tag usando Visual Studio 2019 Team Explorer. Per Visual Studio 2019 usando il menu Git o Visual Studio 2022, usare il browser.

Nota

Visual Studio 2019 versione 16.8 e versioni successive offrono un nuovo menu Git per la gestione del flusso di lavoro Git con un cambio di contesto inferiore rispetto a Team Explorer. Le procedure fornite in questo articolo nella scheda Visual Studio forniscono informazioni per l'uso dell'esperienza Git e di Team Explorer. Per altre informazioni, vedere Confronto side-by-side di Git e Team Explorer.

1. Per creare un ramo da un tag, fare clic con il pulsante destro del mouse sul tag e scegliere Nuovo ramo locale da. È anche possibile scegliere Crea ramo da tag.

   

2. Specificare un nome di ramo, verificare il tag desiderato e scegliere Crea ramo. Per estrarre il nuovo ramo, scegliere Checkout branch .To check out the new branch, choose Checkout branch.

   

3. Per visualizzare il ramo appena creato, selezionare Rami dalla visualizzazione Home .

   

4. Il nuovo ramo viene creato in locale. Per eseguire il push del ramo, fare clic con il pulsante destro del mouse e scegliere Push Branch (Push Branch).

   

Visualizzare la cronologia dei tag

Browser

1. Per visualizzare la cronologia di un tag, selezionare i puntini di sospensione a destra del nome del tag e scegliere Visualizza cronologia.

   

2. Viene visualizzata la visualizzazione commit per il tag.

   

Visual Studio

I passaggi di questa procedura illustrano come visualizzare la cronologia dei tag usando Visual Studio 2019 Team Explorer. Per Visual Studio 2019 usando il menu Git o Visual Studio 2022, usare il browser.

Nota

Visual Studio 2019 versione 16.8 e versioni successive offrono un nuovo menu Git per la gestione del flusso di lavoro Git con un cambio di contesto inferiore rispetto a Team Explorer. Le procedure fornite in questo articolo nella scheda Visual Studio forniscono informazioni per l'uso dell'esperienza Git e di Team Explorer. Per altre informazioni, vedere Confronto side-by-side di Git e Team Explorer.

1. Per visualizzare la cronologia di un tag, fare clic con il pulsante destro del mouse sul tag e scegliere Visualizza cronologia.

   

2. La cronologia viene visualizzata nella visualizzazione Cronologia .