Procédure pas à pas : utilisation du contrôle de version Team Foundation à partir de la ligne de commande

Article
08/21/2008

Mise à jour : novembre 2007

Cette procédure pas à pas explique comment utiliser le client de ligne de commande Visual Studio Team System Team Foundation Server, tf.exe, pour exécuter des opérations de contrôle de version.

Dans cette procédure pas à pas, vous effectuerez les tâches suivantes :

Créer l'espace de travail dans lequel vos copies personnelles des fichiers du serveur de contrôle de version seront conservées, puis obtenir une copie de source à partir du serveur.
Ajouter un fichier au serveur, puis extraire le fichier du serveur pour le modifier dans votre espace de travail.
Archiver les modifications en attente et créer un ensemble de modifications.
Faire revenir l'espace de travail à un instant précis en récupérant la source du serveur à l'état dans lequel elle se trouvait lors de la création d'un ensemble de modifications donné.

Composants requis

Si vous pouvez établir une connexion à un serveur Team Foundation Server et que vous disposez des autorisations appropriées, vous pouvez exécuter des commandes de contrôle de version à partir d'une invite de commandes, d'un fichier batch ou d'un fichier de script. Pour cela, vous devez utiliser l'utilitaire Invite de commandes de Visual Studio 2008 ou définir plusieurs variables d'environnement dans votre invite de commandes actuelle en utilisant vsvars32 comme décrit dans l'exemple suivant. Pour plus d'informations sur la façon de rejoindre un projet d'équipe, consultez Procédure pas à pas : rejoindre d'un projet d'équipe.

Pour ouvrir l'invite de commandes de Visual Studio 2008

Cliquez sur Démarrer, puis sur Tous les programmes, pointez sur Microsoft Visual Studio 2008, sur Visual Studio Tools, puis cliquez sur Invite de commandes de Visual Studio 2008.

Vous pouvez aussi exécuter vsvars32 au chemin d'installation de Visual Studio, généralement LettreLecteur:\Program Files\Microsoft Visual Studio 9.0\Common7\Tools.

Autorisations requises

Pour exécuter cette procédure pas à pas, vous devez disposer des autorisations CreateWorkspace, Archiver et PendChange.

Création d'un espace de travail

Pour commencer à travailler avec le contrôle de version, vous devez établir un espace de travail. Un espace de travail est une copie locale des fichiers et des dossiers sur le serveur. Lorsque vous ajoutez, modifiez, supprimez, déplacez, renommez un élément sous contrôle de version ou effectuez toute autre action sur celui-ci, vos modifications sont isolées dans votre espace de travail, ce qui vous permet de générer et de tester vos modifications en toute sécurité. Lors d'un archivage, ces modifications sont validées sur le serveur et disponibles en dehors de votre espace de travail.

Un espace de travail se compose d'une série de mappages. Chaque mappage associe un dossier du serveur à un dossier local du disque. Pour obtenir une copie locale des fichiers du serveur, créez un espace de travail et spécifiez les mappages pour l'espace de travail. Utilisez ensuite la commande get pour importer des fichiers sources dans votre espace de travail.

Avant de pouvoir exécuter des commandes du contrôle de version Team Foundation sur votre ordinateur, vous devez créer un espace de travail. L'espace de travail conserve le résultat de vos opérations et vous permet de les valider auprès du serveur en les archivant.

Pour créer un espace de travail pour la gestion de vos fichiers sous contrôle de version

Cliquez sur Démarrer, puis sur Tous les programmes, pointez sur Microsoft Visual Studio 2008, sur Visual Studio Tools, puis cliquez sur Invite de commandes de Visual Studio 2008.
Tapez mkdir c:\projects.
Tapez cd c:\projects.
Tapez tf workspace /new /s:servername, où servername est le nom de votre serveur Team Foundation Server (par exemple, tf workspace /new /s:/team1server), puis appuyez sur ENTRÉE.

Remarque :

S'il s'agit de votre première connexion au serveur, vous devez spécifier l'URL complète. Par exemple, spécifiez « http://team1server:8080 ».
Dans la boîte de dialogue Créer un espace de travail, saisissez un nom pour le nouvel espace de travail, par exemple « cmdwalkthrough ».
Sous la colonne Dossier du contrôle de code source, sélectionnez un projet d'équipe du serveur.

Vous pouvez cliquer sur les ellipses (…) pour parcourir les dossiers du serveur.

Le dossier sélectionné est mappé au dossier c:\\projects répertorié sous la colonne Dossier local.
Cliquez sur OK.

Remarque :
S'il s'agit de votre première connexion au serveur, vous devez spécifier l'URL complète. Par exemple, spécifiez « http://team1server:8080 ».

Vous pouvez afficher l'intégralité des espaces de travail créés sur l'ordinateur en tapant tf workspaces dans l'invite de commandes. Pour plus d'informations, consultez Workspaces, commande.

Lorsque vous créez un espace de travail, le système maintient une définition d'espace de travail pour cet espace de travail. Team Foundation Server stocke la définition d'espace de travail, et il répertorie tous les fichiers dans l'espace de travail, la version sur laquelle chacun est basé et également son état actuel. Les définitions d'espace de travail étant stockées sur le serveur, n'importe quel utilisateur disposant des autorisations appropriées peut donc dupliquer à l'identique votre environnement de travail sur son ordinateur, à l'exception des modifications en attente. Pour plus d'informations sur la manière de procéder, consultez Get, commande.

Ajouter et modifier un fichier

