Utiliser des étiquettes pour prendre un instantané de vos fichiers dans Azure Repos

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

Visual Studio 2019 | Visual Studio 2022

Les étiquettes Team Foundation Version Control (TFVC) vous permettent d’effectuer une capture instantanée de vos fichiers. Plus tard, vous pourrez vous référer à cette capture instantanée. En utilisant l'étiquette, vous pouvez afficher, générer ou restaurer un grand ensemble de fichiers dans l'état dans lequel ils se trouvaient lorsque vous avez appliqué l'étiquette.

Prérequis

• Pour appliquer une étiquette, l’autorisation Étiquette doit avoir la valeur Autoriser.
• Pour rechercher, répertorier ou afficher des étiquettes, l’autorisation Lire doit avoir la valeur Autoriser.
• Pour modifier ou supprimer une étiquette, vous devez être propriétaire de l’étiquette ou l’autorisation Administrer les étiquettes doit avoir la valeur Autoriser.

Utiliser des étiquettes

Dans de nombreux projets logiciels, lorsque le code a atteint un niveau raisonnable de qualité et de stabilité, l’équipe génère et publie une nouvelle version du produit. L’équipe doit marquer la version actuelle de chaque fichier. Même si les fichiers continuent de changer, l’équipe peut toujours obtenir et générer la nouvelle version de chaque fichier dans son projet.

En théorie, vous pouvez enregistrer l’ID de chaque ensemble de modifications pour chaque fichier manuellement. Mais ce genre de processus n’est pas pratique. TFVC facilite la tâche. Appliquez une étiquette au dossier, à la branche ou au projet qui contient les fichiers. Vous pouvez donner à l'étiquette un nom qui suit la convention d'affectation de noms de votre choix. Voici quelques exemples de noms d’étiquettes : « Sprint 5 », « M1 », « Beta2 » et « Release Candidate 0 ».

Après avoir appliqué l’étiquette, vous pouvez l’utiliser pour qualifier des opérations telles que la génération, la création, la fusion, la comparaison et l’obtention de versions spécifiques de fichiers et de dossiers.

Parfois, après avoir appliqué une étiquette, vous décidez que vous devez la modifier. TFVC vous permet d’appliquer une étiquette à des fichiers supplémentaires, de supprimer une étiquette de certains fichiers et de modifier la version d’un fichier spécifique auquel une étiquette s’applique.

Conseil

L’application d’une étiquette fournit quasiment les mêmes avantages que la création d’une branche pour un coût et une complexité généralement moins élevés. Le compromis est que pour les grandes bases de données, les opérations telles que la fusion peuvent prendre beaucoup plus de temps que d’habitude lors de l’exécution sur une étiquette.

Appliquer une étiquette

Notes

Lorsque vous utilisez Visual Studio pour appliquer une étiquette qui existe déjà, l'opération supprime cette étiquette de toutes les versions de fichier, puis applique la nouvelle étiquette. À partir de la ligne de commande, toutefois, cette opération est incrémentielle. Consultez la commande Étiquette (Team Foundation Version Control).

1. Dans Visual Studio, dans le menu Affichage, sélectionnez Autres fenêtres>Explorateur du contrôle de code source.

2. Dans l’Explorateur du contrôle de code source, cliquez avec le bouton droit sur la collection, le projet, la branche, le dossier ou le fichier auquel vous souhaitez appliquer une étiquette, puis sélectionnezAvancé>Appliquer l’étiquette. La boîte de dialogue Nouvelle étiquette apparaît.

3. Dans la boîte de dialogue Nom, entrez un nom pour l’étiquette.

4. (Facultatif) Dans la zone Commentaire , entrez un commentaire.

5. Dans la liste Version, la Dernière version est sélectionnée par défaut. Cette option est celle qui est la plus généralement utilisée. Si vous avez besoin de l’étiquette pour cibler une version spécifique, sélectionnez l’une des options suivantes :

   • Ensemble de modifications: définissez le nombre du jeu de modifications dans la boîte de dialogue Ensemble de modifications. Vous pouvez également sélectionner les points de suspension (...) pour ouvrir la boîte de dialogue Rechercher des ensembles de modifications. Pour plus d’informations, consultez Rechercher et afficher des ensembles de modifications.

   • Date : définissez une date dans la zone Date ou sélectionnez une date dans le calendrier du menu déroulant.

   • Étiquette: définissez une étiquette existante sur laquelle baser la nouvelle étiquette. Entrez le nom de l’étiquette dans la zone Étiquette, ou sélectionnez les points de suspension (...) pour ouvrir la boîte de dialogue Rechercher l’étiquette. Pour plus d’informations, consultez Rechercher, modifier et supprimer des étiquettes.

   • Version de l’espace de travail : créez l’étiquette de la version dans votre espace de travail.

