新增、移除及使用組建標籤

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

Azure DevOps 中的建置標籤可協助您分類及組織組建，讓您更輕鬆地篩選及尋找特定組建。 本指南將逐步引導您完成在建置管理程式中新增、移除和使用組建標籤。

必要條件

Azure DevOps 組織和您是 參與者 群組成員的專案存取權。

將組建標籤新增至已完成的組建

Azure Pipelines UI

若要將標籤新增至已完成的組建：

1. 開啟您的 Azure DevOps 專案，然後移至 [管線]。

2. 選取您要在其中新增標籤的管線。

   

3. 選取 [更多動作]，然後選擇 [新增卷標] 以新增您的第一個標籤，或者如果您有現有的標籤，請編輯標籤。

   

4. 輸入標記名稱（例如 contoso）。

   

5. 按 Enter 以儲存標記。

Azure DevOps CLI

若要建立組建標籤，請使用 az pipelines build tag add 命令。

例如，下列命令會在組織和prod專案中建立名為 contoso 的webapp組建標記，以供建1234置 使用。

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

輸出：

[
  "prod"
]

---

拿掉組建標籤

Azure Pipelines UI

若要從 Azure DevOps 中的組建中移除組建標籤，請遵循下列步驟：

1. 開啟您的 Azure DevOps 專案，然後移至 [管線]。

2. 選取您要移除標籤的管線。

3. 選取 [更多動作]，然後選擇 [編輯卷標]。

4. 選取標籤名稱旁的 X，以移除您的標記。

   

5. 按 [ 儲存] 以儲存變更。

Azure DevOps CLI

若要移除組建標籤，請使用 az pipelines build tag delete 命令。

例如，下列命令會移除組建中名為 prod 的 contoso 組建標籤，以及 webapp 組建 1234的專案。

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

輸出：

[
]

將組建標籤新增至未來的組建

若要在 YAML 管線中自動將組建標籤新增至未來的組建，請使用 addbuildtag 記錄命令。

在下列範例中，腳本工作中會新增新的標記，其中包含目前日期的變數。

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

---

使用組建標籤篩選

將組建標籤新增至組建之後，您就可以使用這些標籤來篩選和搜尋特定組建。 若要在 Azure DevOps 中使用組建標籤，請遵循下列步驟：

1. 開啟您的 Azure DevOps 專案，然後移至 [管線]。

2. 選取 [ 執行] 索引標籤。

3. 在篩選列中，選取您要篩選依據的標籤。

   

4. Azure DevOps 會根據指定的標記篩選組建，讓您找到所需的執行。