İşlem hattınızda işleri belirtme

En basit durumda, bir işlem hattının tek bir işi vardır. Bu durumda, job bir jobkullanmadığınız müddetçe anahtar sözcüğünü açıkça kullanmanız gerekmez. YAML dosyanızdaki adımları doğrudan belirtebilirsiniz.

Bu YAML dosyasında, Microsoft tarafından barındırılan bir aracı ve çıkışları üzerinde çalışan bir iş vardır .

pool:
  vmImage: 'ubuntu-latest'
steps:
- bash: echo "Hello world"

Bu iş üzerinde ek özellikler belirtmek isteyebilirsiniz. Bu durumda, job anahtar sözcüğünü kullanabilirsiniz.

jobs:
- job: myJob
  timeoutInMinutes: 10
  pool:
    vmImage: 'ubuntu-latest'
  steps:
  - bash: echo "Hello world"

İşlem hattınızda birden çok iş olabilir. Bu durumda, jobs anahtar sözcüğünü kullanın.

jobs:
- job: A
  steps:
  - bash: echo "A"

- job: B
  steps:
  - bash: echo "B"

İşlem hattınızda birden çok iş olan birden çok aşama olabilir. Bu durumda, stages anahtar sözcüğünü kullanın.

stages:
- stage: A
  jobs:
  - job: A1
  - job: A2

- stage: B
  jobs:
  - job: B1
  - job: B2

Bir işi belirtmek için tam sözdizimi şöyledir:

- job: string  # name of the job, A-Z, a-z, 0-9, and underscore
  displayName: string  # friendly name to display in the UI
  dependsOn: string | [ string ]
  condition: string
  strategy:
    parallel: # parallel strategy
    matrix: # matrix strategy
    maxParallel: number # maximum number simultaneous matrix legs to run
    # note: `parallel` and `matrix` are mutually exclusive
    # you may specify one or the other; including both is an error
    # `maxParallel` is only valid with `matrix`
  continueOnError: boolean  # 'true' if future jobs should run even if this job fails; defaults to 'false'
  pool: pool # agent pool
  workspace:
    clean: outputs | resources | all # what to clean up before the job runs
  container: containerReference # container to run this job inside
  timeoutInMinutes: number # how long to run the job before automatically cancelling
  cancelTimeoutInMinutes: number # how much time to give 'run always even if cancelled tasks' before killing them
  variables: { string: string } | [ variable | variableReference ] 
  steps: [ script | bash | pwsh | powershell | checkout | task | templateReference ]
  services: { string: string | container } # container resources to run as a service container

Bir işi belirtmek için tam sözdizimi şöyledir:

- job: string  # name of the job, A-Z, a-z, 0-9, and underscore
  displayName: string  # friendly name to display in the UI
  dependsOn: string | [ string ]
  condition: string
  strategy:
    parallel: # parallel strategy
    matrix: # matrix strategy
    maxParallel: number # maximum number simultaneous matrix legs to run
    # note: `parallel` and `matrix` are mutually exclusive
    # you may specify one or the other; including both is an error
    # `maxParallel` is only valid with `matrix`
  continueOnError: boolean  # 'true' if future jobs should run even if this job fails; defaults to 'false'
  pool: pool # agent pool
  workspace:
    clean: outputs | resources | all # what to clean up before the job runs
  container: containerReference # container to run this job inside
  timeoutInMinutes: number # how long to run the job before automatically cancelling
  cancelTimeoutInMinutes: number # how much time to give 'run always even if cancelled tasks' before killing them
  variables: { string: string } | [ variable | variableReference ] 
  steps: [ script | bash | pwsh | powershell | checkout | task | templateReference ]
  services: { string: string | container } # container resources to run as a service container
  uses: # Any resources (repos or pools) required by this job that are not already referenced
    repositories: [ string ] # Repository references to Azure Git repositories
    pools: [ string ] # Pool names, typically when using a matrix strategy for the job

İşinizin birincil amacı uygulamanızı dağıtmaktır (uygulamanızı derleme veya test etme aksine), dağıtım işiadlı özel bir iş türü kullanabilirsiniz.

Dağıtım işinin sözdizimi şöyledir:

- deployment: string        # instead of job keyword, use deployment keyword
  pool:
    name: string
    demands: string | [ string ]
  environment: string
  strategy:
    runOnce:
      deploy:
        steps:
        - script: echo Hi!

Dağıtım görevlerine yönelik adımları bir içinde ekleyebilseniz de job , bunun yerine bir jobkullanmanızı öneririz. Dağıtım işinin birkaç avantajı vardır. Örneğin, dağıttığınız öğenin geçmişini görebilmekte olduğu gibi avantajları içeren bir ortama dağıtım yapabilirsiniz.

