jobs.jobdefinitie

Artikel
04/16/2024

Een taak is een verzameling stappen die worden uitgevoerd door een agent of op een server.

jobs:
- job: string # Required as first property. ID of the job.
  displayName: string # Human-readable name for the job.
  dependsOn: string | [ string ] # Any jobs which must complete before this one.
  condition: string # Evaluate this condition expression to determine whether to run this job.
  continueOnError: string # Continue running even on failure?
  timeoutInMinutes: string # Time to wait for this job to complete before the server kills it.
  cancelTimeoutInMinutes: string # Time to wait for the job to cancel before forcibly terminating it.
  variables: variables | [ variable ] # Job-specific variables.
  strategy: strategy # Execution strategy for this job.
  pool: string | pool # Pool where this job will run.
  container: string | container # Container resource name.
  services: # Container resources to run as a service container.
    string: string # Name/value pairs
  workspace: # Workspace options on the agent.
    clean: string # Which parts of the workspace should be scorched before fetching.
  uses: # Any resources required by this job that are not already referenced.
    repositories: [ string ] # Repository references.
    pools: [ string ] # Pool references.
  steps: [ task | script | powershell | pwsh | bash | checkout | download | downloadBuild | getPackage | publish | template | reviewApp ] # A list of steps to run.
  templateContext: # Job related information passed from a pipeline when extending a template.

jobs:
- job: string # Required as first property. ID of the job.
  displayName: string # Human-readable name for the job.
  dependsOn: string | [ string ] # Any jobs which must complete before this one.
  condition: string # Evaluate this condition expression to determine whether to run this job.
  continueOnError: string # Continue running even on failure?
  timeoutInMinutes: string # Time to wait for this job to complete before the server kills it.
  cancelTimeoutInMinutes: string # Time to wait for the job to cancel before forcibly terminating it.
  variables: variables | [ variable ] # Job-specific variables.
  strategy: strategy # Execution strategy for this job.
  pool: string | pool # Pool where this job will run.
  container: string | container # Container resource name.
  services: # Container resources to run as a service container.
    string: string # Name/value pairs
  workspace: # Workspace options on the agent.
    clean: string # Which parts of the workspace should be scorched before fetching.
  uses: # Any resources required by this job that are not already referenced.
    repositories: [ string ] # Repository references.
    pools: [ string ] # Pool references.
  steps: [ task | script | powershell | pwsh | bash | checkout | download | downloadBuild | getPackage | publish | template | reviewApp ] # A list of steps to run.

jobs:
- job: string # Required as first property. ID of the job.
  displayName: string # Human-readable name for the job.
  dependsOn: string | [ string ] # Any jobs which must complete before this one.
  condition: string # Evaluate this condition expression to determine whether to run this job.
  continueOnError: string # Continue running even on failure?
  timeoutInMinutes: string # Time to wait for this job to complete before the server kills it.
  cancelTimeoutInMinutes: string # Time to wait for the job to cancel before forcibly terminating it.
  variables: variables | [ variable ] # Job-specific variables.
  strategy: strategy # Execution strategy for this job.
  pool: string | pool # Pool where this job will run.
  container: string | container # Container resource name.
  services: # Container resources to run as a service container.
    string: string # Name/value pairs
  workspace: # Workspace options on the agent.
    clean: string # Which parts of the workspace should be scorched before fetching.
  steps: [ task | script | powershell | pwsh | bash | checkout | download | downloadBuild | getPackage | publish | template | reviewApp ] # A list of steps to run.

jobs:
- job: string # Required as first property. ID of the job.
  displayName: string # Human-readable name for the job.
  dependsOn: string | [ string ] # Any jobs which must complete before this one.
  condition: string # Evaluate this condition expression to determine whether to run this job.
  continueOnError: string # Continue running even on failure?
  timeoutInMinutes: string # Time to wait for this job to complete before the server kills it.
  cancelTimeoutInMinutes: string # Time to wait for the job to cancel before forcibly terminating it.
  variables: variables | [ variable ] # Job-specific variables.
  strategy: strategy # Execution strategy for this job.
  pool: string | pool # Pool where this job will run.
  container: string | container # Container resource name.
  services: # Container resources to run as a service container.
    string: string # Name/value pairs
  workspace: # Workspace options on the agent.
    clean: string # Scorch the repo before fetching?
  steps: [ task | script | powershell | pwsh | bash | checkout | download | downloadBuild | publish | template ] # A list of steps to run.

