Partager via


définition de jobs.job

Un de travail est une collection d’étapes exécutées par un agent ou sur un serveur .

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.

Définitions qui font référence à cette définition : travaux

Propriétés

chaîne job. Obligatoire en tant que première propriété.
ID du travail. Valeurs acceptables : les noms valides peuvent contenir uniquement des caractères alphanumériques et « _ » et ne peuvent pas commencer par un nombre.

chaîne displayName.
nom lisible par l’homme pour le travail.

chaîne dependsOn | liste de chaînes.
tous les travaux qui doivent être terminés avant celui-ci.

chaîne condition.
Évaluer cette expression de condition pour déterminer s’il faut exécuter ce travail.

chaîne continueOnError.
Continuer à s’exécuter même en cas d’échec ?

chaîne timeoutInMinutes.
délai d’attente de la fin de ce travail avant que le serveur ne le tue.

chaîne cancelTimeoutInMinutes.
délai d’attente de l’annulation du travail avant de le mettre fin de force.

variables variables.
variables spécifiques au travail.

strategy jobs.job.strategy.
stratégie d’exécution pour ce travail.

pool pool.
Pool dans lequel ce travail s’exécutera.

container jobs.job.container .
nom de ressource conteneur.

services dictionnaire de chaînes.
ressources conteneur à exécuter en tant que conteneur de service.

workspace espace de travail.
options d’espace de travail sur l’agent. Pour plus d’informations sur les espaces de travail, notamment les options propres, consultez la rubrique 'espace de travail dans travaux.

uses jobs.job.use.
Spécifie les ressources requises par ce travail qui ne sont pas déjà référencées ailleurs dans le pipeline, par exemple par une étape d’extraction ou une ressource de référentiel. Pour plus d’informations sur uses, consultez Limiter l’étendue d’autorisation du travail et l’instruction « use » pour prédéclarer des ressources.

steps étapes.
Liste des étapes à exécuter.

templateContext templateContext.
informations relatives au travail transmises à partir d’un pipeline lors de l’extension d’un modèle. Pour plus d’informations, consultez les remarques. Pour plus d’informations sur templateContext, consultez modèles de pipelines YAML étendus peuvent désormais être transmis des informations contextuelles pour les étapes, les travaux et les déploiements et Modèles - Utiliser templateContext pour transmettre des propriétés aux modèles.

Remarques

La timeoutInMinutes par défaut est définie sur 60 minutes. Pour plus d’informations, consultez délais d’expiration.

Les travaux peuvent exécuter conditionnellement et peuvent dépendre des travaux antérieurs.

Remarque

Si vous n’avez qu’une seule étape et un seul travail, vous pouvez utiliser syntaxe à travail unique comme moyen plus court de décrire les étapes à exécuter.

Pour plus d’informations sur templateContext, consultez modèles de pipelines YAML étendus peuvent désormais être transmis des informations contextuelles pour les étapes, les travaux et les déploiements et Modèles - Utiliser templateContext pour transmettre des propriétés aux modèles.

Exemples

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

Voir aussi