Grupos de tarefas em pipelines clássicos

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Em pipelines clássicos, um grupo de tarefas encapsula uma sequência de tarefas que já estão definidas em um pipeline em uma única tarefa reutilizável. O novo grupo de tarefas é adicionado automaticamente ao catálogo de tarefas e pode ser adicionado a pipelines no projeto, assim como outras tarefas. Os grupos de tarefas são armazenados no nível do projeto e não são acessíveis fora do escopo do projeto.

Os grupos de tarefas são uma maneira de padronizar e gerenciar centralmente as etapas de implantação para todos os seus aplicativos. Quando você faz uma alteração centralmente em um grupo de tarefas, a alteração é refletida automaticamente em todas as definições de pipeline que usam o grupo de tarefas. Não é necessário alterar cada definição individualmente.

Nota

Não há suporte para grupos de tarefas em pipelines YAML. Em vez disso, você pode usar Modelos.

Pré-requisitos

• Uma organização e um projeto do Azure DevOps onde você tem permissão para criar pipelines.
• Um pipeline clássico criado no projeto.

Extrair parâmetros da tarefa como variáveis

Ao criar um grupo de tarefas, você pode optar por extrair os parâmetros das tarefas encapsuladas como variáveis de configuração e abstrair o restante das informações da tarefa. As variáveis usadas nas tarefas são extraídas automaticamente e convertidas em parâmetros para o grupo de tarefas, e os valores dessas variáveis de configuração são convertidos em valores padrão para o grupo de tarefas.

Você também pode alterar os valores padrão para os parâmetros ao salvar o novo grupo de tarefas. Quando você coloca em fila uma execução ou liberação de pipeline, as tarefas encapsuladas são extraídas e os valores inseridos para os parâmetros do grupo de tarefas são aplicados às tarefas.

Antes de criar um grupo de tarefas, certifique-se de definir quaisquer parâmetros que você deseja configurar em execuções de pipeline como variáveis, como $(MyVariable). Todos os parâmetros de tarefa que não têm valores ou têm valores especificados em vez de variáveis tornam-se parâmetros fixos e não são expostos ao grupo de tarefas como parâmetros configuráveis.

Você também pode configurar condições de tarefa em um grupo de tarefas, como Executar esta tarefa somente quando uma tarefa anterior tiver falhado para uma tarefa de Script do PowerShell, e essas condições forem mantidas com o grupo de tarefas.

Nota

Os grupos de tarefas são suportados em pipelines clássicos e pipelines de versão clássicos.

Criar um grupo de tarefas

Ao salvar um novo grupo de tarefas, você fornece um nome e uma descrição e seleciona uma categoria para o grupo de tarefas no catálogo de tarefas.

1. Abra o pipeline onde você deseja criar um novo grupo de tarefas.

2. Para garantir que nenhuma das tarefas que você pretende incluir contenha parâmetros vinculados, selecione Desvincular tudo no painel de configurações do pipeline e, em seguida, selecione Confirmar.

   

3. Selecione uma sequência de tarefas de pipeline que você deseja transformar em um grupo de tarefas, clique com o botão direito do mouse para abrir o menu de contexto e escolha Criar grupo de tarefas.

   

4. Especifique um nome e uma descrição para o novo grupo de tarefas e a categoria no painel Adicionar tarefas ao qual você deseja adicioná-lo.

5. Selecione Criar. O novo grupo de tarefas é criado e substitui as tarefas selecionadas no seu pipeline.

6. Todas as '$(vars)' tarefas subjacentes, exceto variáveis predefinidas, aparecem como parâmetros obrigatórios para o grupo de tarefas recém-criado e você pode editar os valores, se necessário.

   Por exemplo, se você tinha uma entrada foobar de tarefa que não pretendia parametrizar, a entrada de tarefa é convertida no parâmetro 'foobar'do grupo de tarefas. Você pode fornecer o valor padrão para o parâmetro 'foobar' do grupo de tarefas para $(foobar) garantir que, em tempo de execução, a tarefa expandida obtenha a entrada pretendida.

7. Salve seu pipeline atualizado.

Gerenciar grupos de tarefas

Todos os grupos de tarefas no projeto atual estão listados em Pipelines na página Grupos de tarefas.

Na parte superior da página Grupos de tarefas , você pode selecionar Importar para importar definições de grupo de tarefas salvas anteriormente. Você pode usar esse recurso para transferir grupos de tarefas entre projetos e empresas ou replicar e salvar cópias de seus grupos de tarefas.

Você também pode selecionar Segurança na parte superior da página para definir quem pode usar, editar, excluir ou definir permissões para todos os grupos de tarefas no projeto.

Para gerenciar um grupo de tarefas, clique com o botão direito do mouse ou selecione o ícone Mais ações para o grupo e selecione uma das seguintes opções no menu de contexto:

• Selecione Excluir para excluir o grupo de tarefas e, em seguida, selecione Excluir novamente na tela de confirmação.
• Selecione Exportar para salvar uma cópia do grupo de tarefas como um pipeline JSON.
• Selecione Segurança para definir quem pode usar, editar, excluir ou definir permissões para o grupo de tarefas.

Para abrir a página de detalhes do grupo de tarefas para edição, selecione o nome do grupo de tarefas na página Grupos de tarefas.

