Compartilhar via

Configurar pipelines para dar suporte ao acompanhamento de trabalho

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

Para dar suporte à integração e à rastreabilidade no Azure DevOps Services com pipelines, você pode configurar várias opções. Você pode relatar o status de pipeline, copiar a sintaxe para selos de status e configurar a vinculação automática de itens de trabalho a builds e versões.

Recursos compatíveis de integração de pipeline e acompanhamento de trabalho

Vários recursos dão suporte à rastreabilidade de ponta a ponta à medida que histórias e recursos de usuário se movem pelo ciclo de desenvolvimento. Assim como acontece com o Azure Repos, você pode vincular itens de trabalho a objetos de pipeline com os seguintes tipos de link: Build, Integrado no build e Integrado na versão. Você pode criar o link de Integrado no ambiente de lançamento habilitando a opção Relatar status de lançamento para Boards em pipelines de lançamento clássicos.

Captura de tela do diagrama conceitual mostrando tipos de link que conectam itens de trabalho a objetos do Azure Pipelines.

A tabela a seguir resume os pontos de integração entre o Azure Boards e o Azure Pipelines. As opções e as etapas de configuração diferem dependendo se você está configurando um pipeline YAML ou clássico e da sua versão do Azure DevOps. A maioria das opções compatíveis com pipelines são executadas em um repositório Git do Azure Repos, a menos que indicado de outra forma.

Recurso

Descrição

Versões com suporte

Vincular itens de trabalho manualmente a builds

Você pode vincular de um item de trabalho a builds dentro do mesmo projeto ou de outros projetos dentro da organização. Para obter mais informações, consulte Vincular a itens de trabalho a partir de outros objetos.

Todas as versões

Exibir builds vinculados a partir de um item de trabalho

Você pode exibir todos os builds vinculados a partir de um item de trabalho, seja manual ou automaticamente, na guia Links. Para mais informações, consulte Vincular a itens de trabalho a partir de outros objetos, Exibir lista de objetos vinculados.

Todas as versões

Vincular itens de trabalho automaticamente a builds

Necessário para preencher o controle de Desenvolvimento com links Integrados no build. Os itens de trabalho ou commits que fazem parte de uma versão são computados a partir das versões dos artefatos. Por exemplo, cada build no Azure Pipelines está associado a um conjunto de itens de trabalho e commits. Para obter mais informações, consulte Vincular itens de trabalho automaticamente posteriormente neste artigo.

YAML, Azure DevOps Server 2020 e posterior

Vincular automaticamente itens de trabalho a versões e relatar status de implantação para um item de trabalho (somente Clássico)

Você precisa dessa tarefa para preencher o controle Implantação no formulário do item de trabalho com links integrados no estágio de lançamento . Para mais informações, consulte Relatar status de implantação para o Boards mais adiante neste artigo.

Azure DevOps Server 2020 e posterior

Exibir lista de itens de trabalho vinculados a um build ou versão

Examine e abra os itens de trabalho incluídos em um build ou versão.

YAML, Azure DevOps Server 2020 e posterior

Criar Item de Trabalho em caso de falha (clássico)

Crie automaticamente um item de trabalho quando um build falhar e, opcionalmente, defina valores para campos de item de trabalho. Para obter mais informações, consulte Criar item de trabalho em caso de falha posteriormente neste artigo.

Todas as versões

Tarefa Consultar Itens de Trabalho: verifique se o número de itens de trabalho correspondentes retornados de uma consulta está dentro de um limite.

Use essa tarefa para garantir que o número de itens correspondentes retornados por uma consulta de item de trabalho esteja dentro dos limites configurados. Para mais informações, consulte Tarefa Consultar Itens de Trabalho, Controlar implantações com portões e aprovações.

Azure DevOps Server 2020 e posterior

Pré-requisitos

  • Para configurar as opções de integração para um pipeline de lançamento clássico, você precisa ter permissões para editar a versão.
  • Para vincular itens de trabalho a commits e pull requests, você deve definir sua permissão Editar itens de trabalho neste nó como Permitir para o Caminho da Área atribuído ao item de trabalho. Por padrão, o grupo Colaboradores tem essa permissão definida.
  • Para exibir itens de trabalho, você deve definir sua permissão de Exibir itens de trabalho neste nó para Permitir para o Caminho da Área atribuído ao item de trabalho.

Abrir configurações do pipeline, opções de build ou opções de integração

Abrir Configurações do pipeline

Para pipelines de lançamento definidos por YAML, configure a integração por meio da caixa de diálogo Configurações do pipeline.

  • Abra o pipeline, escolha Mais ações e Configurações.

    Captura de tela do pipeline yaml com o menu Mais ações aberto mostrando a opção Configurações.

    A caixa de diálogo Configurações de Pipeline é exibida. Para obter mais informações sobre vinculação automática, consulte Vincular automaticamente itens de trabalho.

    Captura de tela da caixa de diálogo de configurações do Pipeline YAML com a vinculação automática de novos itens de trabalho nesta opção de build.

Ao habilitar a vinculação automática, você pode rastrear os builds ou versões que incorporaram o trabalho sem precisar pesquisar manualmente em um grande conjunto de builds ou versões. Todo build bem-sucedido associado ao item de trabalho é exibido automaticamente na seção Desenvolvimento do formulário do item de trabalho. Cada fase de lançamento associada ao item de trabalho é exibida automaticamente no controle Implantação do formulário do item de trabalho.

  1. Abra as configurações do pipeline conforme descrito em configurações do Open Pipeline.

  2. Habilite Vincular automaticamente um novo trabalho neste build.

    Captura de tela da caixa de diálogo Configurações de pipeline, Vincular itens de trabalho automaticamente neste build.

    Depois que essa opção é habilitada, os links Integrados ao build são gerados para todos os itens de trabalho vinculados à solicitação de pull selecionada a cada execução de lançamento.

