Tipos de tarefas e uso

No YAML, você especifica a versão principal usando @ o nome da tarefa. Por exemplo, para usar a PublishTestResults versão 2 da tarefa, especifique PublishTestResults@2. Você pode especificar qual versão secundária usar fornecendo o número completo da versão da tarefa após o @, como GoTool@0.3.1.

Nos pipelines clássicos, cada tarefa tem um seletor de versão para permitir que você escolha a versão desejada. Considere clonar o pipeline e testá-lo com novas versões de tarefas principais. Se você selecionar uma versão de visualização, como 1.* Preview, a versão ainda está em desenvolvimento e pode ter problemas.

Se você alterar a versão e tiver problemas com suas compilações, poderá reverter a alteração do pipeline na guia Histórico . Para pipelines de versão, a capacidade de restaurar para uma versão mais antiga não está disponível. Você deve reverter manualmente as alterações para o pipeline de liberação e, em seguida, salvá-lo.

As propriedades a seguir estão disponíveis para as etapas de pipeline task do YAML. Para obter mais informações, consulte a definição steps.task .

Condições

Uma tarefa não pode determinar se deve continuar o trabalho de pipeline após a conclusão da tarefa, apenas fornecer um status final, como succeeded ou failed. As tarefas e trabalhos a jusante podem então definir um condition com base nesse status para determinar se devem ser executados.

A propriedade conditions especifica as condições sob as quais essa tarefa é executada. Por padrão, uma etapa é executada se nada em seu trabalho ainda falhou e a etapa imediatamente anterior foi concluída.

Você pode substituir ou personalizar esses padrões definindo a etapa para ser executada mesmo se ou somente se uma dependência anterior falhar ou tiver outro resultado. Você também pode definir condições personalizadas, que são compostas por expressões.

As condições baseadas no status de dependência anterior incluem:

• Êxito: execute somente se todas as dependências anteriores forem bem-sucedidas. Esse comportamento é o padrão se nenhuma condição estiver definida no YAML. Para aplicar essa condição, especifique condition: succeeded().
• Êxito ou falha: execute mesmo se uma dependência anterior falhar, a menos que a execução seja cancelada. Para aplicar essa condição, especifique condition: succeededOrFailed().
• Sempre: Executar mesmo se uma dependência anterior falhar, mesmo que a execução seja cancelada. Para aplicar essa condição, especifique condition: always().
• Falha: Execute somente quando uma dependência anterior falhar. Para aplicar essa condição, especifique condition: failed().

No exemplo YAML a seguir, PublishTestResults@2 é executado mesmo se a etapa anterior falhou, devido à sua condição succeededOrFailed .

steps:
- task: UsePythonVersion@0
  inputs:
    versionSpec: '3.x'
    architecture: 'x64'
- task: PublishTestResults@2
  inputs:
    testResultsFiles: "**/TEST-*.xml"
  condition: succeededOrFailed()

Continuar com o erro

A continueOnError propriedade informa à tarefa se deve continuar a execução e relatar o sucesso, independentemente das falhas. Se definido como true, essa propriedade informa à tarefa para ignorar um failed status e continuar a execução. As etapas e trabalhos a jusante tratam o resultado da tarefa como success quando tomam suas decisões de execução.

Ativado(a)

Por padrão, a tarefa é executada sempre que o trabalho é executado. Você pode definir enabled como false para desativar a tarefa. A desativação temporária da tarefa é útil para removê-la do processo para fins de teste ou para implantações específicas.

Contar novas tentativas com falha na tarefa

A retryCountOnTaskFailure propriedade especifica o número de vezes que a tarefa será repetida se ela falhar. O padrão é zero tentativas.

• O número máximo de tentativas permitidas é 10.
• O tempo de espera antes de tentar novamente aumenta após cada tentativa falhada, seguindo uma estratégia de recuo exponencial. A primeira tentativa acontece após 1 segundo, a segunda após 4 segundos e a décima após 100 segundos.
• Repetir a tarefa não fornece idempotência. Os efeitos colaterais da primeira tentativa, como a criação parcial de um recurso externo, podem fazer com que as tentativas falhem.
• Nenhuma informação sobre o número de novas tentativas é disponibilizada para a tarefa.
• A falha da tarefa adiciona um aviso aos logs de tarefas indicando que ela falhou antes de tentar novamente a tarefa.
• Todas as tentativas de repetição são exibidas na interface do usuário como parte do mesmo nó de tarefa.

resources:
  containers:
  - container: pycontainer
    image: python:3.11

steps:
- task: SampleTask@1
  target: host
- task: AnotherTask@1
  target: pycontainer

Limite de tempo excedido

O período de tempo limite começa quando a tarefa começa a ser executada e não inclui o tempo em que a tarefa está enfileirada ou aguardando um agente.

Nos pipelines clássicos, as tarefas oferecem várias opções de controle.

Ativado(a)

Desmarque a caixa de seleção Habilitado para desabilitar uma tarefa. A desativação temporária da tarefa é útil para removê-la do processo para fins de teste ou para implantações específicas.

Continuar com o erro

Selecione esta opção se desejar que esta tarefa relate o sucesso, mesmo que falhe, possivelmente permitindo que tarefas dependentes no mesmo trabalho sejam executadas. A compilação ou implantação geral não pode ser mais do que parcialmente bem-sucedida. Se as tarefas subsequentes são executadas também depende da configuração Executar esta tarefa .

