Compartir vía


definición de jobs.deployment

Un trabajo de implementación es un tipo especial de trabajo. Se trata de una colección de pasos para ejecutarse secuencialmente en el entorno.

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.
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
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.
  container: string | container # Container resource name.
  services: # Container resources to run as a service container.
    string: string # Name/value pairs

Definiciones que hacen referencia a esta definición: trabajos

Propiedades

deployment cadena. Obligatorio como primera propiedad.
Nombre del trabajo de implementación, A-Z, a-z, 0-9 y carácter de subrayado. La palabra deploy es una palabra clave y no se admite como nombre de implementación.

displayName cadena.
nombre legible para la implementación.

cadena de dependsOn | lista de cadenas.
Cualquier trabajo que se debe completar antes de este.

condition cadena.
Evaluar esta expresión de condición para determinar si se debe ejecutar esta implementación.

continueOnError cadena.
Continuar ejecutándose incluso en caso de error?

timeoutInMinutes cadena.
Tiempo de espera para que este trabajo se complete antes de que el servidor lo mate.

cancelTimeoutInMinutes cadena.
Tiempo de espera para que el trabajo se cancele antes de terminarlo forzadamente.

variables variables.
variables específicas de implementación.

pool grupo de.
Grupo donde se ejecutará este trabajo.

environment trabajos.despliegue.entorno.
nombre del entorno de destino y, opcionalmente, un nombre de recurso para registrar el historial de implementación; format: environment-name.resource-name.

strategy trabajos.despliegue.estrategia.
estrategia de ejecución para esta implementación.

workspace área de trabajo.
opciones del área de trabajo en el agente.

Para obtener más información sobre las áreas de trabajo, incluidas las opciones limpias, consulte el tema área de trabajo de en Trabajos.

uses empleos.trabajo.usos.
Especifica los recursos requeridos por este trabajo que aún no se hacen referencia a otros lugares de la canalización, por ejemplo, mediante un paso de desprotección o un recurso de repositorio. Para obtener más información sobre uses, vea Limitar el ámbito de autorización de trabajos y la instrucción "uses" para declarar previamente los recursos.

container trabajos.trabajo.contenedor.
nombre del recurso contenedor.

services diccionario de cadenas.
recursos de contenedor para ejecutarse como un contenedor de servicios.

templateContext templateContext.
información relacionada con la implementación que se pasa desde una canalización al extender una plantilla. Consulte los comentarios para obtener más información. Para obtener más información sobre templateContext, vea plantillas de canalizaciones de YAML extendidas ahora se pueden pasar información de contexto para fases, trabajos e implementaciones y plantillas de : usar templateContext para pasar propiedades a plantillas.

Observaciones

En las canalizaciones de YAML, el equipo de canalizaciones recomienda colocar los pasos de implementación en un trabajo de implementación.

Para obtener más información sobre templateContext, vea plantillas de canalizaciones de YAML extendidas ahora se pueden pasar información de contexto para fases, trabajos e implementaciones y plantillas de : usar templateContext para pasar propiedades a plantillas.

Ejemplos

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