Condividi tramite


Procedura dettagliata: utilizzo del controllo delle versioni di Team Foundation dalla riga di comando

Aggiornamento: novembre 2007

In questa procedura dettagliata viene descritto come utilizzare il client della riga di comando di Visual Studio Team System Team Foundation Server, tf.exe per eseguire operazioni di controllo della versione.

Nel corso di questa procedura dettagliata, l'utente completerà le seguenti attività:

  • Creare l'area di lavoro in cui collocare la copia personale dei file del server del controllo della versione, quindi acquisire una copia del database di origine dal server.

  • Aggiungere un file al server, quindi estrarlo dal server e modificarlo nell'area di lavoro.

  • Archiviare le modifiche in sospeso e creare un insieme di modifiche.

  • Riportare l'area di lavoro a un periodo di tempo specifico recuperando il codice sorgente dal server nel momento in cui è stato creato un determinato insieme di modifiche.

Prerequisiti

Se è possibile stabilire una connessione a Team Foundation Server e se si dispone delle autorizzazioni appropriate, è possibile eseguire i comandi di controllo della versione dal prompt dei comandi, da un file batch o da un file di script. A questo scopo, è necessario utilizzare l'utilità Prompt dei comandi di Visual Studio 2008 o impostare diverse variabili di ambiente nel prompt dei comandi corrente utilizzando vsvars32, come descritto nell'esempio riportato di seguito. Per ulteriori informazioni sull'unione a un progetto Team, vedere Procedura dettagliata: connessione a un progetto Team.

Per aprire il prompt dei comandi di Visual Studio 2008

  • Fare clic sul pulsante Start, scegliere Tutti i programmi, Microsoft Visual Studio 2008, Visual Studio Tools, quindi Prompt dei comandi di Visual Studio 2008.

In alternativa, è possibile eseguire vsvars32 nel percorso di installazione di Visual Studio che in genere è LetteraUnità:\Programmi\Microsoft Visual Studio 9.0\Common7\Tools.

Autorizzazioni necessarie

Per completare questa procedura dettagliata, è necessario disporre delle autorizzazioni CreateWorkspace, Checkin e PendChange.

Creazione di un'area di lavoro

Per iniziare a utilizzare il controllo della versione, è necessario stabilire un'area di lavoro, ovvero una copia locale dei file e delle cartelle sul server. Quando si aggiunge, modifica, elimina, sposta, rinomina o cambia in altro modo un elemento con controllo della versione, le modifiche vengono isolate nell'area di lavoro e possono essere compilate e testate in sicurezza. Quando si effettua un'archiviazione, viene eseguito il commit di queste modifiche sul server e vengono rese disponibili al di fuori dell'area di lavoro.

Un'area di lavoro è costituita da una serie di mapping, ognuno dei quali consente di associare una cartella del server a una cartella locale del disco. Per ottenere una copia locale dei file dal server, creare una nuova area di lavoro e specificarne i mapping. Quindi utilizzare il comando get per popolare l'area di lavoro con i file di origine.

Prima di poter eseguire i comandi di Controllo della versione di Team Foundation sul computer, è necessario creare un'area di lavoro. Nell'area di lavoro è possibile conservare in modo permanente l'output delle operazioni ed eseguirne il commit sul server, archiviandole.

Per creare un'area di lavoro e gestire i file con controllo della versione

  1. Fare clic sul pulsante Start, scegliere Tutti i programmi, Microsoft Visual Studio 2008, Visual Studio Tools, quindi Prompt dei comandi di Visual Studio 2008.

  2. Digitare mkdir c:\projects.

  3. Digitare cd c:\projects.

  4. Digitare tf workspace /new /s:servername, dove servername è il nome del server Team Foundation Server, ad esempio tf workspace /new /s:/team1server, quindi premere INVIO.

    Nota:

    Se si sta effettuando la prima connessione al server, è necessario specificare l'URL completo, ad esempio, "http://team1server:8080".

  5. Nella finestra di dialogo Crea area di lavoro, digitare un nome per la nuova area di lavoro, ad esempio "proceduradettagliatacmd".

  6. Nella colonna Cartella del controllo del codice sorgente, selezionare un progetto team del server.

    È possibile fare clic sui punti di sospensione (...) per sfogliare le cartelle del server.

    Verrà eseguito il mapping della cartella selezionata alla cartella c:\progetti elencata nella colonna Cartella locale.

  7. Scegliere OK.

È possibile visualizzare tutte le aree di lavoro create sul computer in uso digitando tf workspaces al prompt dei comandi. Per ulteriori informazioni, vedere Comando Workspaces.

Quando si crea un'area di lavoro, il sistema gestisce una definizione per quell'area di lavoro. Team Foundation Server archivia la definizione dell'area di lavoro ed elenca tutti i file nell'area di lavoro, la versione di ogni file e lo stato corrente. Poiché le definizioni dell'area di lavoro vengono archiviate sul server, gli utenti che dispongono delle autorizzazioni corrette possono duplicare sul proprio computer l'esatto ambiente di lavoro di un altro utente, tranne le modifiche in sospeso. Per ulteriori informazioni su tale procedura, vedere Comando Get.

Aggiungere e modificare un file

Dopo avere creato un'area di lavoro, è possibile specificare i file che si desidera aggiungere al controllo della versione. Quindi, è possibile modificarli, prima di archiviare le modifiche.