6. Lorsque les paramètres vous conviennent, exécutez l’une des étapes suivantes :

   • Pour appliquer l’étiquette, sélectionnez Créer.

   • Pour appliquer l’étiquette et la modifier après qu’elle a été appliquée, cliquez sur Créer et Modifier. L’étiquette est alors appliquée, puis la fenêtre Étiquette apparaît. Pour plus d’informations sur l’utilisation de la fenêtre Étiquette pour modifier une étiquette, consultez Utiliser la fenêtre Étiquette pour utiliser des étiquettes.

Notes

Lorsque vous appliquez une étiquette qui utilise un nom qui existe déjà, le système vous avertit et vous demande si vous souhaitez continuer. Si vous sélectionnez OK pour continuer, TFVC supprime cette étiquette de tous les éléments qui ne se trouve pas dans le chemin d’accès auquel vous appliquez l’étiquette.

Renommer une étiquette

Vous ne pouvez pas modifier le nom d’une étiquette existante. Mais vous pouvez facilement appliquer une nouvelle étiquette aux mêmes fichiers et versions qu’une autre étiquette.

1. Dans l’Explorateur du contrôle de code source, cliquez avec le bouton droit sur le nœud de collection de projets (le nœud racine), puis sélectionnez Avancé>Appliquer l’étiquette. La boîte de dialogue Nouvelle étiquette apparaît.

2. Dans la boîte de dialogue Nom, entrez un nom pour l’étiquette.

3. (Facultatif) Dans la zone Commentaire , entrez un commentaire.

4. Dans liste Version, sélectionnez Étiquette. La boîte de dialogue Étiquette apparaît.

5. Exécutez l’une des étapes suivantes :

   • Entrez le nom de l’étiquette existante.

   • Si vous n’êtes pas sûr du nom de l’étiquette existante, sélectionnez le bouton pour parcourir avec les points de suspension (...) à côté de la boîte de dialogue Étiquette. La boîte de dialogue Rechercher l’étiquette apparaît. Utilisez les options de la boîte de dialogue Rechercher une étiquette pour filtrer la liste des étiquettes et rechercher l’étiquette existante à laquelle vous souhaitez appliquer la nouvelle étiquette. Pour plus d’informations, consultez Rechercher, modifier et supprimer des étiquettes.

6. Sélectionnez Create (Créer).

7. (Facultatif) Après avoir créé l’étiquette, vous pouvez supprimer l’ancienne étiquette. Pour plus d’informations, consultez Rechercher, modifier et supprimer des étiquettes.

Répertorier, rechercher, afficher, modifier et supprimer des étiquettes

Il existe deux façons de répertorier et de rechercher des étiquettes : la boîte de dialogue Rechercher l’étiquette et l’onglet Étiquette de dans la fenêtre Historique. Une fois que vous avez trouvé l’étiquette qui vous intéresse, vous pouvez l’afficher, la modifier ou la supprimer. Vous pouvez également utiliser les fichiers auxquels l’étiquette s’applique.

Rechercher et utiliser des étiquettes à l'aide de la boîte de dialogue Rechercher une étiquette

1. Dans l’Explorateur du contrôle de code source, dans la barre de menus, sélectionnez Fichier>Contrôle de code source>Rechercher>Rechercher une étiquette. La boîte de dialogue Rechercher l’étiquette apparaît.

2. (Facultatif) Affinez votre recherche en exécutant une ou plusieurs des étapes suivantes :

   • Dans la zone de texte Nom, entrez le nom de l’étiquette.

   • Dans la liste Project, sélectionnez le projet qui contient l’étiquette que vous souhaitez rechercher.

   • Dans la zone de texte Propriétaire , entrez le nom ou l’alias du propriétaire de l’étiquette.

3. Sélectionnez Rechercher. La liste Résultats affiche les étiquettes qui correspondent aux critères de recherche que vous avez entrés.

