Partager via


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

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é.

    Capture d’écran de la navigation des balises dans le portail web.

    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.

    Capture d’écran des balises de filtre dans le portail web.

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.

Capture d’écran des balises dans la vue Commits dans le portail web.

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.

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.

    Capture d’écran du bouton créer une balise dans le portail web.

  2. Spécifiez un nom, sélectionnez la branche à partir de laquelle baliser, entrez une description (obligatoire dans la mesure où vous créez une balise annotée), puis sélectionnez Créer.

    Capture d’écran de la boîte de dialogue créer une balise dans le portail web.

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

    Capture d’écran de la nouvelle balise dans le portail web.

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.

Capture d’écran de la création d’une balise à partir de la vue validations dans le portail web.

Vous pouvez créer des balises annotées par programmation via l’API REST Azure DevOps. Pour créer des balises via un pipeline Azure à l’aide de la git tag commande. Pour plus d’informations, consultez la balise Git.

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 du niveau Toutes les balises (qui hérite de ses autorisations du niveau du référentiel s’il n’est pas défini explicitement). Le créateur hérite également des autorisations Push force pour une balise.

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.

    Capture d’écran de la balise de suppression dans le portail web.

  2. Sélectionnez Supprimer pour confirmer.

    Capture d’écran de la confirmation de la suppression de balise dans le portail web.

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

    Capture d’écran de la balise supprimée dans le portail web.

Créez une branche à partir d’une balise

  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.

    Capture d’écran de la création d’une branche à partir de la sélection d’étiquettes dans le portail web.

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

    Capture d’écran de la boîte de dialogue créer une branche à partir d’une balise dans le portail web.

  3. La branche est créée et vous accédez à la nouvelle branche dans le portail web.

    Capture d’écran de la branche créée à partir d’une balise dans le portail web.

Affichez l’historique des balises

  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.

    Capture d’écran de l’historique des balises d’affichage dans le portail web.

  2. Vous êtes redirigé vers la vue des validations pour la balise.

    Capture d’écran de l’historique des balises dans le portail web.