Per preparare un file all'aggiunta al controllo della versione

  1. Al prompt dei comandi digitare notepad 314.cs e premere Invio.

  2. Quando nel Blocco note viene visualizzato il messaggio Creare un nuovo file?, fare clic su Sì.

  3. Nel Blocco note digitare using System.IO;, salvare le modifiche, quindi chiudere il Blocco note.

  4. Al prompt dei comandi, digitare tf add 314.cs per aggiungere il file all'elenco dellemodifiche in sospeso.

  5. Digitare tf status per confermare l'aggiunta in sospeso di 314.cs.

    È possibile utilizzare questo comando per visualizzare tutte le modifiche in sospeso nell'area di lavoro corrente.

In Team Foundation, non è possibile aggiungere un elemento al server di controllo della versione in un unico passaggio. Innanzitutto, è necessario aggiungere un file all'insieme dellemodifiche in sospeso nell'area di lavoro. Quindi, tutte le modifiche in sospeso devono essere inviate al server di controllo della versione come una singola unità.

In Team Foundation viene applicato questo processo di aggiunta file in due passaggi per assicurare la possibilità di testare e compilare il codice nel contesto prima di archiviarlo sul server. In questo modo, nel caso in cui, per una ragione qualunque, per Team Foundation non sia possibile eseguire il commit sul server di una qualsiasi delle modifiche, questa operazione non sarà effettuata per nessuna delle modifiche.

Archiviare modifiche in sospeso

Quando si archivia un insieme di modifiche in sospeso, in Team Foundation viene creato un insieme di modifiche.

Per archiviare tutte le modifiche in sospeso nell'area di lavoro

  1. Al prompt dei comandi digitare tf checkin.

  2. Nella finestra di dialogo Archivia digitare nella casella Commento un commento che descriva la natura delle modifiche, quindi fare clic su Archivia.

Un insieme di modifiche è un contenitore logico in cui Team Foundation raccoglie tutti i dati correlati a una singola operazione di archiviazione. La maggior parte delle archiviazioni è più complicata rispetto all'esempio presentato. Un'archiviazione comporta spesso modifiche a più file e cartelle. Pertanto, un insieme di modifiche rappresenta un package di lavoro completo che è possibile inserire nell'area di lavoro come unità singola.

Un insieme di modifiche consiste di:

  • Revisioni di cartelle e file di origine, quali aggiunte, ridenominazioni, modifiche, eliminazioni e spostamenti.

  • Elementi di lavoro correlati, quali i bug.

  • Metadati di sistema, quali numero, autore, data e ora dell'insieme di modifiche e altro.

  • Commenti e note di archiviazione.

Successivamente, verrà creata una seconda versione del file 314.cs per esaminare il modo in cui versioni diverse di un file vengono archiviate sul server di controllo della versione.

Per creare una nuova versione di un file presente nel controllo della versione

  1. Al prompt dei comandi digitare tf checkout 314.cs.

  2. Digitare notepad 314.cs.

  3. Nel Blocco note aggiungere una nuova riga dopo using System.IO;, quindi digitare using System.Windows;.

    Nota:

    Con questo passaggio viene intenzionalmente introdotto un errore. In uno dei passaggi successivi verrà illustrato come ripristinare la versione senza errori del file.

  4. Salvare le modifiche e chiudere il Blocco note.

  5. Al prompt dei comandi digitare tf checkin.

  6. Digitare un commento nella casella Commento della finestra di dialogo Archivia, quindi fare clic su Archivia.

    La modifica in sospeso del file 314.cs viene archiviata sul server come un nuovoinsieme di modifiche. In questo modo, viene creata anche la versione 2 del file 314.cs sul server di controllo della versione.

Riportare un file a una versione precedente

Agli sviluppatori software viene spesso chiesto di ripristinare gli ambienti di lavoro di alcuni mesi prima per apportare una correzione mirata a una build specifica. I numeri degli insiemi di modifiche consentono di individuare insiemi specifici di modifiche archiviate nel tempo.

Un numero di insieme di modifiche è un identificatore univoco di un insieme di revisioni di file e cartelle correlati. Rappresenta inoltre un numero di versione di tutto il server di controllo della versione in una data e a un'ora specifiche.

È pertanto possibile ripristinare per l'area di lavoro lo stato esatto del server nel momento in cui è stata eseguita l'archiviazione di tale riga di codice problematica, ovvero using System.Windows;.

Per sincronizzare un'area di lavoro con un insieme di modifiche

  • Al prompt dei comandi, digitare tf get /version:C<##>, dove <##> è il numero dell'insieme di modifiche che contiene la versione originale del file 314.cs.

    Nota:

    È possibile ottenere l'insieme di modifiche corretto utilizzando il comando history per il file 314.cs, digitando ad esempio tf history 314.cs dalla riga di comando.

Il comandoGet consente di recuperare una copia di lavoro di tutti i file e le sottocartelle di cui è stato eseguito il mapping dal server all'area di lavoro locale. I file vengono recuperati nello stato in cui erano al momento della creazione dell'insieme di modifiche < ##>. Se si apre il file 314.cs nel Blocco note, viene visualizzata solo la riga "using System.IO;".

Vedere anche

Attività

Procedura dettagliata: esplorazione del controllo della versione di Team Foundation

Procedura dettagliata: sospensione degli elementi di controllo della versione

Procedura: sospendere e riprendere le modifiche in sospeso

Riferimenti

Comando Add

Comando Workspace

Comando Unshelve

Altre risorse

Procedure dettagliate relative al controllo delle versioni di Team Foundation

Riferimenti alla riga di comando del controllo della versione di Team Foundation