jobs.job definition

Artikel
04/16/2024

Ein Auftrag ist eine Sammlung von Schritten, die von einem Agent oder auf einem Server ausgeführt werden.

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.

Definitionen, die auf diese Definition verweisen: Aufträge

Eigenschaften

job Schnur. Erforderlich als erste Eigenschaft.
ID des Auftrags. Zulässige Werte: Gültige Namen dürfen nur alphanumerische Zeichen und "_" enthalten und nicht mit einer Zahl beginnen.

displayName Schnur.
Lesbarer Name für den Auftrag.

dependsOn Zeichenfolge | Zeichenfolgenliste.
Alle Aufträge, die vor diesem abgeschlossen werden müssen.

condition Schnur.
Werten Sie diesen Bedingungsausdruck aus, um zu bestimmen, ob dieser Auftrag ausgeführt werden soll.

continueOnError Schnur.
Die Ausführung auch bei Einem Fehler fortsetzen?

timeoutInMinutes Schnur.
Zeit, bis dieser Auftrag abgeschlossen ist, bevor der Server ihn beendet.

cancelTimeoutInMinutes Schnur.
Zeit, auf den Abbruch des Auftrags zu warten, bevor er erzwungen wird.

variables-Variablen.
Auftragsspezifische Variablen.

strategyjobs.job.strategy.
Ausführungsstrategie für diesen Auftrag.

pool-Pool.
Pool, in dem dieser Auftrag ausgeführt wird.

containerjobs.job.container.
Name der Containerressource.

services Zeichenfolgenwörterbuch.
Containerressourcen, die als Dienstcontainer ausgeführt werden sollen.

workspace-Arbeitsbereich.
Arbeitsbereichsoptionen auf dem Agent. Weitere Informationen zu Arbeitsbereichen, einschließlich Bereinigungsoptionen, finden Sie im Thema Arbeitsbereich unter Aufträge.

usesjobs.job.uses.
Alle ressourcen, die für diesen Auftrag erforderlich sind, auf die noch nicht verwiesen wird. Weitere Informationen zu uses finden Sie unter Auftragsautorisierungsbereich auf referenzierte Azure DevOps-Repositorys einschränken.

steps-Schritte ausführen.
Eine Liste der auszuführenden Schritte.

templateContext templateContext.
Auftragsbezogene Informationen, die von einer Pipeline beim Erweitern einer Vorlage übergeben werden. Weitere Informationen finden Sie im Abschnitt "Hinweise". Weitere Informationen zu templateContextfinden Sie unter Erweiterte YAML-Pipelines-Vorlagen können jetzt kontextbezogene Informationen für Phasen, Aufträge und Bereitstellungen übergeben werden sowie Vorlagen – Verwenden von templateContext zum Übergeben von Eigenschaften an Vorlagen.

Bemerkungen

Der Standardwert timeoutInMinutes ist auf 60 Minuten festgelegt. Weitere Informationen finden Sie unter Timeouts.

Aufträge können bedingt ausgeführt werden und sind möglicherweise von vorherigen Aufträgen abhängig.

Hinweis

Wenn Sie nur über eine Stage und einen Auftrag verfügen, können Sie die Einzelauftragssyntax als kürzere Möglichkeit verwenden, die auszuführenden Schritte zu beschreiben.

Weitere Informationen zu templateContextfinden Sie unter Erweiterte YAML-Pipelines-Vorlagen können jetzt kontextbezogene Informationen für Phasen, Aufträge und Bereitstellungen übergeben werden sowie Vorlagen – Verwenden von templateContext zum Übergeben von Eigenschaften an Vorlagen.

Beispiele

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

Weitere Informationen

Weitere Informationen zu uses finden Sie unter Auftragsautorisierungsbereich auf referenzierte Azure DevOps-Repositorys einschränken.
Weitere Informationen zu Arbeitsbereichen, einschließlich Bereinigungsoptionen, finden Sie im Thema Arbeitsbereich unter Aufträge.
Erfahren Sie mehr über Variablen, Schritte, Pools und Serveraufträge.