Utilisez des balises Git

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

Visual Studio 2019 | Visual Studio 2022

Azure DevOps prend en charge les balises annotées et légères. Les balises légères sont un pointeur vers une validation spécifique, tandis que les balises annotées contiennent plus d’informations telles que le baliseur, le message et la date. Vous pouvez créer des balises annotées à l’aide du portail web. Vous pouvez créer des balises légères et annotées à partir de Visual Studio. Pour plus d’informations sur les balises Git, consultez 2.6 Git Basics - Tagging à partir du livre Pro Git.

Cet article fournit une vue d’ensemble de l’utilisation des balises Git dans Azure DevOps et Visual Studio.

Important

L’affichage Balises dans Visual Studio a été introduite dans Visual Studio 2017 Mise à jour 6. Si vous utilisez des versions antérieures, vous pouvez afficher et créer des balises à partir des affichages historique et détails de validation à partir de Visual Studio 2015, mais vous ne pourrez pas effectuer les opérations dans l’affichage Balises, comme décrit dans cet article.

Affichez et filtrez les balises

Browser

Vous pouvez afficher les balises dans l’affichage Balises et dans l’affichage Validations dans le portail web.

Notes

Avec Azure DevOps Services, le format de l’URL du projet est dev.azure.com/{your organization}/{your project}. Toutefois, le format précédent qui fait référence au format visualstudio.com est toujours pris en charge. Pour plus d’informations, consultez Présentation d’Azure DevOps, Changer d’organisation existante pour utiliser la nouvelle URL de nom de domaine.

Affichez les balises dans l’affichage Balises

1. Pour afficher les balises dans votre référentiel, accédez à votre projet dans le portail web, choisissez Référentiels, Balises, puis sélectionnez le référentiel souhaité.

   

   Les balises annotées sont affichées avec un nom de balise, un message, une validation, un baliseur et une date de création. Les balises légères sont affichées avec un nom et une validation de balise.

2. Pour filtrer la liste des balises, tapez un terme de recherche dans la zone Rechercher un nom de balise, puis appuyez sur Entrée.

   

Affichez les balises dans l’affichage Validations

Pour afficher les balises d’une branche spécifique dans l’affichage Validations, accédez à votre référentiel dans le portail web, choisissez Référentiels, Validationset sélectionnez votre branche.

Visual Studio

Affichez les balises dans l’affichage Historique

Vous pouvez afficher les balises dans l’affichage Historique.

1. Dans le menu Git de la barre de menu, sélectionnez Gérer les branches.

2. Sélectionnez une branche pour afficher l’historique.

   

   Les formes rouges sont des branches et les formes vertes sont des balises.

Affichez les balises dans l’affichage Balises

Notes

Visual Studio 2019 version 16.8 et versions ultérieures fournissent un nouveau menu Git pour gérer le flux de travail Git avec moins de changement de contexte que Team Explorer. Les procédures fournies dans cet article sous l’onglet Visual Studio fournissent des informations sur l’utilisation de l’expérience Git et Team Explorer. Pour plus d’informations, consultez Comparaison côte à côte de Git et Team Explorer.

1. Pour afficher toutes les balises d’un référentiel, sélectionnez Balises dans l’affichage Accueil.

   

2. Les balises sont affichées sous le nom du référentiel actuellement connecté.

   

   Les balises annotées affichent une info-bulle qui contient le nom, le baliseur, la date de balise et le message. Les balises légères ont uniquement le nom de la balise dans l’info-bulle.

   

   Pour plus d’informations sur la validation balisée, faites un clic droit sur la balise et sélectionnez Afficher les détails de validation.

   

3. Pour filtrer la liste des balises, tapez un terme de recherche dans la zone Taper ici pour filtrer la liste.

   

Pour récupérer la liste actuelle des balises du référentiel source, effectuez une opération de récupération (fetch).

Créez une balise

Pour créer une balise, vous devez disposer de l’autorisation Créer une balise, qui est incluse par défaut dans le groupe Contributeurs et versions ultérieures.

Notes