Quais itens de trabalho estão incluídos na vinculação automática?

Ao desenvolver seu software, você pode vincular itens de trabalho ao criar um branch, commit ou solicitação de pull. Ou, você pode iniciar uma branch, commit ou solicitação de pull de um item de trabalho, vinculando automaticamente esses objetos, conforme descrito em Impulsionar o desenvolvimento do Git por meio de um item de trabalho. Por exemplo, aqui criamos um branch com base na história de usuário do formulário Cancelar pedido.

Captura de tela da caixa de diálogo Criar ramificação mostrando as opções de link do item de trabalho.

Ao vincular automaticamente itens de trabalho a builds, as seguintes computações são feitas:

  • Para um build feito pela primeira vez:

    • Identifique todos os itens de trabalho vinculados ao branch, commits e solicitações de pull associados ao build.

  • Para builds subsequentes:

    • Identifique todos os itens de trabalho associados ao commit atual (C1) que está sendo compilado.
    • Identifique todos os itens de trabalho associados ao commit (C2) do último build bem-sucedido do mesmo branch de origem.
    • Identifique todos os itens de trabalho associados aos commits entre C1 e C2 na árvore de confirmação.

Criar item de trabalho em caso de falha de build (Clássico)

Se um pipeline de build falhar, você poderá criar automaticamente um item de trabalho para acompanhar a correção do problema. Você pode especificar o tipo de item de trabalho e definir opções para atribuí-lo automaticamente ao solicitante ou a outros campos. O solicitante corresponde à pessoa que disparou o build.

Dica

A opção de Criar um item de trabalho em caso de falha só é compatível com pipelines clássicos. Para fazer isso com um pipeline YAML, você pode usar uma extensão do marketplace como Criar bug se ocorrer falha de versão ou implementá-lo por conta própria usando a CLI do Azure ou chamadas à API REST.

  1. Abra as propriedades de build do pipeline, conforme descrito em Propriedades de build.

  2. Habilite Criar item de trabalho em caso de falha e escolha o tipo de item de trabalho a ser criado. Opcionalmente, marque a caixa de seleção Atribuir ao solicitante para definir o campo Atribuir a e adicionar campos a serem definidos dentro do item de trabalho a ser criado.

    Por exemplo, aqui, escolhemos o tipo de item de trabalho Bug e especificamos os campos Prioridade e Tags e os respectivos valores.

    Captura de tela da opção Criar item de trabalho na falha nas opções de build com o tipo de item de trabalho Bug selecionado.

  3. Salve o seu pipeline.

Para saber o nome de referência de um campo, pesquise-o no Índice do campo Item de trabalho. Para campos personalizados que você adiciona por meio de um processo herdado, o Azure DevOps atribui um nome de referência com base no nome de campo amigável prefixado com Personalizado. Por exemplo, você adiciona um campo chamado Triagem de DevOps. O nome de referência é Custom.DevOpsTriage. Espaços não são permitidos no nome de referência.

Obter ou habilitar um selo de status

  1. Abra o pipeline Mais Ações e escolha Selo de status.

    Captura de tela do menu Mais Ações do pipeline YAML com a opção Emblema de status.

  2. Escolha o branch e o escopo de interesse e escolha Copiar para a área de transferência para copiar a imagem ou a sintaxe Markdown.

    Captura de tela da caixa de diálogo do selo de status do pipeline YAML, mostrando opções de seleção de branch e escopo.

Relatar o status de implantação para o host do repositório (Clássico)

Quando o seu código é armazenado em um repositório Git do Azure Repos, é possível configurar seu pipeline de lançamento para exibir um selo nas páginas do Azure Repos. O selo indica onde a confirmação específica foi implantada e se a implantação está sendo aprovada ou rejeitada. Essa opção melhora a capacidade de acompanhamento da confirmação de código para implantação.

Captura de tela das opções de integrações para pipelines clássicos mostrando como reportar o status de implantação para as configurações do host do repositório.

O Azure Repos exibe o status da implantação nas seguintes seções:

  • Arquivos: indica o status da implantação mais recente para o branch selecionado.
  • Confirmações: indica o status de implantação de cada confirmação (requer que o gatilho de CD (integração contínua) esteja habilitado para o lançamento).
  • Branches: indica o status da implantação mais recente para cada branch.

Se você implantar um commit em vários pipelines de lançamento com vários estágios, cada estágio aparecerá no badge com seu status. Por padrão, quando você cria um pipeline de lançamento, ele posta o status de implantação para todos os estágios. No entanto, é possível escolher seletivamente os estágios cujo status de implantação deve ser exibido na notificação de status (por exemplo, mostrar apenas o estágio de produção). Os membros da equipe podem selecionar o selo de status para exibir o status de implantação mais recente para cada um dos estágios selecionados dos pipelines de lançamento.

Relatar o status de implantação para o Jira (Clássico)

Inclua problemas do Jira em itens de trabalho e crie links para todos os problemas na conclusão do estágio. Instale o aplicativo Azure Pipelines for Jira na nuvem do Jira Software e adicione a organização para criar uma conexão.

Captura de tela das opções de integrações para pipelines clássicos mostrando as configurações para reportar o status de implantação ao Jira.

Para dar suporte à integração com o rastreamento de problemas do Jira, instale Azure DevOps for Jira e conecte suas organizações do Azure DevOps à sua instância do Jira Software. Você pode conectar várias organizações a uma instância e obter dados para todas as equipes e projetos relacionados. Para saber mais, consulte Conectar-se ao Azure DevOps ao Jira.

  • Last updated on