Configurar pipelines para dar suporte ao controle de trabalho

  • Artigo

Serviços de DevOps do Azure | Azure DevOps Server 2022 - Azure DevOps Server 2019

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

Recursos de integração de pipeline e acompanhamento de trabalho suportados

Várias funcionalidades fornecem suporte para controlo ponto a ponto à medida que as histórias do utilizador e as funcionalidades se movem ao longo do 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: Compilar, Integrado na compilação e Integrado na versão. O link Integrado no ambiente de liberação só pode ser criado ativando a opção Status de liberação de relatório para placas em pipelines de liberação clássicos.

Imagem conceitual de tipos de link que vinculam itens de trabalho a objetos do Azure Pipelines.

A tabela a seguir resume os pontos de integração entre os Painéis do Azure e os Pipelines do Azure. As opções e as etapas de configuração diferem dependendo se você está configurando um pipeline YAML ou Classic e sua versão do Azure DevOps. A maioria das opções é suportada para pipelines executados em um repositório Git do Azure Repos, salvo indicação em contrário.

Funcionalidade

Descrição

Versões suportadas

Vincular manualmente itens de trabalho a compilações

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

Todas as versões

Exibir compilações vinculadas a partir de um item de trabalho

Você pode visualizar todas as compilações vinculadas a partir de um item de trabalho, seja manual ou automaticamente vinculado, na guia Vínculos. Para obter mais informações, consulte Vincular a itens de trabalho de outros objetos, Exibir lista de objetos vinculados.

Todas as versões

Vincular automaticamente itens de trabalho a compilações

Necessário para preencher o controle de desenvolvimento com links integrados na compilação . Os itens de trabalho ou confirmações que fazem parte de uma versão são calculados a partir das versões dos artefatos. Por exemplo, cada compilação no Azure Pipelines está associada a um conjunto de itens de trabalho e confirmações. Para obter mais informações, consulte Vincular itens de trabalho automaticamente mais adiante neste artigo.

YAML, Azure DevOps Server 2020 e posterior

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

Necessário para preencher o controle de implantação no formulário de item de trabalho com links integrados no estágio de versão. Para obter mais informações, consulte Relatar o status da implantação para painéis mais adiante neste artigo.

Azure DevOps Server 2020 e posterior

Exibir lista de itens de trabalho vinculados a uma compilação ou versão

Revise e abra os itens de trabalho incluídos em uma compilação 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 uma compilação falhar e, opcionalmente, defina valores para campos de item de trabalho. Para obter mais informações, consulte Criar item de trabalho sobre falha mais adiante neste artigo.

2018 e versões posteriores

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 esta tarefa para garantir que o número de itens correspondentes retornados por uma consulta de item de trabalho esteja dentro dos limites configurados. Para obter mais informações, consulte Tarefa Consultar itens de trabalho, Controlar implantações com portas e aprovações.

Azure DevOps Server 2020 e versões posteriores

Pré-requisitos

  • Para configurar as opções de integração para um pipeline de versão Classic, você deve ter permissões para editar a versão.
  • Para vincular itens de trabalho a solicitações de confirmação e recebimento, você deve ter suas permissões de Editar itens de trabalho neste nó definidas como Permitir para o Caminho de Área atribuído ao item de trabalho. Por predefinição, o grupo Contribuintes tem esta permissão definida.
  • Para exibir itens de trabalho, você deve ter suas permissões Exibir itens de trabalho neste nó definidas como Permitir para o Caminho da Área atribuído ao item de trabalho.

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

Abrir configurações do Pipeline

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

  1. Abra o pipeline, escolha Mais ações e, em seguida, escolha Configurações.

    Abra as configurações do Pipeline.

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

    Caixa de diálogo Configurações do pipeline YAML.

Essa configuração não está disponível para o Azure DevOps Server 2019 ou versões anteriores.

Ao habilitar a vinculação automática, você pode acompanhar as compilações ou versões que incorporaram o trabalho sem ter que pesquisar manualmente através de um grande conjunto de compilações ou versões. Cada compilação bem-sucedida associada ao item de trabalho aparece automaticamente no controle de desenvolvimento do formulário de item de trabalho. Cada estágio de liberação associado ao item de trabalho aparece automaticamente no controle de implantação do formulário de item de trabalho.

