Configurar pipelines para dar suporte ao controle de trabalho

Azure DevOps Services | 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.

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

YAML

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.

   

   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.

   

Construção clássica

Construir propriedades

Abra o pipeline de compilação, escolha editar o pipeline e, em seguida, escolha a guia Opções .

A página Propriedades de compilação é exibida.

Para obter mais informações sobre cada configuração, use um dos seguintes links:

• Formato do número de compilação
• Vincular automaticamente itens de trabalho
• Criar item de trabalho em caso de falha
• Emblema de status

Lançamento Clássico

Opções de integração de versão

Para pipelines de liberação clássicos, abra Pipelines>Releases, escolha editar seu pipeline e, em seguida, escolha Opções e, em seguida , Integrações.

Para obter mais informações sobre cada configuração, use um dos seguintes links:

• Relatar o status da implantação para o host do repositório
• Relatar o status da implantação para o Trabalho
• Relatar o status da implantação para os painéis
• Relatar o status da implantação para o Jira
• Habilitar o selo de status de implantação

Vincular automaticamente itens de trabalho a compilações ou versões

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.

YAML

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

2. Ativar Vincular automaticamente novo 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.

Construção clássica

1. Abrir pipeline Construir propriedades conforme descrito em Propriedades de compilação.

2. Habilite Vincular automaticamente os itens de trabalho incluídos nesta execução. Adicione as ramificações para incluir ou excluir.
   

   Uma vez habilitado, integrado na compilação são gerados para todos os itens de trabalho vinculados às ramificações selecionadas em cada execução.

   Para exibir uma lista de itens de trabalho vinculados à compilação, escolha o link Relacionado na página Resumo.

   

3. Guarde o seu pipeline.

Lançamento Clássico

Antes de escolher as opções de integração, configure os estágios de liberação conforme descrito em Definir seu pipeline de implantação contínua (CD) de vários estágios.

1. Abra Opções>de Integrações para o pipeline de versão, conforme descrito em Opções de integração de versão.

2. Marque a caixa de seleção Relatar status de implantação para painéis . Mapeie o tipo de implantação para cada estágio ou deixe Unmapped. Selecione essa opção se quiser criar links para todos os itens de trabalho que representam alterações associadas à origem, quando uma versão for concluída. Essa opção deve ser habilitada para que o controle de implantação do formulário de item de trabalho funcione .

   

   Para exibir uma lista de itens de trabalho vinculados à versão, escolha Liberar (modo de exibição antigo) em Mais comandos e, em seguida, escolha a guia Itens de Trabalho.

   

3. Guarde o seu pipeline.

Verificar a integração

Para verificar se a integração está funcionando, execute as seguintes etapas:

1. Vincule um ou mais itens de trabalho a uma solicitação de confirmação ou pull no repositório Git do Azure Repos. Para obter mais informações, consulte:

   • Impulsione o desenvolvimento do Git a partir de um item de trabalho
   • Link para itens de trabalho de outros objetos

2. Executar o pipeline.

3. Abra um dos itens de trabalho vinculados e exiba o controle Deployment. Conforme mostrado na imagem a seguir, o controle de Implantação mostra informações de liberação para dois estágios de versão: os itens de trabalho vinculados a uma solicitação de confirmação ou pull do Git para um pipeline de liberação configurado para integração com os Painéis do Azure.

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.

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.

   

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

YAML

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

   

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.

   

Construção clássica

1. Abrir pipeline Construir propriedades conforme descrito em Propriedades de compilação.

2. Escolha Copiar para área de transferência para copiar a imagem ou a sintaxe Markdown.

   

3. Guarde o seu pipeline.

Lançamento Clássico

Selecione essa opção se quiser exibir o resultado mais recente de uma implantação de estágio em um site externo.

1. Marque a caixa de seleção Habilitar o selo de status de implantação. E, em seguida, selecione os estágios para os quais você deseja exibir o resultado. Por padrão, todos os estágios definidos para a versão são selecionados.

   

2. Escolha Copiar para área de transferência para copiar a imagem ou a sintaxe Markdown.

   

3. Guarde o seu pipeline.

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.

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.

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.

Artigos relacionados

• Definir um pipeline de implantação contínua (CD) de vários estágios
• Vincular itens de trabalho a outros objetos
• Revise a visão geral dos pipelines de liberação (Clássico)
• Recuperar todos os itens de trabalho associados a um pipeline de versão usando a API de DevOps do Azure
• Impulsione o desenvolvimento do Git a partir de um item de trabalho
• Vincular itens de trabalho a outros objetos
• Garantir a rastreabilidade de ponta a ponta
• Consulte a referência de tipo de link