YAML, TFS 'nin bu sürümünde desteklenmiyor.

pool:
  name: myPrivateAgents    # your job runs on an agent in this pool
  demands: agent.os -equals Windows_NT    # the agent must have this capability to run the job
steps:
- script: echo hello world

Veya birden çok talep:

pool:
  name: myPrivateAgents
  demands:
  - agent.os -equals Darwin
  - anotherCapability -equals somethingElse
steps:
- script: echo hello world

YAML henüz TFS 'de desteklenmiyor.

Sunucu işini belirtmek için tam söz dizimi şu şekildedir:

jobs:
- job: string
  timeoutInMinutes: number
  cancelTimeoutInMinutes: number
  strategy:
    maxParallel: number
    matrix: { string: { string: string } }

  pool: server

Basitleştirilmiş söz dizimlerini de kullanabilirsiniz:

jobs:
- job: string
  pool: server

YAML henüz TFS'de desteklenmiyor.

Düzenleyicide '...' öğesini seçerek bir sunucu işi eklersiniz bir işlem hattının Görevler sekmesindeki İşlem hattı kanalında. Sunucu işinin özellikleri, işi düzenleyicide seçerek görüntülenir.

Sunucu işleri TFS'nin bu sürümünde desteklenmiyor.

Birden çok işi ve bunların bağımlılıklarını tanımlama söz dizimi şu şekildedir:

jobs:
- job: string
  dependsOn: string
  condition: string

Sırayla derleme yapılan örnek işler:

jobs:
- job: Debug
  steps:
  - script: echo hello from the Debug build
- job: Release
  dependsOn: Debug
  steps:
  - script: echo hello from the Release build

Paralel olarak derleme yapılan örnek işler (bağımlılık yok):

jobs:
- job: Windows
  pool:
    vmImage: 'windows-latest'
  steps:
  - script: echo hello from Windows
- job: macOS
  pool:
    vmImage: 'macOS-latest'
  steps:
  - script: echo hello from macOS
- job: Linux
  pool:
    vmImage: 'ubuntu-latest'
  steps:
  - script: echo hello from Linux

Fan-out örneği:

jobs:
- job: InitialJob
  steps:
  - script: echo hello from initial job
- job: SubsequentA
  dependsOn: InitialJob
  steps:
  - script: echo hello from subsequent A
- job: SubsequentB
  dependsOn: InitialJob
  steps:
  - script: echo hello from subsequent B

Vantilatör örneği:

jobs:
- job: InitialA
  steps:
  - script: echo hello from initial A
- job: InitialB
  steps:
  - script: echo hello from initial B
- job: Subsequent
  dependsOn:
  - InitialA
  - InitialB
  steps:
  - script: echo hello from subsequent

YAML derlemeleri henüz TFS'de kullanılamıyor.

Derleme işlem hattında birden çok iş belirttiğinizde, bunlar varsayılan olarak paralel olarak çalışıyor. İşler arasındaki bağımlılıkları yapılandırarak işlerin yürütülme sırası belirtesiniz. Yayın işlem hatlarında iş bağımlılıkları desteklenmiyor. Bir yayın işlem hattında birden çok iş sırayla çalışıyor.

Bir derlemeye veya yayın işlem hattına sırasıyla ekleyilen birden çok iş. TFS'nin bu sürümünde işler arasındaki bağımlılıkların sırası yapılandıramaz.

Bir yayın işlem hattına sırasıyla birden çok iş eklersiniz. TFS'nin bu sürümünde işler arasındaki bağımlılıkların sırası yapılandıramaz. Derleme işlem hatlarıyla işleri de kullanılamaz.

Önceki işi çalıştırma durumuna göre bir işi çalıştırma örneği:

jobs:
- job: A
  steps:
  - script: exit 1

- job: B
  dependsOn: A
  condition: failed()
  steps:
  - script: echo this will run when A fails

- job: C
  dependsOn:
  - A
  - B
  condition: succeeded('B')
  steps:
  - script: echo this will run when B runs and succeeds

Özel koşul kullanma örneği:

jobs:
- job: A
  steps:
  - script: echo hello

- job: B
  dependsOn: A
  condition: and(succeeded(), eq(variables['build.sourceBranch'], 'refs/heads/master'))
  steps:
  - script: echo this only runs for master

Bir işin, önceki bir işte ayarlanmış bir çıkış değişkeninin değerine göre çalıştırılanı belirtesiniz. Bu durumda, yalnızca doğrudan bağımlı işlerde ayarlanmış değişkenleri kullanabilirsiniz:

jobs:
- job: A
  steps:
  - script: "echo ##vso[task.setvariable variable=skipsubsequent;isOutput=true]false"
    name: printvar

- job: B
  condition: and(succeeded(), ne(dependencies.A.outputs['printvar.skipsubsequent'], 'true'))
  dependsOn: A
  steps:
  - script: echo hello from B

YAML derlemeleri henüz TFS'de kullanılamıyor.

Görevleri yalnızca belirli koşullar karşılanmış olduğunda çalıştırmak için Bu işi bir aracı veya sunucu işi üzerinde çalıştır seçeneğini kullanın. Önceden tanımlanmış bir koşul seçin veya "özel"i seçin ve trueveya false olarak değerlendirilen bir ifade girin. İç içe geçmiş ifadeler kullanılabilir ve ifadeler yayın işlem hattında bulunan değişkenlere erişebilirsiniz.

TFS'nin bu sürümünde koşullar desteklenmiyor.

, timeoutInMinutes iş yürütme süresi için bir sınır ayarlamaya olanak sağlar. Belirtilmedikse varsayılan değer 60 dakikadır. 0Belirtildiğinde, maksimum sınır kullanılır (yukarıda açıklanmıştır).

, önceki bir görev başarısız olursa dağıtım görevi çalışıyor olarak ayarlanmışsa, iş iptal süresi için cancelTimeoutInMinutes bir sınır ayarlamaya olanak sağlar. Belirtilmedikse varsayılan değer 5 dakikadır. Değerin 1 ile 35790 dakika arasında olması gerekir.

jobs:
- job: Test
  timeoutInMinutes: 10 # how long to run the job before automatically cancelling
  cancelTimeoutInMinutes: 2 # how much time to give 'run always even if cancelled tasks' before stopping them

YAML henüz TFS'de desteklenmiyor.

Strateji, matrix bir işin farklı değişken kümeleriyle birden çok kez gönderilene olanak sağlar. etiketi maxParallel paralellik miktarını kısıtlar. Konum ve Tarayıcı değerleri belirtilen şekilde ayarlanmış şekilde aşağıdaki iş üç kez gönderiliyor. Ancak, aynı anda yalnızca iki iş çalıştıracak.

jobs:
- job: Test
  strategy:
    maxParallel: 2
    matrix: 
      US_IE:
        Location: US
        Browser: IE
      US_Chrome:
        Location: US
        Browser: Chrome
      Europe_Chrome:
        Location: Europe
        Browser: Chrome

Matris oluşturmak için çıkış değişkenlerini kullanmak da mümkündür. Matrisi betik kullanarak oluşturmanız gerekirse bu kullanışlı olabilir.

matrix , dizeli bir JSON nesnesi içeren bir çalışma zamanı ifadesini kabul eder. Bu JSON nesnesi genişletilirken matris söz diziminin eşleşmesi gerekir. Aşağıdaki örnekte JSON dizesini sabit kodla kodla çalıştık ancak bu dize bir betik dili veya komut satırı programı tarafından oluşturulabilir.

jobs:
- job: generator
  steps:
  - bash: echo "##vso[task.setVariable variable=legs;isOutput=true]{'a':{'myvar':'A'}, 'b':{'myvar':'B'}}"
    name: mtrx
  # This expands to the matrix
  #   a:
  #     myvar: A
  #   b:
  #     myvar: B
- job: runner
  dependsOn: generator
  strategy:
    matrix: $[ dependencies.generator.outputs['mtrx.legs'] ]
  steps:
  - script: echo $(myvar) # echos A or B depending on which leg is running

TFS'de YAML desteklenmiyor.

Strateji, parallel bir işin birçok kez çoğaltılmış olmasına olanak sağlar. ve System.JobPositionInPhase değişkenleri her işe System.TotalJobsInPhase eklenir. Daha sonra değişkenler, işleri işler arasında bölmek için betiklerin içinde kullanılabilir. Bkz. Aracı işlerini kullanarak paralel ve birden çok yürütme.

Aşağıdaki iş, değerleriyle beş kez ve uygun System.JobPositionInPhase şekilde System.TotalJobsInPhase ayarlanır.

jobs:
- job: Test
  strategy:
    parallel: 5

YAML henüz TFS'de desteklenmiyor.

İşte, bir işte değişkenleri tanımlama ve bunları görevler içinde kullanma örneği.

variables:
  mySimpleVar: simple var value
  "my.dotted.var": dotted var value
  "my var with spaces": var with spaces value

