Como adicionar, remover e usar tags de compilação

Artigo
08/01/2024

Serviços de DevOps do Azure | Azure DevOps Server 2022 | Azure DevOps Server 2020

As marcas de compilação no Azure DevOps permitem categorizar e organizar suas compilações. As tags facilitam a filtragem e a pesquisa de compilações específicas. Neste artigo, saiba como adicionar, remover e usar marcas de compilação no Azure DevOps.

Pré-requisitos

Uma organização de DevOps do Azure e acesso a um projeto em que você é membro do grupo de Colaboradores .

Adicionar uma tag de compilação a uma compilação concluída

Interface do usuário do Azure Pipelines
CLI do Azure DevOps

Para adicionar uma tag a uma compilação concluída:

Abra seu projeto de DevOps do Azure e vá para Pipelines.
Selecione o pipeline onde você deseja adicionar uma tag.
Selecione Mais ações e escolha Adicionar tags para adicionar sua primeira tag ou Editar tags se você tiver uma tag existente.
Insira um nome de marca (exemplo: contoso).
Pressione Enter para salvar as tags.

Para criar uma tag build, use o comando az pipelines build tag add .

Por exemplo, o comando a seguir cria uma marca de compilação nomeada prod na organização e webapp no contoso projeto para a compilação1234.

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

Saída:

[
  "prod"
]

Para remover marcas de compilação de suas compilações no Azure DevOps, siga estas etapas:

Abra seu projeto de DevOps do Azure e vá para Pipelines.
Selecione o pipeline onde você deseja remover uma tag.
Selecione Mais ações e escolha Editar tags.
Selecione o X ao lado do nome da tag para removê-la.
Pressione Salvar para salvar as alterações.

Para remover uma tag build, use o comando az pipelines build tag delete .

Por exemplo, o comando a seguir remove uma marca de compilação nomeada prod na organização e webapp no contoso projeto para a compilação1234.

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

Saída:

[
]

Adicionar uma tag de compilação a uma compilação futura

Para adicionar uma marca de compilação a uma compilação em um pipeline YAML, use o addbuildtag comando log.

No exemplo a seguir, uma nova tag é adicionada em uma tarefa de script com uma variável que inclui a data atual.

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

Filtrar com uma tag de compilação

Depois de adicionar tags de compilação às suas compilações, você pode usá-las para filtrar e pesquisar compilações específicas. Para usar marcas de compilação no Azure DevOps, siga estas etapas:

Abra seu projeto de DevOps do Azure e vá para Pipelines.
Selecione a guia Execuções .
Na barra de filtros, selecione a tag pela qual deseja filtrar.
O Azure DevOps filtrará as compilações com base na tag especificada, permitindo que você encontre as execuções necessárias.

Partilhar via