Tipos de tarefas e uso

No YAML, você especifica a versão principal usando @ o nome da tarefa. Por exemplo, para fixar na versão 2 da PublishTestResults tarefa:

steps:
- task: PublishTestResults@2

Os pipelines YAML não estão disponíveis no TFS.

As opções de controle estão disponíveis como teclas na task seção.

- task: string # Required as first property. Name of the task to run.
  inputs: # Inputs for the task.
    string: string # Name/value pairs
  condition: string # Evaluate this condition expression to determine whether to run this task.
  continueOnError: boolean # Continue running even on failure?
  displayName: string # Human-readable name for the task.
  enabled: boolean # Run this task when the job runs?
  env: # Variables to map into the process's environment.
    string: string # Name/value pairs
  name: string # ID of the step.
  timeoutInMinutes: string # Time to wait for this task to complete before the server kills it.

As opções de controle estão disponíveis como teclas na task seção.

- task: string # Required as first property. Name of the task to run.
  inputs: # Inputs for the task.
    string: string # Name/value pairs
  condition: string # Evaluate this condition expression to determine whether to run this task.
  continueOnError: boolean # Continue running even on failure?
  displayName: string # Human-readable name for the task.
  target: string | target # Environment in which to run this task.
  enabled: boolean # Run this task when the job runs?
  env: # Variables to map into the process's environment.
    string: string # Name/value pairs
  name: string # ID of the step.
  timeoutInMinutes: string # Time to wait for this task to complete before the server kills it.

As opções de controle estão disponíveis como teclas na task seção.

- task: string # Required as first property. Name of the task to run.
  inputs: # Inputs for the task.
    string: string # Name/value pairs
  condition: string # Evaluate this condition expression to determine whether to run this task.
  continueOnError: boolean # Continue running even on failure?
  displayName: string # Human-readable name for the task.
  target: string | target # Environment in which to run this task.
  enabled: boolean # Run this task when the job runs?
  env: # Variables to map into the process's environment.
    string: string # Name/value pairs
  name: string # ID of the step.
  timeoutInMinutes: string # Time to wait for this task to complete before the server kills it.
  retryCountOnTaskFailure: string # Number of retries if the task fails.

O período de tempo limite começa quando a tarefa começa a ser executada. Ele não inclui o tempo que a tarefa está na fila ou aguardando por um agente.

Neste YAML, PublishTestResults@2 é executado mesmo se a etapa anterior falhar devido à condição succeededOrFailed().

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

Condições

• Somente quando todas as dependências diretas e indiretas anteriores com o mesmo pool de agentes forem bem-sucedidas. Se você tiver pools de agentes diferentes, esses estágios ou trabalhos serão executados simultaneamente. Esta condição é o padrão se nenhuma condição estiver definida no YAML.

• Mesmo que uma dependência anterior falhe, a menos que a execução seja cancelada. Use succeededOrFailed() no YAML para esta condição.

• Mesmo que uma dependência anterior falhe e mesmo que a execução seja cancelada. Use always() no YAML para esta condição.

• Apenas quando uma dependência anterior falha. Use failed() no YAML para esta condição.

• Condições personalizadas, que são compostas por expressões

Alvo da etapa

As tarefas são executadas em um contexto de execução, que é o host do agente ou um contêiner. Uma etapa individual pode substituir seu contexto especificando um targetarquivo . As opções disponíveis são a palavra host para direcionar o host do agente mais quaisquer contêineres definidos no pipeline. Por exemplo:

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

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

Aqui, o SampleTask é executado no host e AnotherTask executado em um contêiner.

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

Use retryCountOnTaskFailure para especificar o número de novas tentativas se a tarefa falhar. O padrão é zero tentativas. Para obter mais informações sobre as propriedades da tarefa, consulte steps.task no esquema YAML.

- task: <name of task>
  retryCountOnTaskFailure: <max number of retries>
   ...

Os pipelines YAML não estão disponíveis no TFS.

- task: AzureCLI@2
  displayName: Azure CLI
  inputs: # Specific to each task
  env:
    ENV_VARIABLE_NAME: value
    ENV_VARIABLE_NAME2: value
  ...

O exemplo a seguir executa a script etapa, que é um atalho para a tarefa de linha de comando, seguida pela sintaxe da tarefa equivalente. Este exemplo atribui um valor à variável de ambiente, que é usada para autenticar com a AZURE_DEVOPS_EXT_PAT CLI do Azure DevOps.

# Using the script shortcut syntax
- script: az pipelines variable-group list --output table
  env:
    AZURE_DEVOPS_EXT_PAT: $(System.AccessToken)
  displayName: 'List variable groups using the script step'

# Using the task syntax
- task: CmdLine@2
  inputs:
    script: az pipelines variable-group list --output table
  env:
    AZURE_DEVOPS_EXT_PAT: $(System.AccessToken)
  displayName: 'List variable groups using the command line task'

- task: Bash@3
  inputs:
     targetType: # specific to each task
  env:
    ENV_VARIABLE_NAME: value
    ENV_VARIABLE_NAME2: value
  ...

O exemplo a seguir executa a script etapa, que é um atalho para a Bash@3, seguida pela sintaxe de tarefa equivalente. Este exemplo atribui um valor à ENV_VARIABLE_NAME variável de ambiente e ecoa o valor.

# Using the script shortcut syntax
- script: echo "This is " $ENV_VARIABLE_NAME
  env:
    ENV_VARIABLE_NAME: "my value"
  displayName: 'echo environment variable'

# Using the task syntax
- task: Bash@2
  inputs:
    script: echo "This is " $ENV_VARIABLE_NAME
  env:
    ENV_VARIABLE_NAME: "my value"
  displayName: 'echo environment variable'

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

pool:
  vmImage: ubuntu-latest

steps:
# Node install
- task: UseNode@1
  displayName: Node install
  inputs:
    version: '16.x' # The version we're installing
# Write the installed version to the command line
- script: which node

Crie um novo pipeline de compilação e execute-o. Observe como a compilação é executada. 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 registra o local da versão Node.js no disco.

Os pipelines YAML não estão disponíveis no TFS.