Partager via

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

  • Article

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

Visual Studio 2019 | Visual Studio 2022

Les étiquettes TFVC (Team Foundation Version Control) vous permettent de prendre un instantané de vos fichiers. Plus tard, vous pouvez revenir à cet instantané. En utilisant votre étiquette, vous pouvez afficher, générer ou même restaurer un grand ensemble de fichiers à l’état dans lequel ils se trouvaient lorsque vous avez appliqué l’étiquette.

Conditions préalables

  • 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 posséder l’étiquette ou disposer de l’autorisation Administrer les étiquettes définie sur 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 le travail. 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 que vous préférez. 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 offre un grand nombre des mêmes avantages que la création d’une branche, mais généralement avec un coût et une complexité moindres. 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

Remarque

Lorsque vous utilisez Visual Studio pour appliquer une étiquette qui existe déjà, l’opération supprime l’étiquette de toutes les versions de fichier, puis applique l’é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 de contrôle de code source.

  2. Dans l’Explorateur de 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électionnez Advanced>Apply Label. La boîte de dialogue Nouvelle étiquette s’affiche.

  3. Dans la zone Nom, entrez un nom pour l’étiquette.

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

  5. Dans la liste Version, dernière version est sélectionnée par défaut. Cette option est la plus 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: spécifiez une date dans la zone Date ou sélectionnez une date dans le calendrier dans le menu déroulant.

    • Étiquette: spécifiez 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 vous êtes satisfait de vos paramètres, effectuez l’une des étapes suivantes :

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

    • Pour appliquer l’étiquette, puis la modifier une fois qu’elle a été appliquée, sélectionnez 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.

Remarque

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 continuer, TFVC supprime cette étiquette des éléments qui ne figurent pas dans le chemin auquel vous appliquez l’étiquette.

Renommer une étiquette

Vous ne pouvez pas modifier le nom d’une étiquette existante. Toutefois, vous pouvez facilement appliquer une nouvelle étiquette aux mêmes fichiers et aux mêmes versions auxquelles une autre étiquette s’applique.

  1. Dans l’Explorateur de contrôles de code source, cliquez avec le bouton droit sur le nœud de collection de projets (le nœud racine), puis sélectionnez Advanced>Apply Label. La boîte de dialogue Nouvelle étiquette s’affiche.

  2. Dans la zone 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. Effectuez 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 s’affiche. Utilisez les options de la boîte de dialogue Rechercher l’é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 Créer.

  7. (Facultatif) Une fois que vous avez créé la nouvelle é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 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 de contrôles 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 s’affiche.

  2. (Facultatif) Affinez votre recherche en effectuant 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 sélectionnez Supprimer.

    • Sélectionnez Fermer.

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

Parfois, vous ne savez peut-être pas le nom d’une étiquette, mais vous savez que l’étiquette a été appliquée à un élément particulier sous contrôle de version. La procédure suivante explique comment trouver et utiliser une étiquette dans cette situation.

  1. Dans l’Explorateur de 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 que 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 de fichiers dans votre espace de travail

L’étiquetage d’un ensemble de fichiers ressemble à prendre un instantané de la façon dont ils existaient à un moment donné. Des semaines ou des mois après avoir pris cet instantané, vous devrez peut-être afficher ou utiliser les fichiers tels qu’ils existaient dans cet instantané. La procédure suivante explique comment télécharger les versions étiquetées d’un ensemble de fichiers sur votre espace de travail.

  1. Dans l’Explorateur de contrôles 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 à télécharger, puis sélectionnez Advanced>Get Specific Version. 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 , Obtenez.

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

Après avoir ouvert la fenêtre Étiquette à l’aide de l’une des procédures précédentes, vous êtes prêt à commencer à utiliser l’étiquette. En haut de la fenêtre, une zone affiche le commentaire, que vous pouvez modifier.

Vous pouvez utiliser la fenêtre Label 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
  • Effectuer 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 s’affiche.

  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 dans le système de gestion de versions.

    • 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: spécifiez 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, puis 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, recherchez 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 s’affiche.

  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: spécifiez une date dans la zone Date ou sélectionnez une date dans le calendrier du menu déroulant.

    • Étiquette: spécifiez 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.

Effectuer 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 :

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 spécifier une étendue autre que le projet.

Étapes suivantes