Hinzufügen, Entfernen und Verwenden von Buildtags

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

Mithilfe von Buildtags in Azure DevOps können Sie Ihre Builds kategorisieren und organisieren, sodass Sie bestimmte Builds einfacher filtern und suchen können. Dieser Leitfaden führt Sie durch das Hinzufügen, Entfernen und Verwenden von Buildtags als Teil Ihres Buildverwaltungsprozesses.

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

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

[
]

Hinzufügen eines Buildtags zu einem zukünftigen Build

Verwenden Sie den addbuildtag Protokollierungsbefehl, um einem zukünftigen Build in einer YAML-Pipeline automatisch ein Buildtag hinzuzufügen.

Im folgenden Beispiel wird ein neuer Marker in einer Skriptaufgabe 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 sie 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 in der Filterleiste das Tag aus, nach dem Sie filtern möchten.

   

4. Azure DevOps filtert die Builds basierend auf dem angegebenen Tag, sodass Sie die benötigten Läufe finden können.