Grupos de tarefas para construções e lançamentos (clássico)

Azure DevOps Services | Azure DevOps Server | 2020 Azure DevOps Server | 2019 TFS 2018

Nota

No Microsoft Team Foundation Server (TFS) 2018 e nas versões anteriores, os oleodutos de construção e libertação são chamados definições, as corridas são chamadas de construções, as ligações de serviço são chamadas pontos finais de serviço, as fases são chamadas de ambientes, e os empregos são chamados de fases.

Nota

Os grupos de tarefas não são suportados em gasodutos YAML. Em vez disso, pode usar modelos. Consulte a referência de esquema YAML.

Um grupo de tarefas permite-lhe encapsular uma sequência de tarefas, já definidas num gasoduto de construção ou libertação, numa única tarefa reutilizável que pode ser adicionada a um gasoduto de construção ou libertação, como qualquer outra tarefa. Pode optar por extrair os parâmetros das tarefas encapsuladas como variáveis de configuração e resumir o resto da informação da tarefa.

O novo grupo de tarefas é automaticamente adicionado ao catálogo de tarefas, pronto para ser adicionado a outros lançamentos e construir gasodutos. Os grupos de tarefas são armazenados ao nível do projeto e não são acessíveis fora do âmbito do projeto.

Os grupos de tarefas são uma forma de normalizar e gerir centralmente as etapas de implementação de todas as suas aplicações. Quando você inclui um grupo de tarefas nas suas definições, e em seguida, fazer uma alteração central para o grupo de tarefas, a alteração é automaticamente refletida em todas as definições que usam o grupo de tarefas. Não há necessidade de mudar cada um individualmente.

Antes de criar um grupo de trabalho...

  • Certifique-se de que todas as tarefas que pretende incluir num grupo de tarefas têm os seus parâmetros definidos como variáveis, tais como $(MyVariable), onde pretende ser capaz de configurar estes parâmetros quando utilizar o grupo de tarefas. As variáveis utilizadas nas tarefas são automaticamente extraídas e convertidas em parâmetros para o grupo de trabalho. Os valores destas variáveis de configuração serão convertidos em valores predefinidos para o grupo de trabalho.

  • Se especificar um valor (em vez de uma variável) para um parâmetro, esse valor torna-se um valor de parâmetro fixo e não pode ser exposto como parâmetro ao grupo de trabalho.

  • Os parâmetros das tarefas encapsuladas para as quais especificou um valor (em vez de uma variável), ou não forneceu um valor para, não são configuráveis no grupo de tarefas quando adicionados a um gasoduto de construção ou libertação.

  • As condições de tarefa (como "Executar esta tarefa apenas quando uma tarefa anterior falhou" para uma tarefa do Script PowerShell ) podem ser configuradas num grupo de tarefas e estas definições são persistiu com o grupo de trabalho.

  • Ao guardar o grupo de trabalho, pode fornecer um nome e uma descrição para o novo grupo de trabalho e selecionar uma categoria onde deseja que apareça no diálogo do catálogo de tarefas . Também pode alterar os valores predefinidos para cada um dos parâmetros.

  • Quando faz fila de uma construção ou de um desbloqueio, as tarefas encapsuladas são extraídas e os valores introduzidos para os parâmetros do grupo de tarefas são aplicados às tarefas.

  • As alterações que faz a um grupo de trabalho refletem-se em todas as instâncias do grupo de trabalho.

Criar um grupo de tarefas

  1. Certifique-se de que todas as tarefas que pretende incluir não contêm parâmetros ligados. A maneira mais fácil de fazer isto é escolher desvincular tudo no painel de definições para todo o processo.

    Unlinking parameters for all tasks

  2. Selecione uma sequência de tarefas num pipeline de construção ou libertação, abra o menu de atalho e, em seguida, escolha Criar grupo de tarefas.

    Creating a task group from a release pipeline list of tasks

  3. Especifique um nome e descrição para o novo grupo de tarefas, e a categoria (separador no painel de tarefas Adicionar) a que pretende adicioná-lo.

  4. Depois de escolher Criar, o novo grupo de trabalho é criado e substitui as tarefas selecionadas no seu pipeline.

  5. Todos os '$(vars)' das tarefas subjacentes, excluindo as variáveis predefinidas, surgirão como parâmetros obrigatórios para o grupo de trabalho recém-criado.

    Por exemplo, digamos que tem uma entrada de tarefas $(foobar), que não pretende parametrizar. No entanto, quando cria um grupo de tarefas, a entrada de tarefa é convertida em parâmetro de grupo de tarefa 'foobar'. Agora, pode fornecer o valor predefinido para o parâmetro do grupo de tarefas 'foobar' como $(foobar). Isto garante que, em tempo de execução, a tarefa expandida obtém a mesma entrada a que se destina.

  6. Guarde o seu oleoduto atualizado.

Gerir grupos de tarefas

Todos os grupos de tarefas que cria no projeto atual estão listados na página grupos de tarefas dos Pipelines Azure.

Listing task groups

Utilize o comando de atalho exportação para guardar uma cópia do grupo de trabalho como um oleoduto JSON e o ícone Import para importar definições de grupo de tarefas previamente guardadas. Utilize esta funcionalidade para transferir grupos de tarefas entre projetos e empresas, ou replicar e guardar cópias dos seus grupos de trabalho.

Selecione um nome de grupo de tarefa para abrir a página de detalhes.

