Hinzufügen, Entfernen und Verwenden von Buildtags

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

Mit Buildtags in Azure DevOps können Sie Ihre Builds kategorisieren und organisieren. Tags vereinfachen das Filtern und die Suche nach bestimmten Builds. In diesem Artikel erfahren Sie, wie Sie Buildtags in Azure DevOps hinzufügen, entfernen und verwenden.

Voraussetzungen

Eine Azure DevOps-Organisation und Zugriff auf ein Projekt, in dem Sie Mitglied der Gruppe Mitwirkende sind.

Hinzufügen eines Buildtags zu einem abgeschlossenen Build

Azure Pipelines-UI

So fügen Sie einem abgeschlossenen Build ein Tag hinzu:

1. Öffnen Sie Ihr Azure DevOps-Projekt und navigieren Sie zu Pipelines.

2. Wählen Sie die Pipeline aus, der Sie ein Tag hinzufügen möchten.

   

3. Wählen Sie Weitere Aktionen und anschließend Tags hinzufügen aus, um das erste Tag hinzuzufügen, oder wählen Sie Tags bearbeiten aus, wenn es bereits ein Tag gibt.

   

4. Geben Sie einen Tagnamen ein (z. B. contoso).

   

5. Drücken Sie die EINGABETASTE, um das Tag zu speichern.

Erste Schritte mit der Azure DevOps-CLI

Zum Erstellen eines Buildtags verwenden Sie den Befehl az pipelines build tag add.

Der folgende Befehl erstellt beispielsweise ein Buildtag namens prod in der Organisation contoso und im Projekt webapp für den Build 1234.

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

Ausgabe:

[
  "prod"
]

Entfernen eines Buildtags

Azure Pipelines-UI

Führen Sie die folgenden Schritte aus, um Buildtags aus Ihren Builds in Azure DevOps zu entfernen:

1. Öffnen Sie Ihr Azure DevOps-Projekt und navigieren Sie zu Pipelines.

2. Wählen Sie die Pipeline aus, aus der Sie ein Tag entfernen möchten.

3. Wählen Sie Weitere Aktionen und dann Tags bearbeiten aus.

4. Wählen Sie das X neben dem Tagnamen aus, um das Tag zu entfernen.

   

5. Klicken Sie zum Speichern der Änderungen auf Speichern.

Erste Schritte mit der Azure DevOps-CLI

Zum Entfernen eines Buildtags verwenden Sie den Befehl az pipelines build tag delete.

Der folgende Befehl entfernt beispielsweise ein Buildtag namens prod in der Organisation contoso und im Projekt webapp für den Build 1234.

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

Ausgabe:

[
]

Hinzufügen eines Buildtags zu einem zukünftigen Build

Um einem Build in einer YAML-Pipeline ein Buildtag hinzuzufügen, verwenden Sie den addbuildtag Protokollierungsbefehl.

Im folgenden Beispiel wird einer Skriptaufgabe ein neues Tag mit einer Variablen hinzugefügt, die das aktuelle Datum enthält.

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

---

Filtern mit einem Buildtag

Nachdem Sie Ihren Builds Buildtags hinzugefügt haben, können Sie diese verwenden, um nach bestimmten Builds zu filtern und zu suchen. Führen Sie die folgenden Schritte aus, um Buildtags in Azure DevOps zu verwenden:

1. Öffnen Sie Ihr Azure DevOps-Projekt und navigieren Sie zu Pipelines.

2. Wählen Sie die Registerkarte Ausführungen aus.

3. Wählen Sie auf der Filterleiste das Tag aus, nach dem Sie filtern möchten.

   

4. Azure DevOps filtert die Builds nach dem angegebenen Tag, um die gewünschten Ausführungen zu finden.