Dela via

steps.task definition

  • Artikel

Ett task steg kör en uppgift.

Alla uppgifter stöder följande uppsättning vanliga egenskaper.

steps:
- 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.

steps:
- 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.

Definitioner som refererar till den här definitionen: steg

Egenskaper

task sträng. Krävs som första egenskap.
Namnet på den uppgift som ska köras.

inputs strängordlista.
indata för uppgiften.

condition sträng.
Utvärdera det här villkorsuttrycket för att avgöra om den här aktiviteten ska köras.

continueOnError boolesk.
Vill du fortsätta köra även vid fel?

displayName sträng.
läsbart namn för aktiviteten.

target mål.
miljö där den här uppgiften ska köras.

enabled boolesk.
Kör du den här uppgiften när jobbet körs?

env strängordlista.
variabler som ska mappas till processens miljö.

name sträng.
ID för steget. Godtagbara värden: [-_A-Za-z0-9]*.

timeoutInMinutes sträng.
Tid att vänta tills den här uppgiften har slutförts innan servern avslutar den. Om du till exempel vill konfigurera en tidsgräns på 10 minuter använder du timeoutInMinutes: 10.

Anmärkning

Pipelines kan konfigureras med en tidsgräns på jobbnivå. Om tidsgränsintervallet på jobbnivå förflutit innan steget slutförs avslutas det jobb som körs (inklusive ditt steg), även om steget har konfigurerats med ett längre timeoutInMinutes intervall. Mer information finns i timeouter.

retryCountOnTaskFailure sträng.
Antal återförsök om aktiviteten misslyckas. På Azure DevOps Server 2022, 2022.1 och 2022.2 stöds återförsök endast på agentjobb. Mer information finns i Azure DevOps-tjänstuppdatering 16 november 2021 – Automatiska återförsök för en uppgift och Azure DevOps-tjänstuppdatering 14 juni 2025 – Återförsök för serveruppgifter.

Anmärkningar

Uppgifter är byggstenarna i en pipeline. Det finns en katalog med uppgifter att välja mellan.

Om du inte anger något kommandoläge kan du förkorta target struktur till:

- task:
  target: string  # container name or the word 'host'

Vanliga uppgiftsegenskaper

Alla uppgifter har stöd för en uppsättning vanliga egenskaper utöver name och inputs. En lista över vanliga uppgiftsegenskaper finns i avsnittet Egenskaper ovan. Mer information om hur du konfigurerar dessa egenskaper finns i Alternativ för aktivitetskontroll och miljövariabler för aktivitet.

Läs mer om villkor, tidsgränseroch stegmål.

Exempel

steps:
- task: VSBuild@1
  displayName: Build
  timeoutInMinutes: 120
  inputs:
    solution: '**\*.sln'

Se även