Usare le etichette per creare uno snapshot dei file in Azure Repos

Articolo
04/04/2024

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

Visual Studio 2019 | Visual Studio 2022

le etichette controllo della versione di Team Foundation (TFVC) consentono di creare uno snapshot dei file. Successivamente, è possibile fare riferimento a tale snapshot. Usando l'etichetta, è possibile visualizzare, compilare o persino eseguire il rollback di un set di file di grandi dimensioni allo stato in cui si trovavano quando è stata applicata l'etichetta.

Prerequisiti

Per applicare un'etichetta, è necessario avere l'autorizzazione Etichetta impostata su Consenti.
Per trovare, elencare o visualizzare le etichette, è necessario disporre dell'autorizzazione Lettura impostata su Consenti.
Per modificare o eliminare un'etichetta, è necessario possedere l'etichetta o disporre dell'autorizzazione Amministrazione ister Labels impostata su Consenti.

Usare le etichette

In molti progetti software, quando il codice ha raggiunto un livello ragionevole di qualità e stabilità, il team compila e rilascia una nuova versione del prodotto. Il team deve contrassegnare la versione corrente di ogni file. Anche quando i file continuano a cambiare, il team può comunque ottenere e compilare la nuova versione di ogni file nel progetto.

Teoricamente, è possibile registrare manualmente l'ID di ogni set di modifiche per ogni file. Ma questo tipo di processo non è pratico. TFVC semplifica il processo. Applicare un'etichetta alla cartella, al ramo o al progetto che contiene i file. È possibile assegnare all'etichetta un nome che segue qualsiasi convenzione di denominazione preferita. Alcuni esempi di nomi di etichetta includono: "Sprint 5", "M1", "Beta2" e "Release Candidate 0".

Dopo aver applicato l'etichetta, è possibile usarla per qualificare operazioni quali compilazione, diramazione, unione, confronto e recupero di versioni specifiche di file e cartelle.

A volte dopo aver applicato un'etichetta, si decide di modificarla. TFVC consente di applicare un'etichetta ad altri file, rimuovere un'etichetta da determinati file e modificare la versione di un file specifico a cui si applica un'etichetta.

Suggerimento

L'applicazione di un'etichetta offre molti degli stessi vantaggi della creazione di un ramo, ma in genere con costi e complessità inferiori. Il compromesso è che per i database di grandi dimensioni, le operazioni come l'unione potrebbero richiedere molto più tempo del solito durante l'esecuzione su un'etichetta.

Applicare un'etichetta

Nota

Quando si usa Visual Studio per applicare un'etichetta già esistente, l'operazione rimuove l'etichetta da tutte le versioni dei file e quindi applica l'etichetta. Dal prompt dei comandi, tuttavia, l'operazione di etichetta è aggiuntiva. Vedere Comando Etichetta (controllo della versione di Team Foundation).

In Visual Studio scegliere Altro Esplora controllo del codice sorgente di Windows>dal menu Visualizza.
In Esplora controllo codice sorgente fare clic con il pulsante destro del mouse sulla raccolta, il progetto, il ramo, la cartella o il file a cui si vuole applicare un'etichetta e quindi selezionare Applica etichetta avanzata>. Verrà visualizzata la finestra di dialogo Nuova etichetta .
Nella casella Nome immettere un nome per l'etichetta.
(Facoltativo) Nella casella Commento immettere un commento.
Nell'elenco Versione è selezionata l'opzione Versione più recente per impostazione predefinita. Questa opzione è quella più usata in genere. Se è necessaria l'etichetta per specificare una versione specifica, selezionare una delle opzioni seguenti:
- Set di modifiche: specificare il numero del set di modifiche nella casella Set di modifiche. In alternativa, selezionare i puntini di sospensione (...) per aprire la finestra di dialogo Trova insiemi di modifiche. Per altre informazioni, vedere Trovare e visualizzare i set di modifiche.
- Data: specificare una data nella casella Data o selezionare una data dal calendario nel menu a discesa.
- Etichetta: specificare un'etichetta esistente per basare la nuova etichetta. Immettere il nome dell'etichetta nella casella Etichetta oppure selezionare i puntini di sospensione (...) per aprire la finestra di dialogo Trova etichetta . Per altre informazioni, vedere Trovare, modificare e rimuovere etichette.
- Versione dell'area di lavoro: creare l'etichetta per la versione nell'area di lavoro.
Quando si è soddisfatti delle impostazioni, eseguire una delle operazioni seguenti:
- Per applicare l'etichetta, selezionare Crea.
- Per applicare l'etichetta e quindi modificarla dopo l'applicazione, selezionare Crea e modifica. Questa azione applica l'etichetta e quindi visualizza la finestra Etichetta . Per altre informazioni sull'uso della finestra Etichetta per modificare un'etichetta, vedere Usare la finestra Etichetta per usare le etichette.

Nota

Quando si applica un'etichetta che usa un nome già esistente, il sistema avvisa e chiede se si vuole continuare. Se si seleziona OK per continuare, TFVC rimuove l'etichetta da tutti gli elementi che non si trovano nel percorso a cui si sta applicando l'etichetta.

