jobs.job definition
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. Valid names may only contain alphanumeric characters and '_' and may not start with a number.
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 # Job-specific variables
strategy: jobStrategy # Execution strategy for this job
pool: 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?. (outputs, resources, all)
steps: [ task | script | powershell | pwsh | bash | checkout | download | downloadBuild | publish | template | restoreCache | saveCache ]
Eigenschaften, die diese Definition verwenden: Aufträge
Eigenschaften
job
Zeichenfolge
Erforderlich als erster Parameter. ID des Auftrags. Zulässige Werte: Gültige Namen dürfen nur alphanumerische Zeichen und "_" enthalten und beginnen möglicherweise nicht mit einer Zahl.displayName
Zeichenfolge
Der menschlich lesbare Name für den Auftrag.dependsOn
Zeichenfolgen- oder Zeichenfolgenliste
Alle Aufträge, die vor diesem Vorgang abgeschlossen werden müssen.condition
Zeichenfolge
Bewerten Sie diesen Bedingungsausdruck, um zu bestimmen, ob dieser Auftrag ausgeführt werden soll.continueOnError
boolean
Fahren Sie auch bei Fehlern fort?timeoutInMinutes
Zeichenfolge
Zeit, bis dieser Auftrag abgeschlossen ist, bevor der Server es beendet.cancelTimeoutInMinutes
Zeichenfolge
Zeit, bis der Auftrag abgebrochen werden soll, bevor der Auftrag beendet wird.variables
Auftragsspezifische Variablen.
strategy
Ausführungsstrategie für diesen Auftrag.
pool
Pool, in dem dieser Auftrag ausgeführt wird.
services
Zeichenfolgenname/Wertpaare
Containerressourcen, die als Dienstcontainer ausgeführt werden sollen.workspace
Arbeitsbereichsoptionen
Arbeitsbereichsoptionen für den Agent.steps
Eine Liste der auszuführenden Schritte.
jobs:
- job: string # Required as first property. ID of the job. Valid names may only contain alphanumeric characters and '_' and may not start with a number.
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 # Job-specific variables
strategy: jobStrategy # Execution strategy for this job
pool: pool # Pool where this job will run
container: jobContainer # 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?. (outputs, resources, all)
steps: [ task | script | powershell | pwsh | bash | checkout | download | downloadBuild | publish | template | restoreCache | saveCache ]
Eigenschaften, die diese Definition verwenden: Aufträge
Eigenschaften
job
Zeichenfolge
Erforderlich als erster Parameter. ID des Auftrags. Zulässige Werte: Gültige Namen dürfen nur alphanumerische Zeichen und "_" enthalten und beginnen möglicherweise nicht mit einer Zahl.displayName
Zeichenfolge
Der menschlich lesbare Name für den Auftrag.dependsOn
Zeichenfolgen- oder Zeichenfolgenliste
Alle Aufträge, die vor diesem Vorgang abgeschlossen werden müssen.condition
Zeichenfolge
Bewerten Sie diesen Bedingungsausdruck, um zu bestimmen, ob dieser Auftrag ausgeführt werden soll.continueOnError
boolean
Fahren Sie auch bei Fehlern fort?timeoutInMinutes
Zeichenfolge
Zeit, bis dieser Auftrag abgeschlossen ist, bevor der Server es beendet.cancelTimeoutInMinutes
Zeichenfolge
Zeit, bis der Auftrag abgebrochen werden soll, bevor der Auftrag beendet wird.variables
Auftragsspezifische Variablen.
strategy
Ausführungsstrategie für diesen Auftrag.
pool
Pool, in dem dieser Auftrag ausgeführt wird.
container
Containerressourcenname.
services
Zeichenfolgenname/Wertpaare
Containerressourcen, die als Dienstcontainer ausgeführt werden sollen.workspace
Arbeitsbereichsoptionen
Arbeitsbereichsoptionen für den Agent.steps
Eine Liste der auszuführenden Schritte.
jobs:
- job: string # Required as first property. ID of the job. Valid names may only contain alphanumeric characters and '_' and may not start with a number.
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 # Job-specific variables
strategy: jobStrategy # Execution strategy for this job
pool: pool # Pool where this job will run
container: jobContainer # 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. (outputs, resources, all)
steps: [ task | script | powershell | pwsh | bash | checkout | download | downloadBuild | getPackage | publish | template | restoreCache | saveCache | reviewApp ]
Eigenschaften, die diese Definition verwenden: Aufträge
Eigenschaften
job
Zeichenfolge
Erforderlich als erster Parameter. ID des Auftrags. Zulässige Werte: Gültige Namen dürfen nur alphanumerische Zeichen und "_" enthalten und beginnen möglicherweise nicht mit einer Zahl.displayName
Zeichenfolge
Der menschlich lesbare Name für den Auftrag.dependsOn
Zeichenfolgen- oder Zeichenfolgenliste
Alle Aufträge, die vor diesem Vorgang abgeschlossen werden müssen.condition
Zeichenfolge
Bewerten Sie diesen Bedingungsausdruck, um zu bestimmen, ob dieser Auftrag ausgeführt werden soll.continueOnError
boolean
Fahren Sie auch bei Fehlern fort?timeoutInMinutes
Zeichenfolge
Zeit, bis dieser Auftrag abgeschlossen ist, bevor der Server es beendet.cancelTimeoutInMinutes
Zeichenfolge
Zeit, bis der Auftrag abgebrochen werden soll, bevor der Auftrag beendet wird.variables
Auftragsspezifische Variablen.
strategy
Ausführungsstrategie für diesen Auftrag.
pool
Pool, in dem dieser Auftrag ausgeführt wird.
container
Containerressourcenname.
services
Zeichenfolgenname/Wertpaare
Containerressourcen, die als Dienstcontainer ausgeführt werden sollen.workspace
Arbeitsbereichsoptionen
Arbeitsbereichsoptionen für den Agent.steps
Eine Liste der auszuführenden Schritte.
jobs:
- job: string # Required as first property. ID of the job. Valid names may only contain alphanumeric characters and '_' and may not start with a number.
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 # Job-specific variables
strategy: jobStrategy # Execution strategy for this job
pool: pool # Pool where this job will run
container: jobContainer # 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. (outputs, resources, all)
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 | restoreCache | saveCache | reviewApp ]
Eigenschaften, die diese Definition verwenden: Aufträge
Eigenschaften
job
Zeichenfolge
Erforderlich als erster Parameter. ID des Auftrags. Zulässige Werte: Gültige Namen dürfen nur alphanumerische Zeichen und "_" enthalten und beginnen möglicherweise nicht mit einer Zahl.displayName
Zeichenfolge
Menschlesbarer Name für den Auftrag.dependsOn
Zeichenfolgen- oder Zeichenfolgenliste
Alle Aufträge, die vor diesem Vorgang abgeschlossen werden müssen.condition
Zeichenfolge
Bewerten Sie diesen Bedingungsausdruck, um zu bestimmen, ob dieser Auftrag ausgeführt werden soll.continueOnError
boolean
Führen Sie die Ausführung auch bei Fehlern fort?timeoutInMinutes
Zeichenfolge
Zeit, bis dieser Auftrag abgeschlossen wird, bevor der Server es beendet.cancelTimeoutInMinutes
Zeichenfolge
Zeit, bis der Auftrag abgesagt werden soll, bevor sie beendet wird.variables
Auftragsspezifische Variablen.
strategy
Ausführungsstrategie für diesen Auftrag.
pool
Pool, an dem dieser Auftrag ausgeführt wird.
container
Containerressourcenname.
services
Zeichenfolgenname/Wertpaare
Containerressourcen, die als Dienstcontainer ausgeführt werden sollen.workspace
Arbeitsbereichsoptionen
Arbeitsbereichsoptionen im Agent.uses
Pools und Repositorys
Alle Ressourcen, die von diesem Auftrag benötigt werden, auf die noch nicht verwiesen wird.steps
Eine Liste der schritte, die ausgeführt werden sollen.
jobs:
- job: string # Required as first property. ID of the job. Valid names may only contain alphanumeric characters and '_' and may not start with a number.
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 # Job-specific variables
strategy: jobStrategy # Execution strategy for this job
pool: pool # Pool where this job will run
container: jobContainer # 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. (outputs, resources, all)
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 | restoreCache | saveCache | reviewApp ]
templateContext: # Job related information passed from a pipeline when extending a template. See remarks for more information.
Eigenschaften, die diese Definition verwenden: Aufträge
Eigenschaften
job
Zeichenfolge
Erforderlich als erster Parameter. ID des Auftrags. Zulässige Werte: Gültige Namen dürfen nur alphanumerische Zeichen und "_" enthalten und beginnen möglicherweise nicht mit einer Zahl.displayName
Zeichenfolge
Menschlesbarer Name für den Auftrag.dependsOn
Zeichenfolgen- oder Zeichenfolgenliste
Alle Aufträge, die vor diesem Vorgang abgeschlossen werden müssen.condition
Zeichenfolge
Bewerten Sie diesen Bedingungsausdruck, um zu bestimmen, ob dieser Auftrag ausgeführt werden soll.continueOnError
boolean
Führen Sie die Ausführung auch bei Fehlern fort?timeoutInMinutes
Zeichenfolge
Zeit, bis dieser Auftrag abgeschlossen wird, bevor der Server es beendet.cancelTimeoutInMinutes
Zeichenfolge
Zeit, bis der Auftrag abgesagt werden soll, bevor sie beendet wird.variables
Auftragsspezifische Variablen.
strategy
Ausführungsstrategie für diesen Auftrag.
pool
Pool, an dem dieser Auftrag ausgeführt wird.
container
Containerressourcenname.
services
Zeichenfolgenname/Wertpaare
Containerressourcen, die als Dienstcontainer ausgeführt werden sollen.workspace
Arbeitsbereichsoptionen
Arbeitsbereichsoptionen im Agent.uses
Pools und Repositorys
Alle Ressourcen, die von diesem Auftrag benötigt werden, auf die noch nicht verwiesen wird.steps
Eine Liste der schritte, die ausgeführt werden sollen.
templateContext
templateContext
Auftragsbezogene Informationen, die von einer Pipeline übergeben wurden, wenn sie eine Vorlage erweitern. Weitere Informationen finden Sie im Abschnitt "Hinweise".jobs:
- job: string # Required as first property. ID of the job. Valid names may only contain alphanumeric characters and '_' and may not start with a number.
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 # Job-specific variables
strategy: jobStrategy # Execution strategy for this job
pool: pool # Pool where this job will run
container: jobContainer # 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. (outputs, resources, all)
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 | restoreCache | saveCache | reviewApp ]
templateContext: # Job related information passed from a pipeline when extending a template. See remarks for more information.
Eigenschaften, die diese Definition verwenden: Aufträge
Eigenschaften
job
Zeichenfolge
Erforderlich als erster Parameter. ID des Auftrags. Zulässige Werte: Gültige Namen dürfen nur alphanumerische Zeichen und "_" enthalten und beginnen möglicherweise nicht mit einer Zahl.displayName
Zeichenfolge
Menschlesbarer Name für den Auftrag.dependsOn
Zeichenfolgen- oder Zeichenfolgenliste
Alle Aufträge, die vor diesem Vorgang abgeschlossen werden müssen.condition
Zeichenfolge
Bewerten Sie diesen Bedingungsausdruck, um zu bestimmen, ob dieser Auftrag ausgeführt werden soll.continueOnError
boolean
Führen Sie die Ausführung auch bei Fehlern fort?timeoutInMinutes
Zeichenfolge
Zeit, bis dieser Auftrag abgeschlossen wird, bevor der Server es beendet.cancelTimeoutInMinutes
Zeichenfolge
Zeit, bis der Auftrag abgesagt werden soll, bevor sie beendet wird.variables
Auftragsspezifische Variablen.
strategy
Ausführungsstrategie für diesen Auftrag.
pool
Pool, an dem dieser Auftrag ausgeführt wird.
container
Containerressourcenname.
services
Zeichenfolgenname/Wertpaare
Containerressourcen, die als Dienstcontainer ausgeführt werden sollen.workspace
Arbeitsbereichsoptionen
Arbeitsbereichsoptionen im Agent.uses
Pools und Repositorys
Alle Ressourcen, die von diesem Auftrag benötigt werden, auf die noch nicht verwiesen wird.steps
Eine Liste der auszuführenden Schritte.
templateContext
templateContext
Auftragsbezogene Informationen, die von einer Pipeline übergeben werden, wenn eine Vorlage erweitert wird. Weitere Informationen finden Sie im Abschnitt "Hinweise".Bemerkungen
Der Standardwert timeoutInMinutes ist auf 60 Minuten festgelegt. Weitere Informationen finden Sie unter Timeouts.
Aufträge können bedingt ausgeführt werden und hängen möglicherweise von früheren Aufträgen ab.
Hinweis
Wenn Sie nur eine Phase und einen Auftrag haben, können Sie die Einzelauftragssyntax als kürzere Methode verwenden, um die auszuführenden Schritte zu beschreiben.
Weitere Informationen finden templateContextSie unter Erweiterter YAML-Pipelines-Vorlagen können jetzt Kontextinformationen für Phasen, Aufträge und Bereitstellungen und Vorlagen übergeben werden– Verwenden Sie templateContext, um Eigenschaften an Vorlagen zu übergeben.
Beispiele
jobs:
- job: MyJob
displayName: My First Job
continueOnError: true
workspace:
clean: outputs
steps:
- script: echo My first job
Weitere Informationen
- Weitere Informationen
usesfinden Sie unter Limit job authorization scope to referenced Azure DevOps repositorys. Weitere Informationen zu Arbeitsbereichen, einschließlich bereinigungsoptionen, finden Sie im Arbeitsbereichsthema in Aufträgen. - Erfahren Sie mehr über Variablen, Schritte, Pools und Serveraufträge.