Les noms de balises ne peuvent contenir aucun caractère de contrôle ASCII, tels que les espaces, tildes et points-virgules. Il est courant d’utiliser des caractères minuscules et de séparer les mots par un trait d’union. La longueur du nom de balise ne doit pas dépasser 250 caractères ASCII. Pour éviter toute ambiguïté entre les noms de balise et les hachages de validation, n’utilisez pas de noms de balise se composant de 40 caractères hexadécimaux. Pour plus d’informations sur le nommage des balises, consultez git-check-ref-format.

Browser

Vous pouvez créer des balises annotées à l’aide du portail web à partir de l’affichage Balises et de l’affichage Validations.

Important

Vous ne pouvez créer des balises annotées que dans le portail web ou Visual Studio. Pour créer une balise légère, vous pouvez utiliser Ligne de commande Git.

Créez des balises à partir de l’affichage Balises

1. Sélectionnez Créer une balise à partir de l’affichage Balises dans le portail web pour créer une balise annotée.

   

2. Spécifiez un Nom, sélectionnez la branche à partir de laquelle vous souhaitez créer une balise, entrez une Description (obligatoire, car vous créez une balise annotée), puis sélectionnez Créer.

   

3. La nouvelle balise s’affiche dans la liste des balises.

   

Créez des balises à partir de l’affichage Validations

Pour créer une balise directement à partir de l’affichage des validations, faites un clic droit sur la balise souhaitée, puis choisissez Créer une balise.

Visual Studio

Vous pouvez créer des balises annotées et légères dans Visual Studio à partir de l’affichage Historique et de l’affichage Balises. Pour créer une balise annotée, indiquez à la fois un nom et un message lors de la création de la balise. Pour créer une balise légère, omettez le message et fournissez uniquement un nom.

Créez des balises à partir de l’affichage Historique

Vous pouvez afficher les balises dans l’affichage Historique.

1. Dans le menu Git de la barre de menu, sélectionnez Gérer les branches.

2. Sélectionnez une branche pour afficher l’historique, faites un clic droit sur une validation, puis sélectionnez Nouvelle balise.

   

3. Dans la boîte de dialogue Créer une balise, entrez un Nom de balise uniquement pour une balise légère ou un Nom de balise et Message de balise pour une balise annotée. Sélectionnez Create (Créer).

Créez des balises à partir de l’affichage Balises

Notes

Visual Studio 2019 version 16.8 et versions ultérieures fournissent un nouveau menu Git pour gérer le flux de travail Git avec moins de changement de contexte que Team Explorer. Les procédures fournies dans cet article sous l’onglet Visual Studio fournissent des informations sur l’utilisation de l’expérience Git et Team Explorer. Pour plus d’informations, consultez Comparaison côte à côte de Git et Team Explorer.

1. Sélectionnez Nouvelle balise dans l’affichage Balises pour créer une nouvelle balise.

   

2. Pour créer une balise par rapport à la pointe de la branche actuelle, spécifiez un nom dans la zone Entrer un nom de balise, fournissez éventuellement un message de balise, puis sélectionnez Créer une balise.

   

   Pour sélectionner la branche à partir de laquelle créer la balise, décochez la zone Créer une balise par rapport à l’extrémité du case activée de la branche actuelle, puis sélectionnez une branche dans la liste déroulante Sélectionner une branche.

   

3. La nouvelle balise est créée localement. Faites un clic droit sur la nouvelle balise et choisissez Envoyer (push) pour l’envoyer vers le référentiel distant. Sélectionnez Tout envoyer (push) pour envoyer toutes les nouvelles balises locales vers le référentiel distant.

   

Supprimer un mot clé

Important

Soyez prudent lorsque vous supprimez des balises de votre référentiel. Si le référentiel a été tiré (pull), dupliqué (fork) ou cloné par un autre utilisateur, la balise existera toujours dans sa copie du référentiel. Vous ne devez supprimer que les balises locales, ou si vous êtes sûr que le référentiel n’a pas été retiré, cloné ou dupliqué (fork) depuis que vous avez créé votre balise.

Pour supprimer une balise, vous devez disposer de l’autorisation Forcer l’envoi (push) au niveau du Référentiel ou au niveau de Toutes les balises (qui hérite de ses autorisations du niveau du référentiel si elles ne sont pas explicitement définies). Les autorisations d’envoi (push) forcées pour une balise sont également héritées automatiquement par le créateur de la balise.

Browser

Supprimez une balise dans le référentiel distant