steps:
- script: echo Input macro = $(mySimpleVar). Env var = %MYSIMPLEVAR%
  condition: eq(variables['agent.os'], 'Windows_NT')
- script: echo Input macro = $(mySimpleVar). Env var = $MYSIMPLEVAR
  condition: in(variables['agent.os'], 'Darwin', 'Linux')
- bash: echo Input macro = $(my.dotted.var). Env var = $MY_DOTTED_VAR
- powershell: Write-Host "Input macro = $(my var with spaces). Env var = $env:MY_VAR_WITH_SPACES"

YAML henüz TFS'de desteklenmiyor.

ve $(Build.ArtifactStagingDirectory) her $(Common.TestResultsDirectory) derlemeden önce her zaman silinir ve yeniden oluşturulur.

Bir işlem hattını kendi içinde barındırılan bir aracıda çalıştırırken, varsayılan olarak ve dışında alt dizinlerin hiçbiri ardışık iki çalıştırma arasında $(Common.TestResultsDirectory) temizlenmez. Sonuç olarak, bunu kullanmak için görevlerin uygulanması şartıyla artımlı derlemeler ve dağıtımlar gerçekleştirebilirsiniz. İşteki ayarını kullanarak bu workspace davranışı geçersiz kılabilirsiniz.

- job: myJob
  workspace:
    clean: outputs | resources | all # what to clean up before the job runs

Seçeneklerden birini clean belirttiğinizde, bunlar aşağıdaki gibi yorumlanır:

• outputs: Yeni Build.BinariesDirectory bir iş çalıştırmadan önce silin.
• resources: Yeni Build.SourcesDirectory bir iş çalıştırmadan önce silin.
• all: Yeni bir iş Pipeline.Workspace çalıştırmadan önce dizinin tamamını silin.

  jobs:
  - deployment: deploy
    pool:
      vmImage: 'ubuntu-latest'
    workspace:
      clean: all
    environment: staging

Çalışma alanı temizlemeye ek olarak işlem hattı ayarları kullanıcı arabiriminde Temizleme ayarını yapılandırarak da temizlemeyi yapılandırabilirsiniz. Temiz ayarı trueolduğunda, işlem hattınızdaki her bir ödeme adımı için belirtmeye eşdeğerdir. Temiz ayarını yapılandırmak için:

1. İşlem hattınızı düzenleyin, ... seçeneğini veardından Tetikleyiciler'i seçin.

   

2. YAML,Kaynakları al'ıseçin ve istediğiniz Temizleme ayarını yapılandırabilirsiniz. Varsayılan değer false'tır.

   

YAML henüz TFS'de desteklenmiyor.

# test and upload my code as an artifact named WebSite
jobs:
- job: Build
  pool:
    vmImage: 'ubuntu-latest'
  steps:
  - script: npm test
  - task: PublishBuildArtifacts@1
    inputs:
      pathtoPublish: '$(System.DefaultWorkingDirectory)'
      artifactName: WebSite

# download the artifact and deploy it only if the build job succeeded
- job: Deploy
  pool:
    vmImage: 'ubuntu-latest'
  steps:
  - checkout: none #skip checking out the default repository resource
  - task: DownloadBuildArtifacts@0
    displayName: 'Download Build Artifacts'
    inputs:
      artifactName: WebSite
      downloadPath: $(System.DefaultWorkingDirectory)

  dependsOn: Build
  condition: succeeded()

YAML henüz TFS'de desteklenmiyor.

Alternatif olarak, bir yayında iş yürütme sırasında belirli yapıtları indirmeyi seçebilirsiniz. Belirli bir işteki görevler yalnızca belirli yapıtlara bağlı ise bu seçeneği kullanın.

OAuth belirteci YAML işlem hatlarında her zaman kullanılabilir. kullanılarak göreve veya adıma açıkça eşlenmiş olması env gerekir. Aşağıda bir örnek verilmiştir:

steps:
- powershell: |
    $url = "$($env:SYSTEM_TEAMFOUNDATIONCOLLECTIONURI)$env:SYSTEM_TEAMPROJECTID/_apis/build/definitions/$($env:SYSTEM_DEFINITIONID)?api-version=4.1-preview"
    Write-Host "URL: $url"
    $pipeline = Invoke-RestMethod -Uri $url -Headers @{
      Authorization = "Bearer $env:SYSTEM_ACCESSTOKEN"
    }
    Write-Host "Pipeline = $($pipeline | ConvertTo-Json -Depth 100)"
  env:
    SYSTEM_ACCESSTOKEN: $(system.accesstoken)

YAML henüz TFS'de desteklenmiyor.