définition jobs.deployment

Un travail de déploiement est un type spécial de travail. Il s’agit d’une collection d’étapes à exécuter séquentiellement sur l’environnement.

jobs:
- deployment: string # Required as first property. Name of the deployment job, A-Z, a-z, 0-9, and underscore. The word deploy is a keyword and is unsupported as the deployment name.
  displayName: string # Human-readable name for the deployment.
  dependsOn: string | [ string ] # Any jobs which must complete before this one.
  condition: string # Evaluate this condition expression to determine whether to run this deployment.
  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 ] # Deployment-specific variables.
  pool: string | pool # Pool where this job will run.
  environment: string | environment # Target environment name and optionally a resource name to record the deployment history; format: environment-name.resource-name.
  strategy: strategy # Execution strategy for this deployment.
  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.
  container: string | container # Container resource name.
  services: # Container resources to run as a service container.
    string: string # Name/value pairs
  templateContext: # Deployment related information passed from a pipeline when extending a template.

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

Propriétés

chaîne deployment. Obligatoire en tant que première propriété.
Nom du travail de déploiement, A-Z, a-z, 0-9 et trait de soulignement. Le mot déployer est un mot clé et n’est pas pris en charge comme nom de déploiement.

chaîne displayName.
nom lisible par l’homme pour le déploiement.

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 déploiement.

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 déploiement.

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

environment jobs.deployment.environment.
nom de l’environnement cible et éventuellement un nom de ressource pour enregistrer l’historique du déploiement ; format : environment-name.resource-name.

strategy jobs.deployment.strategy.
stratégie d’exécution pour ce déploiement.

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.

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

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

templateContext templateContext.
les informations associées au déploiement 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

Dans les pipelines YAML, l’équipe de pipelines vous recommande de mettre vos étapes de déploiement dans un travail de déploiement.

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:
  # track deployments on the environment
- deployment: DeployWeb
  displayName: deploy Web App
  pool:
    vmImage: ubuntu-latest
  # creates an environment if it doesn't exist
  environment: 'smarthotel-dev'
  strategy:
    # default deployment strategy, more coming...
    runOnce:
      deploy:
        steps:
        - script: echo my first deployment