4. (Facultatif) Effectuez l’une des étapes suivantes :

   • Pour afficher ou modifier une étiquette, sélectionnez-la et sélectionnez Modifier. La fenêtre Étiquette apparaît. Pour plus d’informations, consultez Utiliser la fenêtre Étiquette pour utiliser des étiquettes.

   • Pour supprimer une étiquette, sélectionnez-la et choisissez Supprimer.

   • Sélectionnez Fermer.

Répertorier et utiliser des étiquettes qui s'appliquent à un élément spécifique

Il peut arriver que vous ne soyez pas certain du nom d’une étiquette, mais que vous sachiez que l’étiquette a été appliquée à un élément particulier sous la gestion de version. La procédure suivante explique comment trouver et utiliser une étiquette dans cette situation.

1. Dans l’Explorateur du contrôle de code source, cliquez avec le bouton droit sur un élément auquel l’étiquette a été appliquée, puis sélectionnez Afficher l’historique. La fenêtre Historique s’affiche.

2. Sélectionnez l’onglet Étiquettes pour afficher la liste des étiquettes qui s’appliquent à cet élément.

3. (Facultatif) Effectuez l’une des étapes suivantes :

   • Pour afficher ou modifier une étiquette, cliquez avec le bouton droit sur l’étiquette, puis sélectionnez Modifier l’étiquette. La fenêtre Étiquette apparaît. Pour plus d’informations sur l’utilisation de cette fenêtre, consultez Utiliser la fenêtre Étiquette pour utiliser des étiquettes.

   • Pour supprimer une étiquette, cliquez avec le bouton droit sur l’étiquette, puis sélectionnez Supprimer l’étiquette.

   • Cliquez avec le bouton droit sur l’étiquette, puis sélectionnez une autre action telle qu’Obtenir cette version ou Comparer.

Pour plus d’informations sur l’utilisation de l’onglet Étiquette dans la fenêtre Historique, consultez Obtenir l’historique d’un élément.

Télécharger des versions étiquetées des fichiers dans votre espace de travail

L'étiquetage d'un jeu de fichiers revient à prendre un instantané de ces fichiers à un point précis dans le temps. Des semaines ou des mois après avoir pris cette capture instantanée, vous devrez peut-être afficher ou utiliser les fichiers tels qu’ils existaient dans cette capture instantanée. La procédure suivante explique comment télécharger les versions étiquetées d'un jeu de fichiers dans votre espace de travail.

1. Dans l’Explorateur du contrôle de code source, cliquez avec le bouton droit sur la collection de projets, le projet, la branche ou le dossier qui contient les éléments que vous souhaitez télécharger, puis sélectionnez Avancé>Obtenir une version spécifique. La boîte de dialogue Obtenir apparaît.

2. Dans la liste Type, sélectionnez Étiquette, puis entrez le nom de l’étiquette dans la zone Étiquette, ou sélectionnez les points de suspension (...) pour ouvrir la boîte de dialogue Rechercher l’étiquette. Pour plus d’informations sur l’utilisation de cette boîte de dialogue, consultez Rechercher, modifier et supprimer des étiquettes.

3. Sélectionnez les autres options appropriées dans la boîte de dialogue Obtenir.

4. Sélectionnez Obtenir.

Utiliser la fenêtre Étiquette pour utiliser des étiquettes

Une fois que vous avez ouvert la fenêtre Étiquette à l’aide de l’une des procédures précédentes, vous êtes prêt à commencer à utiliser l’étiquette. Dans la partie supérieure de la fenêtre, une zone affiche le commentaire, que vous pouvez modifier.

Vous pouvez utiliser la fenêtre Étiquette pour effectuer les tâches suivantes :

• Ajouter un élément à l'étiquette
• Supprimer un élément de l'étiquette
• Modifier la version d'un fichier
• Exécuter d'autres actions sur un élément

Ajouter un élément à l'étiquette

1. Dans la fenêtre Étiquette, sélectionnez Ajouter un élément. La boîte de dialogue Choisir la version d’élément apparaît.

2. Dans la boîte de dialogue Choisir la version d’élément, accédez à l’élément que vous souhaitez ajouter, puis sélectionnez-le.

   Conseil

   Vous pouvez sélectionner et maintenir les touches Ctrl ou Maj, puis sélectionner plusieurs éléments.

