Compartilhar via


definição de jobs.job

Um trabalho é uma coleção de etapas executadas por um agente ou em um servidor .

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.

Definições que fazem referência a essa definição: trabalhos

Propriedades

job cadeia de caracteres. Obrigatório como primeira propriedade.
ID do trabalho. Valores aceitáveis: os nomes válidos só podem conter caracteres alfanuméricos e '_' e podem não começar com um número.

displayName cadeia de caracteres.
nome legível para o trabalho.

dependsOn cadeia de caracteres | lista de cadeias de caracteres.
Todos os trabalhos que devem ser concluídos antes deste.

condition cadeia de caracteres.
Avaliar essa expressão de condição para determinar se este trabalho deve ser executado.

continueOnError cadeia de caracteres.
Continuar em execução mesmo em caso de falha?

timeoutInMinutes cadeia de caracteres.
hora de aguardar a conclusão desse trabalho antes que o servidor o mate.

cancelTimeoutInMinutes cadeia de caracteres.
hora de aguardar o cancelamento do trabalho antes de encerrá-lo à força.

variáveis variables.
variáveis específicas do trabalho.

strategy jobs.job.strategy .
estratégia de execução para este trabalho.

pool pool.
Pool em que esse trabalho será executado.

jobs.job.container container.
nome do recurso contêiner.

services dicionário de cadeias de caracteres.
recursos de contêiner a serem executados como um contêiner de serviço.

workspace workspace.
opções de workspace no agente. Para obter mais informações sobre workspaces, incluindo opções limpas, consulte o tópico do workspace no trabalhos do.

uses jobs.job.uses.
Especifica os recursos exigidos por esse trabalho que ainda não são referenciados em outro lugar no pipeline, por exemplo, por uma etapa de check-out ou um recurso de repositório. Para obter mais informações sobre uses, consulte Limitar escopo de autorização de trabalho e instrução "uses" para pré-declarar recursos.

steps etapas.
Uma lista de etapas a serem executadas.

templateContext templateContext.
informações relacionadas ao trabalho passadas de um pipeline ao estender um modelo. Consulte comentários para obter mais informações. Para obter mais informações sobre templateContext, consulte Modelos de Pipelines YAML Estendidos agora podem ser passados informações de contexto para estágios, trabalhos e implantações e modelos de – use templateContext para passar propriedades para modelos.

Observações

O timeoutInMinutes padrão é definido como 60 minutos. Para obter mais informações, consulte Timeouts.

Os trabalhos podem ser executados condicionalmente e podem depender de trabalhos anteriores.

Observação

Se você tiver apenas um estágio e um trabalho, poderá usar sintaxe de trabalho único como uma maneira mais curta de descrever as etapas a serem executadas.

Para obter mais informações sobre templateContext, consulte Modelos de Pipelines YAML Estendidos agora podem ser passados informações de contexto para estágios, trabalhos e implantações e modelos de – use templateContext para passar propriedades para modelos.

Exemplos

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

Consulte também