Ao habilitar a vinculação automática, você pode rastrear as compilações que incorporaram o trabalho sem ter que pesquisar manualmente através de um grande conjunto de compilações. Cada compilação bem-sucedida associada ao item de trabalho aparece automaticamente no controle de desenvolvimento do formulário de item de trabalho.

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

  2. Ativar Vincular automaticamente novo trabalho nesta compilação.

    Captura de tela da caixa de diálogo Configurações do pipeline, Vincular automaticamente itens de trabalho nesta compilação.

    Uma vez habilitados, os links integrados na compilação são gerados para todos os itens de trabalho vinculados à solicitação pull selecionada a cada execução de versão.

Esse recurso não é suportado para pipelines YAML no Azure DevOps Server 2019.

Que itens de trabalho estão incluídos na ligação automática?

Ao desenvolver seu software, você pode vincular itens de trabalho ao criar uma ramificação, confirmação ou solicitação pull. Ou, você pode iniciar uma ramificação, confirmar ou receber solicitação de um item de trabalho, vinculando automaticamente esses objetos conforme descrito no desenvolvimento do Drive Git a partir de um item de trabalho. Por exemplo, aqui criamos uma nova ramificação a partir da história de usuário do formulário Cancelar pedido.

Criar caixa de diálogo de ramificação a partir do formulário de item de trabalho.

Quando você vincula automaticamente itens de trabalho a compilações, os seguintes cálculos são feitos:

  • Para uma primeira compilação:

    • Identifique todos os itens de trabalho vinculados à ramificação, confirmações e solicitações pull associadas à compilação.

  • Para compilações subsequentes:

    • Identifique todos os itens de trabalho associados à confirmação atual (C1) que está sendo criada.
    • Identifique todos os itens de trabalho associados à confirmação (C2) da última compilação bem-sucedida da mesma ramificação de origem.
    • Identifique todos os itens de trabalho associados às confirmações entre C1 e C2 na árvore de confirmação.

Criar item de trabalho em falha de compilação (Clássico)

Se um pipeline de compilação 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 acionou a compilação.

Gorjeta

A opção Criar item de trabalho em caso de falha só é suportada para pipelines Clássicos. Para fazer isso com um pipeline YAML, você pode usar uma extensão de mercado como Criar bug na falha de lançamento ou você mesmo pode implementá-la usando chamadas de CLI do Azure ou API REST.

  1. Abra as opções de compilação de pipeline conforme descrito em Propriedades de compilação.

  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 no item de trabalho a ser criado.

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

    Captura de tela de Criar item de trabalho em caso de falha nas opções de compilação.

  3. Guarde 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. Não são permitidos espaços no nome de referência.

Obter ou ativar um selo de estado

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

    Captura de tela das opções do menu Mais ações do pipeline YAML.

  2. Escolha a ramificação e o escopo de interesse e, em seguida, escolha Copiar para a área de transferência para copiar a imagem ou a sintaxe de Markdown.

    Captura de tela do selo de status do pipeline YAML.

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

Quando seu código é armazenado em um repositório Git do Azure Repos, você pode configurar seu pipeline de liberação 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á passando ou falhando. Essa opção melhora a rastreabilidade desde a confirmação do código até a implantação.

Captura de tela das opções de Integrações para pipelines clássicos, relatar o status da implantação para o host do repositório

O status da implantação é exibido nas seguintes seções do Azure Repos:

  • Arquivos: indica o status da implantação mais recente para a ramificação selecionada.
  • Commits: indica o status de implantação para cada confirmação (requer que o gatilho de integração contínua (CD) seja habilitado para sua versão).
  • Ramos: indica o status da implantação mais recente para cada ramificação.

Se uma confirmação for implantada em vários pipelines de liberação, com vários estágios, cada um terá uma entrada no selo com o status mostrado para cada estágio. Por padrão, quando você cria um pipeline de versão, o status da implantação é postado para todos os estágios. No entanto, você pode escolher seletivamente os estágios para os quais o status de implantação deve ser exibido no selo de status (por exemplo, mostrar apenas o estágio de produção). Os membros da sua 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 versão.

Relatar o status da 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 palco. Instale o aplicativo Azure Pipelines for Jira na nuvem do Jira Software e adicione organização para criar uma conexão.

Captura de tela das opções de Integrações para pipelines clássicos, Relatar o status da implantação para o Jira

Para dar suporte à integração com o acompanhamento de problemas do Jira, instale o 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 com uma instância e obter dados para todas as suas equipes e projetos relacionados. Para obter mais informações, consulte Conectar o Azure DevOps ao Jira.