jobs:
- job: string # Required as first property. ID of the job.
  displayName: string # Human-readable name for the job.
  dependsOn: string | [ string ] # Any jobs which must complete before this one.
  condition: string # Evaluate this condition expression to determine whether to run this job.
  continueOnError: string # Continue running even on failure?
  timeoutInMinutes: string # Time to wait for this job to complete before the server kills it.
  cancelTimeoutInMinutes: string # Time to wait for the job to cancel before forcibly terminating it.
  variables: variables | [ variable ] # Job-specific variables.
  strategy: strategy # Execution strategy for this job.
  pool: string | pool # Pool where this job will run.
  services: # Container resources to run as a service container.
    string: string # Name/value pairs
  workspace: # Workspace options on the agent.
    clean: string # Scorch the repo before fetching?
  steps: [ task | script | powershell | pwsh | bash | checkout | download | downloadBuild | publish | template ] # A list of steps to run.

Definities die naar deze definitie verwijzen: taken

Eigenschappen

job Tekenreeks. Vereist als eerste eigenschap.
Id van de taak. Acceptabele waarden: geldige namen mogen alleen alfanumerieke tekens en '_' bevatten en mogen niet beginnen met een getal.

displayName Tekenreeks.
Door mensen leesbare naam voor de taak.

dependsOn tekenreeks | tekenreekslijst.
Alle taken die vóór deze taak moeten worden voltooid.

condition Tekenreeks.
Evalueer deze voorwaardeexpressie om te bepalen of deze taak moet worden uitgevoerd.

continueOnError Tekenreeks.
Doorgaan met uitvoeren, zelfs bij een fout?

timeoutInMinutes Tekenreeks.
Tijd om te wachten tot deze taak is voltooid voordat de server deze beëindigt.

cancelTimeoutInMinutes Tekenreeks.
Tijd om te wachten totdat de taak wordt geannuleerd voordat u deze geforceerd beëindigt.

variablesvariabelen.
Taakspecifieke variabelen.

strategyjobs.job.strategy.
Uitvoeringsstrategie voor deze taak.

poolzwembad.
Pool waar deze taak wordt uitgevoerd.

containerjobs.job.container.
Naam van containerresource.

services tekenreekswoordenlijst.
Containerresources die moeten worden uitgevoerd als een servicecontainer.

workspacewerkruimte.
Werkruimteopties op de agent. Zie het onderwerp werkruimte in Taken voor meer informatie over werkruimten, waaronder opties voor opschonen.

usesjobs.job.uses.
Alle resources die voor deze taak zijn vereist en waarnaar nog niet wordt verwezen. Zie Taakautorisatiebereik beperken tot Azure DevOps-opslagplaatsen waarnaar wordt verwezen voor meer informatie overuses.

stepsstappen.
Een lijst met uit te voeren stappen.

templateContext templateContext.
Taakgerelateerde informatie die vanuit een pijplijn wordt doorgegeven bij het uitbreiden van een sjabloon. Zie opmerkingen voor meer informatie. Zie Extended YAML Pipelines templates can now be passed context information for stages, jobs, and deployments (Extended YAML Pipelines templates can now be passed context information for stages, jobs, and deployments) en Templates - Use templateContext to pass properties to templates (Sjablonen gebruiken om eigenschappen door te geven aan sjablonen) voor meer informatie overtemplateContext.

Opmerkingen

De standaardwaarde timeoutInMinutes is ingesteld op 60 minuten. Zie Time-outs voor meer informatie.

Taken kunnen voorwaardelijk worden uitgevoerd en kunnen afhankelijk zijn van eerdere taken.

Notitie

Als u slechts één fase en één taak hebt, kunt u de syntaxis van één taak gebruiken als een kortere manier om de uit te voeren stappen te beschrijven.

Zie Extended YAML Pipelines templates can now be passed context information for stages, jobs, and deployments (Extended YAML Pipelines templates can now be passed context information for stages, jobs, and deployments) en Templates - Use templateContext to pass properties to templates (Sjablonen gebruiken om eigenschappen door te geven aan sjablonen) voor meer informatie overtemplateContext.

Voorbeelden

jobs:
- job: MyJob
  displayName: My First Job
  continueOnError: true
  workspace:
    clean: outputs
  steps:
  - script: echo My first job

Zie ook

Zie Taakautorisatiebereik beperken tot Azure DevOps-opslagplaatsen waarnaar wordt verwezen voor meer informatie overuses.
Zie het onderwerp werkruimte in Taken voor meer informatie over werkruimten, waaronder opties voor opschonen.
Meer informatie over variabelen, stappen, pools en servertaken.