Freigeben über


jobs.job definition

Ein Auftrag ist eine Sammlung von Schritten, die von einem Agent oder auf einem Serverausgefü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: outputs | resources | all # What to clean up before the job runs.
  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: outputs | resources | all # What to clean up before the job runs.
  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: outputs | resources | all # What to clean up before the job runs.
  steps: [ task | script | powershell | pwsh | bash | checkout | download | downloadBuild | getPackage | publish | template | reviewApp ] # A list of steps to run.

Definitionen, die auf diese Definition verweisen: Aufträge

Eigenschaften

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

displayName Zeichenfolge.
lesbaren Namen für den Auftrag.

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

condition Zeichenfolge.
Diesen Bedingungsausdruck auswerten, um zu bestimmen, ob dieser Auftrag ausgeführt werden soll.

continueOnError Zeichenfolge.
Auch bei Fehlern weiter ausgeführt werden?

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

cancelTimeoutInMinutes Zeichenfolge.
Zeit, bis der Auftrag abgebrochen wird, bevor der Auftrag beendet wird.

variables Variablen.
Auftragsspezifische Variablen.

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

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

container jobs.job.container.
Containerressourcenname.

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

workspace Arbeitsbereich.
Arbeitsbereichsoptionen für den Agent. Weitere Informationen zu Arbeitsbereichen, einschließlich sauberer Optionen, finden Sie im Arbeitsbereich Thema in Jobs.

uses jobs.job.uses.
Gibt Ressourcen an, die für diesen Auftrag erforderlich sind, auf die noch nicht an anderer Stelle in der Pipeline verwiesen wird, z. B. durch einen Auscheckschritt oder eine Repositoryressource. Weitere Informationen usesfinden Sie unter Limit job authorization scope and "uses" statement for pre-declaring resources.

steps Schritte.
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 in den Hinweisen. Weitere Informationen zu templateContextfinden Sie unter Vorlagen für erweiterte YAML-Pipelines können nun Kontextinformationen für Phasen, Aufträge und Bereitstellungen und Vorlagen übergeben werden . Verwenden Sie templateContext, um Eigenschaften an Vorlagenzu übergeben.

Bemerkungen

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

Aufträge können bedingt ausgeführt werden, und möglicherweise sind von früheren Aufträgenabhängig.

Hinweis

Wenn Sie nur eine Phase und einen Auftrag haben, können Sie Einzelauftragssyntax als kürzere Methode verwenden, um die auszuführenden Schritte zu beschreiben.

Weitere Informationen zu templateContextfinden Sie unter Vorlagen für erweiterte YAML-Pipelines können nun Kontextinformationen für Phasen, Aufträge und Bereitstellungen und Vorlagen übergeben werden . Verwenden Sie templateContext, um Eigenschaften an Vorlagenzu übergeben.

Beispiele

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

Siehe auch