Grupos de tarefas nos 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 podem ser acessados fora do escopo do projeto.

Os grupos de tarefas são uma forma de padronizar e gerenciar de modo centralizado as etapas de implantação de todos os 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. Você não precisa alterar cada definição individualmente.

Pré-requisitos

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

Extrair parâmetros de tarefa como variáveis

Quando 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 e convertidas automaticamente 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.

Também é possível alterar os valores padrão para os parâmetros ao salvar o novo grupo de tarefas. Quando você enfileira uma execução de pipeline ou uma versão, 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 todos os parâmetros que você deseja configurar em execuções de pipeline como variáveis, tais 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, tais como Executar esta tarefa somente quando uma tarefa anterior falhou para uma tarefa de Script do PowerShell Script, essas condições são persistentes com o grupo de tarefas.

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 em que 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 então 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 em seu pipeline.

6. Todas as '$(vars)' das tarefas subjacentes, exceto as variáveis predefinidas, aparecerão 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ê tiver uma entrada de tarefa foobar que não pretendia parametrizar, a entrada da tarefa será 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 como $(foobar) para garantir que, no tempo de execução, a tarefa expandida obtenha a entrada pretendida.

7. Salve o pipeline atualizado.

Gerenciar grupos de tarefas

Todos os grupos de tarefas criados no projeto atual são listados na página 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 ou selecione o ícone Mais ações do 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, é possível editar as tarefas que compõem o grupo de tarefas. Para cada tarefa encapsulada, você pode alterar os valores de parâmetro para os parâmetros não variáveis, editar as variáveis de parâmetro existentes ou converter valores de parâmetro de e para variáveis. Ao salvar as alterações, todas as definições que usam esse grupo de tarefas refletem 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, é possível ver o histórico de alterações no grupo.

• Na guia Referências, é possível expandir listas de todos os pipelines de build e lançamento e outros grupos de tarefas que usam (referência) esse grupo de tarefas. Essa listagem ajuda a garantir que as alterações não tenham efeitos inesperados em outros processos.

Criar prévias e versões atualizadas de grupos de tarefas

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

1. Para controlar a versão de um grupo de tarefas, depois de concluir a edição, selecione Salvar como rascunho, em vez de Salvar.

   

2. A cadeia de caracteres -test é acrescentada ao número de versão do grupo de tarefas. Quando estiver satisfeito com as alterações, escolha Publicar rascunho. Na tela Publicar grupo tarefas de rascunho , selecione Publicar como prévia se quiser publicar a nova versão como uma prévia e então selecione Publicar.

   

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

   

4. Depois de concluir o teste do grupo de tarefas atualizado, escolha Publicar prévia e então selecione Publicar. A string Prévia é removida do número da versão e a versão agora aparece nas 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 de build ou lançamento que já contém esse 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 do grupo de tarefas

As atualizações do grupo de tarefas podem ser atualizações de versão secundárias ou 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 da versão 1, você poderá ter qualquer número de atualizações de versão secundárias, como 1.1, 1.2 e 1.3. No pipeline, a versão do grupo de tarefas é mostrada 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 versão prévia, valide as alterações e então publique a versão prévia.

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

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

Ao fazer alterações consideráveis que podem interromper os pipelines existentes, você pode testar e distribuir 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. Essa funcionalidade é igual a uma atualização normal da versão da tarefa.

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

Se a atualização do grupo de tarefas não for uma alteração considerável, mas você quiser testar primeiro e depois 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 as suas alterações.
2. Adicione esse grupo de tarefas de rascunho diretamente ao 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 grupo de tarefas. Agora você pode excluir seu grupo de tarefas de rascunho.

Ajuda e suporte

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

Conteúdo relacionado

• Tarefas
• Trabalhos de tarefa