Partager via


Ajouter, supprimer et utiliser des balises de build

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

Les balises de génération dans Azure DevOps vous aident à catégoriser et organiser vos builds, ce qui facilite le filtrage et la localisation de builds spécifiques. Ce guide vous guide tout au long de l’ajout, de la suppression et de l’utilisation de balises de build dans le cadre de votre processus de gestion de build.

Prérequis

Une organisation Azure DevOps et un accès à un projet dans lequel vous êtes membre du groupe Contributeurs .

Ajouter une balise de construction à une construction terminée

Interface utilisateur d’Azure Pipelines

Pour ajouter une balise à une build terminée :

  1. Ouvrez votre projet Azure DevOps et rendez-vous dans la rubrique Pipelines.

  2. Sélectionnez le pipeline dans lequel vous souhaitez ajouter une balise.

    Capture d'écran de la sélection du pipeline pour ajouter une balise.

  3. Sélectionnez Plus d'actions et choisissez Ajouter des balises pour ajouter votre première balise ou Modifier les balises si vous avez une balise existante.

    Capture d'écran de l'option de sélection pour ajouter une balise.

  4. Entrez un nom de balise (par exemple, contoso).

    Capture d'écran de l'ajout d'une nouvelle balise de compilation.

  5. Appuyez sur Entrée pour enregistrer la balise.

Interface CLI Azure DevOps

Pour créer une balise de compilation, utilisez la commande az pipelines build tag add.

Par exemple, la commande suivante crée une balise de construction nommée prod dans l'organisation contoso et le projet webapp pour la construction 1234.

az pipelines build tag add --build-id 1234
                           --tags prod
                           --org https://dev.azure.com/Contoso/
                           --project contoso

Sortie :

[
  "prod"
]

Supprimer une balise de compilation

Pour supprimer les balises de construction de vos constructions dans Azure DevOps, procédez comme suit :

  1. Ouvrez votre projet Azure DevOps et rendez-vous dans la rubrique Pipelines.

  2. Sélectionnez le pipeline dans lequel vous souhaitez supprimer une balise.

  3. Sélectionnez Plus d'actionset choisissez Modifier les balises.

  4. Sélectionnez le X en regard du nom de la balise pour la supprimer.

    Capture d'écran de la suppression d'une balise de build.

  5. Appuyez sur Sauvegarder pour enregistrer les modifications.

Ajouter une balise de construction à une future construction

Pour ajouter automatiquement une balise de build à une future build dans un pipeline YAML, utilisez la addbuildtag commande de journalisation.

Dans l’exemple suivant, une nouvelle balise est ajoutée dans une tâche de script avec une variable qui inclut la date actuelle.

steps:
- script: |
    last_scanned="last_scanned-$(date +%Y%m%d)"
    echo "##vso[build.addbuildtag]$last_scanned"
  displayName: 'Apply last scanned tag'

Filtrer avec une balise de construction

Une fois que vous avez ajouté des balises de build à vos builds, vous pouvez les utiliser pour filtrer et rechercher des builds spécifiques. Pour utiliser les balises de construction dans Azure DevOps, procédez comme suit :

  1. Ouvrez votre projet Azure DevOps et rendez-vous dans la rubrique Pipelines.

  2. Sélectionnez l'onglet Exécutions.

  3. Dans la barre de filtres, sélectionnez la balise à filtrer.

    Capture d'écran de la sélection de la balise à filtrer.

  4. Azure DevOps filtre les builds en fonction de la balise spécifiée, ce qui vous permet de trouver les exécutions dont vous avez besoin.