Rinominare un'etichetta

Non è possibile modificare il nome di un'etichetta esistente. Tuttavia, è possibile applicare facilmente una nuova etichetta agli stessi file e alle stesse versioni a cui si applica un'altra etichetta.

In Esplora controllo del codice sorgente fare clic con il pulsante destro del mouse sul nodo della raccolta di progetti (il nodo radice) e quindi scegliere Advanced Apply Label (Applica etichetta avanzata>). Verrà visualizzata la finestra di dialogo Nuova etichetta .
Nella casella Nome immettere un nome per l'etichetta.
(Facoltativo) Nella casella Commento immettere un commento.
Nell'elenco Versione selezionare Etichetta. Viene visualizzata la casella Etichetta .
Eseguire uno dei passaggi seguenti:
- Immettere il nome dell'etichetta esistente.
- Se non si è certi del nome dell'etichetta esistente, selezionare il pulsante Sfoglia con i puntini di sospensione (...) accanto alla casella Etichetta . Verrà visualizzata la finestra di dialogo Trova etichetta . Usare le opzioni nella finestra di dialogo Trova etichetta per filtrare l'elenco delle etichette e trovare l'etichetta esistente a cui applicare la nuova etichetta. Per altre informazioni, vedere Trovare, modificare e rimuovere etichette.
Seleziona Crea.
(Facoltativo) Dopo aver creato la nuova etichetta, è possibile rimuovere l'etichetta precedente. Per altre informazioni, vedere Trovare, modificare e rimuovere etichette.

Elencare, trovare, visualizzare, modificare e rimuovere etichette

Esistono due modi per elencare e trovare etichette: la finestra di dialogo Trova etichetta e la scheda Etichetta nella finestra Cronologia . Dopo aver trovato l'etichetta a cui si è interessati, è possibile visualizzare, modificare o rimuoverla. È anche possibile usare i file a cui si applica l'etichetta.

Trovare e usare le etichette usando la finestra di dialogo Trova etichetta

Nella barra dei menu di Esplora controllo del codice sorgente selezionare Controllo>origine file>Trova>etichetta. Verrà visualizzata la finestra di dialogo Trova etichetta .
(Facoltativo) Perfezionare la ricerca eseguendo uno o più dei passaggi seguenti:
- Nella casella di testo Nome immettere il nome dell'etichetta.
- Nell'elenco Progetto selezionare il progetto che contiene l'etichetta che si desidera trovare.
- Nella casella di testo Proprietario immettere il nome o l'alias del proprietario dell'etichetta.
Seleziona Trova. Nell'elenco Risultati vengono visualizzate etichette che corrispondono ai criteri di ricerca immessi.
(Facoltativo) Eseguire una delle operazioni seguenti:
- Per visualizzare o modificare un'etichetta, selezionarla e selezionare Modifica. Verrà visualizzata la finestra Etichetta . Per altre informazioni, vedere Usare la finestra Etichetta per usare le etichette.
- Per eliminare un'etichetta, selezionarla e selezionare Elimina.
- Selezionare Chiudi.

Elencare e usare etichette applicabili a un elemento specifico

In alcuni casi potrebbe non essere sicuro del nome di un'etichetta, ma si sa che l'etichetta è stata applicata a un determinato elemento nel controllo della versione. La procedura seguente illustra come trovare e usare un'etichetta in questa situazione.

In Esplora controllo del codice sorgente fare clic con il pulsante destro del mouse su un elemento a cui è stata applicata l'etichetta e quindi selezionare Visualizza cronologia. Verrà visualizzata la finestra Cronologia .
Selezionare la scheda Etichette per visualizzare l'elenco di etichette applicabili a questo elemento.
(Facoltativo) Eseguire una delle operazioni seguenti:
- Per visualizzare o modificare un'etichetta, fare clic con il pulsante destro del mouse sull'etichetta e quindi scegliere Modifica etichetta. Verrà visualizzata la finestra Etichetta . Per informazioni su come usare questa finestra, vedere Usare la finestra Etichetta per usare le etichette.
- Per eliminare un'etichetta, fare clic con il pulsante destro del mouse sull'etichetta e quindi scegliere Elimina etichetta.
- Fare clic con il pulsante destro del mouse sull'etichetta e quindi selezionare un'altra azione, ad esempio Recupera questa versione o Confronta.

Per altre informazioni su come usare la scheda etichetta nella finestra Cronologia , vedere Ottenere la cronologia di un elemento.

Scaricare le versioni con etichetta dei file nell'area di lavoro

L'etichettatura di un set di file è simile alla creazione di uno snapshot della loro esistenza in un determinato momento. Settimane o mesi dopo l'acquisizione di questo snapshot, potrebbe essere necessario visualizzare o usare i file presenti nello snapshot. La procedura seguente illustra come scaricare le versioni etichettate di un set di file nell'area di lavoro.

