jobs.job definition

Makale
04/16/2024

İş, bir aracı veya sunucuda çalıştırılan adımlardan oluşan bir koleksiyondur.

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: string # Which parts of the workspace should be scorched before fetching.
  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: string # Which parts of the workspace should be scorched before fetching.
  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: string # Which parts of the workspace should be scorched before fetching.
  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: string # Scorch the repo before fetching?
  steps: [ task | script | powershell | pwsh | bash | checkout | download | downloadBuild | publish | template ] # 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.
  services: # Container resources to run as a service container.
    string: string # Name/value pairs
  workspace: # Workspace options on the agent.
    clean: string # Scorch the repo before fetching?
  steps: [ task | script | powershell | pwsh | bash | checkout | download | downloadBuild | publish | template ] # A list of steps to run.

Bu tanıma başvuran tanımlar: jobs

Özellikler

job Dize. İlk özellik olarak gereklidir.
İşin kimliği. Kabul edilebilir değerler: Geçerli adlar yalnızca alfasayısal karakterler ve '_' içerebilir ve sayı ile başlamıyor olabilir.

displayName Dize.
İş için okunabilir bir ad.

dependsOn dize | dize listesi.
Bundan önce tamamlanması gereken tüm işler.

condition Dize.
Bu işin çalıştırılıp çalıştırılmayacağını belirlemek için bu koşul ifadesini değerlendirin.

continueOnError Dize.
Hata durumunda bile çalışmaya devam mı edin?

timeoutInMinutes Dize.
Sunucu sonlandırmadan önce bu işin tamamlanmasını bekleme süresi.

cancelTimeoutInMinutes Dize.
zorla sonlandırmadan önce işin iptal edilmesi için bekleme süresi.

variablesdeğişkenlerini seçin.
İşe özgü değişkenler.

strategyjobs.job.strategy.
Bu iş için yürütme stratejisi.

poolhavuzuna bakın.
Bu işin çalıştırılacağı havuz.

containerjobs.job.container.
Kapsayıcı kaynak adı.

services dize sözlüğü.
Hizmet kapsayıcısı olarak çalıştırılacak kapsayıcı kaynakları.

workspaceçalışma alanını seçin.
Aracıdaki çalışma alanı seçenekleri. Temiz seçenekler de dahil olmak üzere çalışma alanları hakkında daha fazla bilgi için İşler'deki çalışma alanı konusuna bakın.

usesjobs.job.uses.
Bu işin gerektirdiği ve henüz başvurulmayan tüm kaynaklar. hakkında usesdaha fazla bilgi için bkz. İş yetkilendirme kapsamını başvuruda bulunan Azure DevOps depoları ile sınırlama.

stepsadımlarını seçin.
Çalıştırılacak adımların listesi.

templateContext templateContext.
Şablon genişletilirken işlem hattından geçirilen işle ilgili bilgiler. Daha fazla bilgi için açıklamalara bakın. hakkında templateContextdaha fazla bilgi için bkz. Genişletilmiş YAML İşlem Hatları şablonları artık aşamalar, işler ve dağıtımlar için bağlam bilgileri geçirilebilir ve Şablonlar - Şablonlara özellik geçirmek için templateContext kullanma.

Açıklamalar

Varsayılan timeoutInMinutes değer 60 dakika olarak ayarlanır. Daha fazla bilgi için bkz . Zaman Aşımları.

İşler koşullu olarak çalışabilir ve önceki işlere bağlı olabilir.

Not

Tek bir aşamanız ve tek işiniz varsa, tek iş söz dizimini çalıştırma adımlarını açıklamak için daha kısa bir yol olarak kullanabilirsiniz.

hakkında templateContextdaha fazla bilgi için bkz. Genişletilmiş YAML İşlem Hatları şablonları artık aşamalar, işler ve dağıtımlar için bağlam bilgileri geçirilebilir ve Şablonlar - Şablonlara özellik geçirmek için templateContext kullanma.

Örnekler

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

Ayrıca bkz.

hakkında usesdaha fazla bilgi için bkz. İş yetkilendirme kapsamını başvuruda bulunan Azure DevOps depoları ile sınırlama.
Temiz seçenekler de dahil olmak üzere çalışma alanları hakkında daha fazla bilgi için İşler'deki çalışma alanı konusuna bakın.
Değişkenler, adımlar, havuzlar ve sunucu işleri hakkında daha fazla bilgi edinin.