• Na guia Tarefas, você pode editar as tarefas que compõem o grupo de tarefas. Para cada tarefa encapsulada, você pode alterar os valores dos parâmetros para os parâmetros não variáveis, editar as variáveis de parâmetro existentes ou converter valores de parâmetro para e de variáveis. Quando você salva as alterações, todas as definições que usam o grupo de tarefas pegam as alterações.

  Todos os parâmetros variáveis do grupo de tarefas aparecem como parâmetros obrigatórios na definição do pipeline. Você também pode definir os valores padrão para os parâmetros do grupo de tarefas.

• Na guia Histórico, você pode ver o histórico de alterações no grupo.

• Na guia Referências, você pode ver listas de todos os pipelines e outros grupos de tarefas que fazem referência a esse grupo de tarefas. Esta listagem ajuda-o a garantir que as alterações não têm efeitos inesperados noutros processos.

Criar versões pré-visualizadas e atualizadas de grupos de tarefas

Todas as tarefas internas do Azure Pipelines são versionadas. O controle de versão permite que os pipelines continuem usando a versão existente de uma tarefa enquanto novas versões são desenvolvidas, testadas e lançadas. Você pode fazer a versão de seus grupos de tarefas personalizados da mesma maneira para fornecer as mesmas vantagens.

1. Para fazer a versão de um grupo de tarefas, depois de terminar de editá-lo, selecione Salvar como rascunho em vez de Salvar.

   

2. A cadeia de caracteres -test é acrescentada ao número da versão do grupo de tarefas. Quando estiver satisfeito com as alterações, escolha Publicar rascunho. No ecrã Publicar rascunho do grupo de tarefas, selecione Publicar como pré-visualização se pretender publicar a nova versão como pré-visualização e, em seguida, selecione Publicar.

   

3. Agora você pode usar o grupo de tarefas atualizado em seus processos de liberação. Você pode alterar o número da versão em pipelines que já usam o grupo de tarefas ou escolher o grupo de tarefas versionado no painel Adicionar tarefas . Tal como acontece com as tarefas internas, o padrão quando você adiciona um grupo de tarefas é a versão não visualizada mais alta.

   

4. Depois de concluir o teste do grupo de tarefas atualizado, escolha Publicar visualização e, em seguida, selecione Publicar. A cadeia de caracteres de visualização é removida do número da versão e a versão agora aparece em definições como uma versão pronta para produção.

   

5. Agora você pode selecionar a nova versão pronta para produção em um pipeline que já contém o grupo de tarefas. Quando você adiciona o grupo de tarefas no painel Adicionar tarefas , ele seleciona automaticamente a nova versão pronta para produção. Você pode editar o pipeline para usar uma versão anterior.

   

Trabalhar com versões de grupos de tarefas

As atualizações do grupo de tarefas podem ser atualizações secundárias ou de versões principais.

Criar uma atualização de versão secundária

Para criar uma atualização de versão secundária, salve diretamente o grupo de tarefas depois de editá-lo em vez de salvá-lo como rascunho.

O número da versão não é alterado e as alterações mais recentes aparecem na definição do pipeline automaticamente. Por exemplo, se o seu grupo de tarefas for a versão 1, você pode ter qualquer número de atualizações de versão secundária, como 1.1, 1.2e 1.3. No pipeline, a versão do grupo de tarefas é exibida como 1.*.

Use atualizações de versão secundárias para pequenas alterações no grupo de tarefas, quando você espera que os pipelines usem a nova alteração sem alterar o número da versão na definição do pipeline.

Criar uma atualização de versão principal

Para criar uma nova versão principal, salve as atualizações do grupo de tarefas como rascunho e crie uma visualização, valide as alterações e publique a visualização.

Esse processo aumenta o grupo de tarefas para uma nova versão. Se você tinha um grupo de tarefas com a versão 1.*, as novas versões são publicadas como 2.*, 3.*, 4.*e assim por diante.

Uma notificação sobre a disponibilidade da nova versão aparece em todas as definições de pipeline que usam o grupo de tarefas. Os usuários devem atualizar explicitamente para a nova versão do grupo de tarefas se quiserem usá-la em seus pipelines.

Ao fazer alterações substanciais que podem quebrar pipelines existentes, você pode testar e implantar as alterações como uma nova versão principal. Os usuários podem optar por atualizar para a nova versão ou permanecer na versão atual. Esta funcionalidade é a mesma que uma atualização de versão de tarefa regular.

Testar uma atualização de versão secundária

Se a atualização do grupo de tarefas não for uma alteração contínua, mas você quiser testar primeiro e, em seguida, forçar todos os pipelines a usar as alterações mais recentes, siga estas etapas:

1. Salve as alterações do grupo de tarefas como rascunho. Um novo grupo de tarefas de rascunho chamado <Taskgroupname> (Rascunho) é criado com suas alterações.
2. Adicione este grupo de tarefas de rascunho diretamente ao seu pipeline de teste.
3. Valide as alterações em seu pipeline de teste. Quando estiver confiante nas alterações, volte ao seu grupo de tarefas principal, faça as mesmas alterações e salve-as diretamente. As alterações são salvas como uma atualização de versão secundária.
4. As novas alterações agora aparecem em todos os pipelines que usam esse grupo de tarefas. Agora você pode excluir seu grupo de tarefas de rascunho.

Ajuda e suporte

• Explore as dicas de solução de problemas.
• Obtenha conselhos sobre Stack Overflow.
• Publique suas perguntas, procure respostas ou sugira um recurso na Comunidade de Desenvolvedores do Azure DevOps.
• Obtenha suporte para o Azure DevOps.

Conteúdos relacionados

• Tarefas
• Trabalhos de tarefa