In Esplora controllo codice sorgente fare clic con il pulsante destro del mouse sulla raccolta di progetti, il progetto, il ramo o la cartella che contiene gli elementi da scaricare e quindi selezionare Avanzate>Recupera versione specifica. Verrà visualizzata la finestra di dialogo Recupera .
Nell'elenco Tipo selezionare Etichetta e quindi immettere il nome dell'etichetta nella casella Etichetta oppure selezionare i puntini di sospensione (...) per aprire la finestra di dialogo Trova etichetta. Per altre informazioni su come usare questa finestra di dialogo, vedere Trovare, modificare e rimuovere etichette.
Selezionare qualsiasi altra opzione appropriata nella finestra di dialogo Recupera .
Selezionare Ottieni.

Usare la finestra Etichetta per usare le etichette

Dopo aver aperto la finestra Etichetta usando una delle procedure precedenti, è possibile iniziare a usare l'etichetta. Nella parte superiore della finestra viene visualizzato il commento, che è possibile modificare.

È possibile usare la finestra Etichetta per eseguire le attività seguenti:

Aggiungere un elemento all'etichetta
Rimuovere un elemento dall'etichetta
Modificare la versione di un file
Eseguire altre azioni su un elemento

Aggiungere un elemento all'etichetta

Nella finestra Etichetta selezionare Aggiungi elemento. Verrà visualizzata la finestra di dialogo Scegli versione elemento.
Nella finestra di dialogo Scegli versione elemento passare all'elemento da aggiungere e quindi selezionarlo.

Suggerimento

È possibile selezionare e tenere premuti i tasti CTRL o MAIUSC e quindi selezionare più elementi.
(Facoltativo) Se è necessaria l'etichetta per specificare una versione specifica, nell'elenco Versione selezionare una versione:
- Versione più recente: applicare l'etichetta alla versione più recente presente nel controllo della versione.
- Set di modifiche: specificare il numero di un insieme di modifiche nella casella Set di modifiche. In alternativa, selezionare i puntini di sospensione (...) per aprire la finestra di dialogo Trova insiemi di modifiche. Per altre informazioni, vedere Trovare e visualizzare i set di modifiche.
- Data: specificare una data nella casella Data o selezionare una data dal calendario nel menu a discesa.
- Etichetta: specificare un'etichetta esistente per basare la nuova etichetta. Immettere il nome dell'etichetta nella casella Etichetta oppure selezionare i puntini di sospensione (...) per aprire la finestra di dialogo Trova etichetta . Per altre informazioni, vedere Trovare, modificare e rimuovere etichette.
- Versione dell'area di lavoro: creare l'etichetta per la versione nell'area di lavoro.
Seleziona OK.
Seleziona File>Salva.

Rimuovere un elemento dall'etichetta

Nella finestra Etichetta individuare la raccolta, il progetto, il ramo, la cartella o il file da rimuovere da questa etichetta.
Fare clic con il pulsante destro del mouse sull'elemento e scegliere Rimuovi da Etichetta. L'etichetta viene rimossa dall'elemento. Se l'elemento è una raccolta di progetti, un progetto, un ramo o una cartella, l'etichetta viene rimossa anche da tutti gli elementi contenuti.
Seleziona File>Salva.

Modificare la versione di un file

Nella finestra Etichetta individuare il file da modificare.
Fare clic con il pulsante destro del mouse sul file e scegliere Cambia versione etichettata. Verrà visualizzata la finestra di dialogo Cambia versione etichettata.
Seleziona uno dei seguenti valori:
- Versione più recente: applicare l'etichetta alla versione più recente presente nel controllo della versione.
- Set di modifiche: specificare il numero del set di modifiche nella casella Set di modifiche. In alternativa, selezionare i puntini di sospensione (...) per aprire la finestra di dialogo Trova insiemi di modifiche. Per altre informazioni, vedere Trovare e visualizzare i set di modifiche.
- Data: specificare una data nella casella Data o selezionare una data dal calendario nel menu a discesa.
- Etichetta: specificare un'etichetta esistente per basare la nuova etichetta. Selezionare il nome dell'etichetta nella casella Etichetta oppure selezionare i puntini di sospensione (...) per aprire la finestra di dialogo Trova etichetta . Per altre informazioni, vedere Trovare, modificare e rimuovere etichette.
- Versione dell'area di lavoro: creare l'etichetta per la versione nell'area di lavoro.
Seleziona File>Salva.

Eseguire altre azioni su un elemento etichettato

Quando si fa clic con il pulsante destro del mouse su un elemento nella finestra Etichetta, è anche possibile selezionare uno dei comandi seguenti:

Lavorare dal prompt dei comandi

Usare il labels comando per elencare le etichette. Per altre informazioni, vedere Comando Etichette.
Usare il label comando per applicare o rimuovere un'etichetta. Per altre informazioni, vedere Comando etichetta (controllo della versione di Team Foundation).For more information, see Label command (controllo della versione di Team Foundation).

Suggerimento

Quando si usa il label comando per applicare un'etichetta, è possibile specificare un ambito diverso dal progetto.