Compartilhar via


Adicionar, remover e utilizar tags de build

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

As marcas de build no Azure DevOps ajudam você a categorizar e organizar seus builds, facilitando a filtragem e a localização de builds específicos. Este guia orienta você sobre como adicionar, remover e usar tags de build como parte das etapas do seu processo de gerenciamento de build.

Pré-requisitos

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

Adicionar uma marcação de build em um build concluído

Interface do usuário do Azure Pipelines

Para adicionar uma marcação a um build concluído:

  1. Abra o projeto Azure DevOps e vá para Pipelines.

  2. Selecione o pipeline ao qual você deseja adicionar uma marcação.

    Captura de tela da seleção do pipeline para adicionar uma marcação.

  3. Selecione Mais ações e escolha Adicionar marcações para adicionar sua primeira marcação ou Editar marcações se você já tiver uma marcação existente.

    Captura de tela da opção de seleção para adicionar marcação.

  4. Insira um nome de etiqueta (por exemplo, contoso).

    Captura de tela da adição de uma nova marcação de build.

  5. Pressione Enter para salvar a marca.

CLI do Azure DevOps

Para criar uma marcação de build, use o comando az pipelines build tag add.

Por exemplo, o comando a seguir cria uma marcação de build chamada prod na organização contoso e no projeto webapp para a build 1234.

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

Saída:

[
  "prod"
]

Remover uma marcação de build

Para remover marcações dos seus builds no Azure DevOps, siga estas etapas:

  1. Abra o projeto Azure DevOps e vá para Pipelines.

  2. Selecione o pipeline ao qual você deseja remover uma marcação.

  3. Selecione Mais ações e escolha Editar marcações.

  4. Selecione o X ao lado do nome da marcação para removê-la.

    Captura de tela da remoção da marcação de build.

  5. Pressione Salvar para salvar as alterações.

Adicionar uma marcação de build a uma build futura

Para adicionar automaticamente um build tag a um build futuro em um pipeline YAML, use o addbuildtag comando de log.

No exemplo a seguir, uma nova tag é adicionada a 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 marcação de build

Depois de adicionar marcas de build aos seus builds, você poderá usá-las para filtrar e pesquisar builds específicos. Para usar marcações de build no Azure DevOps, siga estas etapas:

  1. Abra o projeto Azure DevOps e vá para Pipelines.

  2. Selecione a guia Execuções.

  3. Na barra de filtros, selecione a marca pela qual você deseja filtrar.

    Captura de tela da seleção da marcação para filtrar.

  4. O Azure DevOps filtra as compilações com base na tag especificada, permitindo que você encontre as execuções de que você precisa.