Une fois l'espace de travail créé, vous pouvez spécifier les fichiers à ajouter au contrôle de version. Vous pouvez ensuite les modifier avant d'archiver vos modifications.

Pour préparer un fichier pour ajout au contrôle de version

À l'invite de commandes, tapez notepad 314.cs, puis appuyez sur Entrée.
À l'invite du Bloc-notes Voulez-vous créer un nouveau fichier ?, cliquez sur Oui.
Dans le Bloc-notes, tapez using System.IO;, enregistrez vos modifications, puis fermez le Bloc-notes.
Dans l'invite de commandes, tapez tf add 314.cs pour ajouter le fichier à la liste des modifications en attente.
Tapez tf status pour confirmer l'addition en attente de 314.cs.

Vous pouvez utiliser cette commande pour afficher toutes les modifications en attente dans l'espace de travail actuel.

Dans Team Foundation, vous ne pouvez pas ajouter d'élément au serveur de contrôle de version en une seule étape. Vous devez d'abord ajouter un fichier à l'ensemble de modifications en attente dans l'espace de travail. Vous pouvez ensuite soumettre toutes les modifications en attente au serveur de contrôle de version comme une unité unique.

Team Foundation applique ce processus d'ajout de fichiers en deux étapes pour vous assurer de pouvoir tester et compiler votre code en contexte avant de l'archiver dans le serveur. Cela signifie également que si Team Foundation ne parvient pas à valider l'une de vos modifications apportées au serveur, quelle que soit la raison, aucune de vos modifications ne sera validée.

Archiver des modifications en attente

Lorsque vous archivez un ensemble de modifications en attente, Team Foundation crée un ensemble de modifications.

Pour archiver toutes les modifications en attente dans l'espace de travail

À l'invite de commandes, tapez tf checkin.
Dans la boîte de dialogue Archiver, tapez un commentaire décrivant la nature de vos modifications dans la zone Commentaire, puis cliquez sur Archiver.

Un ensemble de modifications est un conteneur logique dans lequel Team Foundation regroupe tout ce qui est lié à une même opération d'archivage. La plupart des archivages sont plus complexes que l'exemple simple fourni ici. Un archivage implique souvent des modifications à plusieurs fichiers et dossiers. Par conséquent, un ensemble de modifications représente un package complet de travail que vous pouvez importer dans votre espace de travail sous la forme d'une unité unique.

Un ensemble de modifications se compose des éléments suivants :

Des révisions de fichiers et de dossiers, telles que des additions, des changements de nom, des modifications, des suppressions et des déplacements.
Des éléments de travail connexes tels que des bogues.
Des métadonnées système tels que le numéro de l'ensemble de modifications, l'auteur, la date/heure, etc.
Des remarques et des commentaires sur l'archivage.

Ensuite, vous créerez une deuxième version du fichier 314.cs pour examiner comment les différentes versions d'un fichier sont stockées sur le serveur de contrôle de version.

Pour créer une nouvelle version d'un fichier dans le contrôle de version

À l'invite de commandes, tapez tf checkout 314.cs.
Tapez notepad 314.cs.
Dans le Bloc-notes, ajoutez une nouvelle ligne après using System.IO;, puis tapez using System.Windows;.

Remarque :

Cette étape introduit une erreur intentionnelle. Dans une étape ultérieure, vous apprendrez à revenir à la version exempte d'erreur du fichier.
Enregistrez vos modifications et fermez le Bloc-notes.
À l'invite de commandes, tapez tf checkin.
Dans la boîte de dialogue Archiver, entrez un commentaire dans la zone Commentaire et cliquez sur Archiver.

La modification en attente dans le fichier 314.cs est archivée dans le serveur sous la forme d'un nouvel ensemble de modifications. Cela crée également la version 2 du fichier 314.cs sur le serveur de contrôle de version.

Remarque :
Cette étape introduit une erreur intentionnelle. Dans une étape ultérieure, vous apprendrez à revenir à la version exempte d'erreur du fichier.

Récupérer une version antérieure d'un fichier

Les développeurs de logiciels sont souvent amenés à restaurer leurs environnements de travail à l'état dans lequel ils se trouvaient il y a plusieurs mois afin d'apporter un correctif ciblé à une build spécifique. Les numéros d'ensemble de modifications permettent d'identifier les ensembles de modifications spécifiques archivés au fil du temps.

Un numéro d'ensemble de modifications est un identificateur unique correspondant à un ensemble de révisions de fichiers et de dossiers connexes. Le numéro d'ensemble de modifications correspond également au numéro de version pour l'intégralité du serveur de contrôle de version à une date et une heure spécifiques.

Par conséquent, vous pouvez faire revenir votre espace de travail à l'état exact du serveur lorsque vous avez archivé cette ligne de code problématique, using System.Windows;.

Pour synchroniser un espace de travail à un ensemble de modifications

Dans l'invite de commandes, tapez tf get /version:C<##>, où <##> est le numéro de l'ensemble de modifications contenant la version d'origine de 314.cs.

Remarque :
Vous pouvez obtenir l'ensemble de modifications approprié en exécutant la commande history sur le fichier 314.cs. Par exemple, à la ligne de commande, tapez tf history 314.cs.

La commande Get permet d'extraire une copie de travail de tous les fichiers mappés et de tous les sous-dossiers du serveur dans l'espace de travail local. Les fichiers sont extraits dans l'état dans lequel ils se trouvaient lors de la création de l'ensemble de modifications <##>. Si vous ouvrez maintenant 314.cs dans le Bloc-notes, vous constatez qu'une seule ligne apparaît : « using System.IO; ».

Voir aussi

Partager via