Partilhar via

Configurar pipelines para dar suporte ao controle de trabalho

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

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.

Funcionalidades suportadas de integração de pipeline e de rastreamento de trabalho

Várias funcionalidades fornecem suporte para rastreabilidade de ponta a ponta à medida que as histórias do utilizador e as funcionalidades passam 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. Pode criar o link Integrado no ambiente de lançamento ativando a opção Reportar estado de lançamento em Boards nos pipelines de lançamento clássicos.

Captura de ecrã de um diagrama conceptual que mostra tipos de links que ligam os itens de trabalho aos objetos 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 num repositório Git do Azure Repos, salvo indicação em contrário.

Funcionalidade

Descrição

Versões suportadas

Vincular manualmente tarefas de trabalho a compilações

Você pode ligar um item de trabalho a builds no mesmo projeto ou em outros projetos da organização. Para obter mais informações, consulte Ligação para itens de trabalho a partir de outros objetos.

Todas as versões

Ver compilações associadas a 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 commits que fazem parte de uma versão são determinados com base nas versões dos artefatos. Por exemplo, cada compilação no Azure Pipelines está associada a um conjunto de itens de trabalho e commits. 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 lançamentos e relatar o estado da distribuição a um item de trabalho (somente Clássico)

Precisas desta tarefa para preencher o controlo Deployment no formulário de item de trabalho com links Integrado na fase de lançamento. Para obter mais informações, consulte Relatar o estado da implementação nos Painéis mais adiante neste artigo.

Azure DevOps Server 2020 e versões posteriores

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.

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 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 ligar itens de trabalho a commits e pull requests, deve definir a sua permissão Editar itens de trabalho neste nó para permitir o Caminho de Área atribuído ao item de trabalho. Por predefinição, o grupo Contribuintes tem esta permissão definida.
  • Para visualizar itens de trabalho, deve definir a sua permissão Visualizar itens de trabalho neste nó para permitir o Caminho de Á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 .

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

    Captura de ecrã do pipeline YAML com o menu Mais ações aberto a mostrar a opção Definições.

    Aparece a caixa de diálogo de configurações do pipeline. Para mais informações sobre ligação automática, consulte Ligar automaticamente itens de trabalho.

    Captura de ecrã do diálogo de definições do pipeline YAML com a opção de ligar automaticamente novos itens de trabalho neste build.

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 fase de lançamento associada ao item de trabalho aparece automaticamente no controlo de Deploy do formulário do 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 ecrã da caixa de diálogo das definições do pipeline, Ligar 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.

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

Ao desenvolver o seu software, pode-se vincular itens de trabalho ao criar uma ramificação, efetuar uma confirmação ou um pull request. Ou, pode criar um branch, fazer um commit ou abrir uma pull request a partir de um item de trabalho, vinculando automaticamente esses objetos conforme descrito em Desenvolver no 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.

Captura de ecrã da caixa de diálogo Criar ramo que mostra opções de ligação ao 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 ao commit atual (C1) a ser compilado.
    • 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 construção.

Gorjeta

A opção Criar item de trabalho em caso de falha só é suportada para pipelines Clássicos. Para realizar isto com um pipeline YAML, pode utilizar uma extensão do marketplace como Criar Bug na falha de lançamento ou pode implementá-lo você mesmo usando o Azure CLI ou chamadas à API REST.

  1. Abra as opções de compilação do pipeline conforme descrito em Propriedades de construçã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 preencher o campo Atribuir a e adicionar campos para definir no item de trabalho a ser criado.

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

    Captura de ecrã da opção Criar item de trabalho em caso de falha nas opções de compilação, com o tipo de item de trabalho Bug selecionado.

  3. Guarde a sua canalização.

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 ecrã do menu Mais ações do pipeline YAML com a opção de emblema de estado.

  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 ecrã do diálogo do emblema de estado do pipeline YAML mostrando opções de seleção de ramo e âmbito.

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 emblema indica onde a confirmação específica foi implementada e se a implementação está a ser bem-sucedida ou a falhar. Essa opção melhora a rastreabilidade desde a confirmação do código até a implantação.

Captura de ecrã das opções de integrações para pipelines clássicos que mostram o estado de implementação do relatório nas definições do host do repositório.

O Azure Repos apresenta o estado da implementação nas seguintes secções:

  • Ficheiros: indica o estado da implementaçã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 estado da implantação mais recente para cada ramo.

Se implementares um commit em múltiplos pipelines de lançamento com múltiplos estágios, cada estágio aparece no emblema com o seu estado. Por padrão, quando cria um pipeline de release, regista o estado da implantação para todas as fases. 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 equipa podem selecionar o emblema de estado para visualizar o estado de implantação mais recente de cada um dos estágios selecionados dos pipelines de lançamento.

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

Inclua tópicos do Jira em itens de tarefa e crie links para todos os tópicos na conclusão da fase. Instale o aplicativo Azure Pipelines for Jira na nuvem do Jira Software e adicione organização para criar uma conexão.

Captura de ecrã das opções de Integrações para pipelines clássicos mostrando o estado da implementação nas definições de integração do 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.

  • Last updated on