3. (Facultatif) Si vous avez besoin de l’étiquette pour cibler une version spécifique, dans la liste Version, sélectionnez une version :

   • Dernière version : appliquez l’étiquette à la dernière version du contrôle de version.

   • Ensemble de modifications: définissez le nombre d’un ensemble de modifications dans la zone Ensemble de modifications . Vous pouvez également sélectionner les points de suspension (...) pour ouvrir la boîte de dialogue Rechercher des ensembles de modifications. Pour plus d’informations, consultez Rechercher et afficher des ensembles de modifications.

   • Date : définissez une date dans la zone Date ou sélectionnez une date dans le calendrier du menu déroulant.

   • Étiquette: définissez une étiquette existante sur laquelle baser la nouvelle étiquette. Entrez le nom de l’étiquette dans la zone Étiquette, ou sélectionnez les points de suspension (...) pour ouvrir la boîte de dialogue Rechercher l’étiquette. Pour plus d’informations, consultez Rechercher, modifier et supprimer des étiquettes.

   • Version de l’espace de travail : créez l’étiquette de la version dans votre espace de travail.

4. Sélectionnez OK.

5. Sélectionnez Fichier>Enregistrer.

Supprimer un élément de l'étiquette

1. Dans la fenêtre Étiquette, recherchez la collection, le projet, la branche, le dossier ou le fichier que vous souhaitez supprimer de cette étiquette.

2. Cliquez avec le bouton droit sur l’élément et sélectionnez Supprimer de l’étiquette. L'étiquette est supprimée de l'élément. Si l’élément est une collection de projets, un projet, une branche ou un dossier, l’étiquette est également supprimée de tous les éléments qu’il contient.

3. Sélectionnez Fichier>Enregistrer.

Modifier la version d'un fichier

1. Dans la fenêtre Étiquette, localisez le fichier que vous souhaitez modifier.

2. Cliquez avec le bouton droit sur le fichier et sélectionnez Modifier la version étiquetée. La boîte de dialogue Modifier la version étiquetée apparaît.

3. Sélectionnez l'une des valeurs suivantes :

   • Dernière version : appliquez l’étiquette à la dernière version du contrôle de version.

   • Ensemble de modifications: définissez le nombre du jeu de modifications dans la boîte de dialogue Ensemble de modifications. Vous pouvez également sélectionner les points de suspension (...) pour ouvrir la boîte de dialogue Rechercher des ensembles de modifications. Pour plus d’informations, consultez Rechercher et afficher des ensembles de modifications.

   • Date : définissez une date dans la zone Date ou sélectionnez une date dans le calendrier du menu déroulant.

   • Étiquette: définissez une étiquette existante sur laquelle baser la nouvelle étiquette. Sélectionnez le nom de l’étiquette dans la zone Étiquette ou sélectionnez les points de suspension (...) pour ouvrir la boîte de dialogue Rechercher l’étiquette. Pour plus d’informations, consultez Rechercher, modifier et supprimer des étiquettes.

   • Version de l’espace de travail : créez l’étiquette de la version dans votre espace de travail.

4. Sélectionnez Fichier>Enregistrer.

Exécuter d'autres actions sur un élément étiqueté

Lorsque vous cliquez avec le bouton droit sur un élément dans la fenêtre Étiquette, vous pouvez également sélectionner l’une des commandes suivantes :

• Afficher (fichiers uniquement)
• Afficher l’historique
• Comparer (fichiers uniquement)
• Annoter (fichiers uniquement)
• Obtenir cette version

Travailler depuis l'invite de commandes

• Utilisez la commande labels pour répertorier les étiquettes. Pour plus d’informations, consultez la commande Étiquettes.

• Utilisez la commande label pour appliquer ou supprimer une étiquette. Pour plus d’informations, consultez la commande Étiquette (Team Foundation Version Control).

  Conseil

  Lorsque vous utilisez la commande label pour appliquer une étiquette, vous pouvez définir une étendue autre que le projet.

Étapes suivantes

• Rechercher et afficher des ensembles de modifications
• Créer et utiliser des espaces de travail
• Informations de référence sur les autorisations et les groupes
• Utiliser les branches pour isoler le risque dans le contrôle de version Team Foundation
• Utiliser l’Explorateur du contrôle de code source pour gérer les fichiers sous gestion de version