Managing a task group

  • Na página Tarefas pode editar as tarefas que compõem o grupo de trabalho. Para cada tarefa encapsulada pode alterar os valores de parâmetro para os parâmetros não variáveis, editar as variáveis parâmetros existentes ou converter valores de parâmetros de e para variáveis. Quando guardar as alterações, todas as definições que utilizam este grupo de trabalho irão recolher as alterações.

Todos os parâmetros variáveis do grupo de trabalho aparecerão como parâmetros obrigatórios na definição do gasoduto. Também pode definir o valor predefinido para os parâmetros do grupo de tarefa.

  • No separador Histórico pode ver a história das alterações ao grupo.

  • No separador Referências pode expandir listas de todos os oleodutos de construção e libertação, e outros grupos de tarefas que utilizam (referência) este grupo de tarefas. Isto é útil para garantir que as alterações não têm efeitos inesperados em outros processos.

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

Todas as tarefas incorporadas nos Oleodutos Azure e TFS são versadas. Isto permite construir e libertar oleodutos para continuar a utilizar a versão existente de uma tarefa enquanto novas versões são desenvolvidas, testadas e lançadas. Nos Azure Pipelines, pode versão dos seus próprios grupos de tarefas personalizados para que se comportem da mesma forma e ofereçam as mesmas vantagens.

  1. Depois de terminar de editar um grupo de tarefas, escolha Guardar como rascunho em vez de Salvar.

    Saving a draft update to a task group

  2. O teste de cadeia é anexado ao número da versão do grupo de tarefas. Quando estiver satisfeito com as alterações, escolha o projeto de publicação. Pode escolher se deve publicá-lo como pré-visualização ou como uma versão pronta para a produção.

    Publishing a draft version of a task group

  3. Pode agora utilizar o grupo de trabalho atualizado nos seus processos de construção e libertação; quer alterando o número de versão do grupo de trabalho num oleoduto existente ou adicionando-o ao painel de tarefas Add .

    Using a preview version of a task group

    Tal como acontece com as tarefas incorporadas, o padrão quando se adiciona um grupo de tarefas é a versão de não pré-visualização mais alta.

  4. Depois de ter terminado de testar o grupo de trabalho atualizado, escolha a pré-visualização de Publicação. A cadeia de pré-visualização é removida da cadeia de números da versão. Aparecerá agora em definições como uma versão "pronta para a produção".

    Publishing a preview version of a task group

  5. Num pipeline de construção ou lançamento que já contenha este grupo de tarefas, pode agora selecionar a nova versão "pronto para a produção". Quando adiciona o grupo de tarefas do painel de tarefas Add , seleciona automaticamente a nova versão "pronto para a produção".

    Using an updated version of a task group

Trabalhar com versões de grupo de tarefas

Qualquer atualização do grupo de tarefas pode ser uma atualização de versão menor ou importante.

Versão secundária

Ação: Guarde diretamente o grupo de tarefas após a edição em vez de o guardar como rascunho.

Efeito: O número da versão não muda. Digamos que tem um grupo de tarefas de versão 1.0. Pode ter várias atualizações de versão menores, ou seja 1.1, 1.2etc 1.3 . No seu pipeline, a versão do grupo de tarefas mostra que 1.* as alterações mais recentes aparecerão automaticamente na definição do pipeline.

Razão: Isto é suposto ser uma pequena mudança no grupo de trabalho e espera-se que os oleodutos utilizem esta nova alteração sem editar a versão na definição do pipeline.

Versão principal

Ação: Guarde o grupo de tarefas como rascunho e, em seguida, crie uma pré-visualização, valide o grupo de tarefas e, em seguida, publique a pré-visualização como uma versão importante.

Efeito: O grupo de trabalho sobe para uma nova versão. Digamos que tem um grupo de tarefas de versão 1.*. Uma nova versão é publicada como 2.*, 3.*etc 4.* . E uma notificação sobre a disponibilidade de nova versão aparece em todas as definições de pipeline onde este grupo de tarefas é usado. O utilizador tem de atualizar explicitamente a nova versão do grupo de trabalho em pipelines.

Razão: Quando tiver uma alteração substancial que possa quebrar os oleodutos existentes, gostaria de testá-lo e lançar como uma nova versão. Os utilizadores podem optar por fazer o upgrade para a nova versão ou optar por permanecer na mesma versão. Esta funcionalidade é a mesma que uma atualização normal da versão de tarefa.

No entanto, se a atualização do seu grupo de tarefas não for uma mudança de rutura, mas pretender validar primeiro e, em seguida, impor os oleodutos para consumir as alterações mais recentes, pode seguir os passos abaixo.

  1. Atualize o grupo de trabalho com as alterações desejadas e guarde-o como rascunho. Será criado um novo projeto de grupo de trabalho '<Taskgroupname-Draft>' que contém as alterações que fez. E este grupo de tarefas está acessível para que você consuma nos seus oleodutos.
  2. Agora, em vez de publicar como pré-visualização, pode consumir diretamente este grupo de tarefas no seu pipeline de teste.
  3. Valide este novo grupo de tarefas no seu pipeline de teste e assim que estiver confiante, volte ao seu grupo de trabalho principal e faça as mesmas alterações e guarde-o diretamente. Isto será tomado como uma pequena atualização da versão.
  4. As novas alterações irão agora aparecer em todos os oleodutos onde este grupo de trabalho é utilizado.
  5. Agora pode eliminar o seu grupo de trabalho de projeto.

Ajuda e suporte