Número de repetições se a tarefa falhou

Especifique o número de novas tentativas se esta tarefa falhar. O padrão é zero.

• A tarefa com falha será novamente tentada em segundos. O tempo de espera antes de tentar novamente aumenta após cada tentativa falhada.
• Repetir a tarefa não fornece idempotência. Os efeitos colaterais da primeira tentativa, como a criação parcial de um recurso externo, podem fazer com que as tentativas falhem.
• Nenhuma informação sobre a contagem de tentativas é disponibilizada para a tarefa.
• A falha da tarefa adiciona um aviso aos logs de tarefas indicando que ela falhou antes de tentar novamente a tarefa.
• Todas as tentativas de repetição são exibidas na interface do usuário como parte do mesmo nó de tarefa.

Limite de tempo excedido

Insira o tempo máximo, em minutos, que a tarefa pode ser executada antes de ser cancelada automaticamente. O padrão é 0, ou tempo infinito. A definição de um valor diferente de zero substitui a configuração do trabalho de tarefa pai. O período de tempo limite começa quando a tarefa começa a ser executada e não inclui o tempo em que a tarefa está enfileirada ou aguardando um agente.

Executar esta tarefa

Selecione uma das seguintes condições para executar esta tarefa:

• Apenas quando todas as tarefas anteriores tiverem sido bem-sucedidas. Esta condição é o padrão.
• Mesmo que uma tarefa anterior tenha falhado, a menos que a compilação tenha sido cancelada
• Mesmo que uma tarefa anterior tenha falhado, mesmo que a compilação tenha sido cancelada
• Apenas quando uma tarefa anterior falhou
• Condições personalizadas e, em seguida, insira uma condição Personalizada especificando uma expressão para quando essa tarefa deve ser executada.

Uma tarefa de pipeline YAML pode especificar uma env propriedade, que lista cadeias de caracteres de nome/valor que representam variáveis de ambiente.

- task: AzureCLI@2
  env:
    ENV_VARIABLE_NAME: value
    ENV_VARIABLE_NAME2: value
  ...

Você pode definir variáveis de ambiente usando script etapas ou scripts em tarefas de linha de comando, Bash ou PowerShell.

O exemplo a seguir executa uma script etapa que atribui um valor à ENV_VARIABLE_NAME variável de ambiente e ecoa o valor.

- script: echo "This is " $ENV_VARIABLE_NAME
  env:
    ENV_VARIABLE_NAME: value
  displayName: 'echo environment variable'

O script anterior é funcionalmente o mesmo que executar uma tarefa Bash@3 com uma script entrada. O exemplo a seguir usa a task sintaxe.

- task: Bash@3
  inputs:
    script: echo "This is " $ENV_VARIABLE_NAME
  env:
    ENV_VARIABLE_NAME: value
  displayName: 'echo environment variable'

Em pipelines clássicos, você pode adicionar e editar variáveis de ambiente na seção Variáveis de ambiente do editor de tarefas.

Crie um arquivo azure-pipelines.yml que tenha o seguinte conteúdo no diretório base do seu projeto.

pool:
  vmImage: 'windows-latest'

jobs:
- job: NodeJS
  strategy:
    matrix:
      node14:
        nodeVersion: '14.x'
      node16:
        nodeVersion: '16.x'
    maxParallel: 2
  steps:
    - task: NodeTool@0
      displayName: 'Install Node.js $(nodeVersion)'
      inputs:
        versionSpec: '$(nodeVersion)'
        checkLatest: true

    - script: |
        echo Using Node version $(nodeVersion)
        node --version
      displayName: 'Verify Node Installation'

Salve e execute o pipeline. O trabalho é executado duas vezes, uma para cada versão do Node.js especificado na nodeVersion variável.

O Node.js Tool Installer baixa a versão Node.js se ela ainda não estiver no agente. O script de linha de comando grava a versão instalada na linha de comando.

1. No trabalho Agente para seu pipeline Clássico, em Plano de execução, defina Paralelismo como Multiconfiguração.

2. Em Multiplicadores, insira nodeVersion.

3. Defina Número máximo de agentes como 2.

4. Adicione a tarefa do instalador da ferramentaNode.js ao seu pipeline com as seguintes configurações:

   • Digite $(nodeVersion) em Version Spec.
   • Marque a caixa de seleção Verificar a versão mais recente.

5. Adicione a tarefa de linha de comando ao pipeline e insira o seguinte código em Script:

   echo Using Node version $(nodeVersion)
node --version

6. Na guia Variáveis, defina a variável nodeVersion com o valor 14.x, 16.x e selecione Settable no momento da fila.

   Nota

   Em um pipeline de lançamento, selecione Definível no momento da implantação. Para obter mais informações, consulte Como posso editar variáveis no momento do lançamento?

7. Selecione Guardar & enfileirar.

8. Na tela Executar pipeline , selecione Salvar e executar.

O trabalho é executado duas vezes, uma para cada versão do Node.js especificado na nodeVersion variável. A tarefa do instalador da ferramentaNode.js baixa a versão Node.js se ela ainda não estiver no agente. A tarefa de Linha de Comando regista a localização da versão do Node.js no disco.