Les étapes de cette procédure vous montrent comment supprimer une balise dans le référentiel distant à l’aide du portail web Azure DevOps Services.

1. Pour supprimer une balise, sélectionnez les points de suspension à droite du nom de la balise, puis choisissez Supprimer la balise.

   

2. Sélectionnez Supprimer pour confirmer.

   

3. La balise est supprimée et ne s’affiche pas la prochaine fois que vous accédez à l’affichage Balises.

   

Visual Studio

Notes

Visual Studio 2019 version 16.8 et versions ultérieures fournissent un nouveau menu Git pour gérer le flux de travail Git avec moins de changement de contexte que Team Explorer. Les procédures fournies dans cet article sous l’onglet Visual Studio fournissent des informations sur l’utilisation de l’expérience Git et Team Explorer. Pour plus d’informations, consultez Comparaison côte à côte de Git et Team Explorer.

Les étapes de cette procédure vous montrent comment supprimer une balise dans le référentiel local à l’aide de Visual Studio 2019 Team Explorer.

Faites un clic droit sur la balise pour supprimer et choisissez Supprimer localement

Important

Si votre balise a déjà été envoyée au référentiel distant, vous ne devez pas la supprimer. Si le référentiel a été tiré (pull), dupliqué (fork) ou cloné par un autre utilisateur, la balise existera toujours dans sa copie du référentiel. Vous ne devez supprimer que les balises locales.

Créez une branche à partir d’une balise

Browser

1. Pour créer une branche à partir d’une balise, sélectionnez les points de suspension à droite du nom de la balise et choisissez Nouvelle branche.

   

2. Spécifiez un Nom, sélectionnez éventuellement tous les Éléments de travail à lier, puis choisissez Créer une branche.

   

3. La branche est créée et vous êtes redirigé vers la nouvelle branche dans le portail web.

   

Visual Studio

Les étapes décrites dans cette procédure vous montrent comment créer une branche à partir d’une balise à l’aide de Visual Studio 2019 Team Explorer. Pour Visual Studio 2019 à l’aide du menu Git ou de Visual Studio 2022, utilisez le navigateur.

Notes

Visual Studio 2019 version 16.8 et versions ultérieures fournissent un nouveau menu Git pour gérer le flux de travail Git avec moins de changement de contexte que Team Explorer. Les procédures fournies dans cet article sous l’onglet Visual Studio fournissent des informations sur l’utilisation de l’expérience Git et Team Explorer. Pour plus d’informations, consultez Comparaison côte à côte de Git et Team Explorer.

1. Pour créer une branche à partir d’une balise, faites un clic droit sur la balise et choisissez Nouvelle branche locale à partir de. Vous pouvez également choisir Créer une branche à partir d’une balise.

   

2. Spécifiez un nom de branche, vérifiez la balise souhaitée, puis choisissez Créer une branche. Pour extraire la nouvelle branche une fois qu’elle a été créée, choisissez Branche de validation.

   

3. Pour afficher votre branche nouvellement créée, sélectionnez Branches dans l’affichage Accueil.

   

4. Notez que votre nouvelle branche est créée localement. Pour envoyer (push) la branche, faites un clic droit dessus et choisissez Envoyer (push) la branche.

   

Affichez l’historique des balises

Browser

1. Pour afficher l’historique d’une balise, sélectionnez les points de suspension à droite du nom de la balise et choisissez Afficher l’historique.

   

2. Vous êtes redirigé vers l’affichage des validations pour la balise.

   

Visual Studio

Les étapes de cette procédure vous montrent comment afficher l’historique des balises à l’aide de Visual Studio 2019 Team Explorer. Pour Visual Studio 2019 à l’aide du menu Git ou de Visual Studio 2022, utilisez le navigateur.

Notes

Visual Studio 2019 version 16.8 et versions ultérieures fournissent un nouveau menu Git pour gérer le flux de travail Git avec moins de changement de contexte que Team Explorer. Les procédures fournies dans cet article sous l’onglet Visual Studio fournissent des informations sur l’utilisation de l’expérience Git et Team Explorer. Pour plus d’informations, consultez Comparaison côte à côte de Git et Team Explorer.

1. Pour afficher l’historique d’une balise, faites un clic droit sur la balise, puis choisissez Afficher l’historique.

   

2. L’historique s’affiche dans l’affichage Historique.