Tentukan pekerjaan di alur Anda

| Layanan Azure DevOps Azure DevOps Server 2022 - Azure DevOps Server 2019 | TFS 2018

Catatan

Dalam Microsoft Team Foundation Server (TFS) 2018 dan versi sebelumnya, alur build dan rilis disebut definisi, eksekusi disebut build, koneksi layanan disebut titik akhir layanan, tahapan disebut lingkungan, dan pekerjaan disebut fase.

Anda dapat mengatur alur Anda ke dalam pekerjaan. Setiap alur memiliki setidaknya satu pekerjaan. Pekerjaan adalah serangkaian langkah yang berjalan secara berurutan sebagai unit. Dengan kata lain, pekerjaan adalah unit kerja terkecil yang dapat dijadwalkan untuk dijalankan.

Anda dapat mengatur alur build atau rilis Anda ke dalam pekerjaan. Setiap alur memiliki setidaknya satu pekerjaan. Pekerjaan adalah serangkaian langkah yang berjalan secara berurutan sebagai unit. Dengan kata lain, pekerjaan adalah unit kerja terkecil yang dapat dijadwalkan untuk dijalankan.

Catatan

Anda harus menginstal TFS 2018.2 untuk menggunakan pekerjaan dalam proses build. Di TFS 2018 RTM, Anda dapat menggunakan pekerjaan dalam proses penyebaran rilis.

Menentukan satu pekerjaan

YAML

Dalam kasus yang paling sederhana, alur memiliki satu pekerjaan. Dalam hal ini, Anda tidak perlu secara eksplisit menggunakan job kata kunci kecuali Anda menggunakan templat. Anda dapat langsung menentukan langkah-langkah dalam file YAML Anda.

File YAML ini memiliki pekerjaan yang berjalan pada agen dan output Hello worldyang dihosting Microsoft .

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

Anda mungkin ingin menentukan properti tambahan pada pekerjaan tersebut. Dalam hal ini, Anda dapat menggunakan job kata kunci .

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

Alur Anda mungkin memiliki beberapa pekerjaan. Dalam hal ini, gunakan jobs kata kunci .

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

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

Alur Anda mungkin memiliki beberapa tahap, masing-masing dengan beberapa pekerjaan. Dalam hal ini, gunakan stages kata kunci .

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

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

Sintaks penuh untuk menentukan pekerjaan adalah:

- 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

Sintaks penuh untuk menentukan pekerjaan adalah:

- 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

Jika niat utama pekerjaan Anda adalah untuk menyebarkan aplikasi Anda (dibandingkan dengan membangun atau menguji aplikasi Anda), maka Anda dapat menggunakan jenis pekerjaan khusus yang disebut pekerjaan penyebaran.

Sintaks untuk pekerjaan penyebaran adalah:

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

Meskipun Anda dapat menambahkan langkah-langkah untuk tugas penyebaran dalam job, kami sarankan Anda menggunakan pekerjaan penyebaran. Pekerjaan penyebaran memiliki beberapa manfaat. Misalnya, Anda dapat menyebarkan ke lingkungan, yang mencakup manfaat seperti dapat melihat riwayat apa yang telah Anda sebarkan.

YAML tidak didukung di TFS.

Klasik

Untuk menambahkan pekerjaan ke alur build Anda, edit alur di halaman Alur. Pilih ... untuk menambahkan pekerjaan.

Untuk menambahkan pekerjaan ke alur rilis Anda, edit alur dariRilis>Alur. Lihat tugas tahap di tahap tempat Anda ingin menambahkan pekerjaan Anda. Pilih ... untuk menambahkan pekerjaan.

Jenis pekerjaan

Pekerjaan dapat dari berbagai jenis, tergantung di mana mereka berjalan.

YAML

• Pekerjaan kumpulan agen berjalan pada agen di kumpulan agen.
• Pekerjaan server berjalan pada Azure DevOps Server.
• Pekerjaan kontainer berjalan dalam kontainer pada agen di kumpulan agen. Untuk informasi selengkapnya tentang memilih kontainer, lihat Menentukan pekerjaan kontainer.

Klasik

• Pekerjaan kumpulan agen berjalan pada agen di kumpulan agen.
• Pekerjaan server berjalan pada Azure DevOps Server.
• Pekerjaan grup penyebaran berjalan pada mesin dalam grup penyebaran. Pekerjaan ini hanya tersedia dalam alur rilis. Untuk informasi selengkapnya tentang menentukan grup server target untuk penyebaran, lihat Pekerjaan grup penyebaran.

YAML

• Pekerjaan kumpulan agen berjalan pada agen di kumpulan agen.
• Pekerjaan server berjalan pada Azure DevOps Server.

Klasik

• Pekerjaan kumpulan agen berjalan pada agen di kumpulan agen.
• Pekerjaan server berjalan pada Azure DevOps Server.
• Pekerjaan grup penyebaran berjalan pada mesin dalam grup penyebaran. Pekerjaan ini hanya tersedia dalam alur rilis.

• Pekerjaan kumpulan agen berjalan pada agen di kumpulan agen. Pekerjaan ini tersedia dalam alur build dan rilis.
• Pekerjaan server berjalan di TFS. Pekerjaan ini tersedia dalam alur build dan rilis.
• Pekerjaan grup penyebaran berjalan pada mesin dalam grup penyebaran. Pekerjaan ini hanya tersedia dalam alur rilis.

Pekerjaan kumpulan agen

Ini adalah jenis pekerjaan yang paling umum dan dijalankan pada agen di kumpulan agen.

• Saat menggunakan agen yang dihosting Microsoft, setiap pekerjaan dalam alur mendapatkan agen baru.
• Gunakan tuntutan dengan agen yang dihost sendiri untuk menentukan kemampuan apa yang harus dimiliki agen untuk menjalankan pekerjaan Anda. Anda mungkin mendapatkan agen yang sama untuk pekerjaan berturut-turut, tergantung pada apakah ada lebih dari satu agen di kumpulan agen Anda yang cocok dengan permintaan alur Anda. Jika hanya ada satu agen di kumpulan Anda yang cocok dengan tuntutan alur, alur akan menunggu hingga agen ini tersedia.

Catatan

Tuntutan dan kemampuan dirancang untuk digunakan dengan agen yang dihost sendiri sehingga pekerjaan dapat dicocokkan dengan agen yang memenuhi persyaratan pekerjaan. Saat menggunakan agen yang dihosting Microsoft, Anda memilih gambar untuk agen yang cocok dengan persyaratan pekerjaan, jadi meskipun dimungkinkan untuk menambahkan kemampuan ke agen yang dihosting Microsoft, Anda tidak perlu menggunakan kemampuan dengan agen yang dihosting Microsoft.

YAML

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

Atau beberapa tuntutan:

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

YAML tidak didukung di TFS.

Klasik

Anda memiliki opsi untuk menentukan permintaan dalam alur, dalam pekerjaan, atau keduanya. Jika Anda menentukan tuntutan dalam alur dan dalam pekerjaan, penyatuan dua set tuntutan diperlukan agar sistem memilih agen.

Pelajari selengkapnya tentang kemampuan agen.

Pekerjaan server

Tugas dalam pekerjaan server diorkestrasi oleh dan dijalankan di server (Azure Pipelines atau TFS). Pekerjaan server tidak memerlukan agen atau komputer target apa pun. Hanya beberapa tugas yang didukung dalam pekerjaan server saat ini.

Tugas yang didukung pekerjaan tanpa agen

Saat ini, hanya tugas berikut yang didukung di luar kotak untuk pekerjaan tanpa agen:

• Tugas penundaan
• Memanggil tugas Azure Function
• Memanggil tugas REST API
• Tugas Validasi Manual
• Tugas Terbitkan Ke Azure Service Bus
• Mengkueri tugas Pemberitahuan Azure Monitor
• Tugas Item Kerja Kueri

Karena tugas dapat diperluas, Anda dapat menambahkan lebih banyak tugas tanpa agen dengan menggunakan ekstensi. Batas waktu default untuk pekerjaan tanpa agen adalah 60 menit.

YAML

Sintaks penuh untuk menentukan pekerjaan server adalah:

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

  pool: server # note: the value 'server' is a reserved keyword which indicates this is an agentless job

Anda juga dapat menggunakan sintaks yang disederhanakan:

jobs:
- job: string
  pool: server # note: the value 'server' is a reserved keyword which indicates this is an agentless job

YAML tidak didukung di TFS.

Klasik

Anda menambahkan pekerjaan server di editor dengan memilih '...' pada saluran Alur di tab Tugas dari alur. Properti untuk pekerjaan server ditampilkan saat Anda memilih pekerjaan di editor.

Dependensi

Saat Anda menentukan beberapa pekerjaan dalam satu tahap, Anda dapat menentukan dependensi di antaranya. Alur harus berisi setidaknya satu pekerjaan tanpa dependensi.

Catatan

Setiap agen hanya dapat menjalankan satu pekerjaan pada satu waktu. Untuk menjalankan beberapa pekerjaan secara paralel, Anda harus mengonfigurasi beberapa agen. Anda juga memerlukan pekerjaan paralel yang memadai.

YAML

Sintaks untuk menentukan beberapa pekerjaan dan dependensinya adalah:

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

Contoh pekerjaan yang dibangun secara berurutan:

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

Contoh pekerjaan yang dibangun secara paralel (tanpa dependensi):

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

Contoh fan-out:

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

Contoh fan-in:

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 tidak didukung di TFS.

Klasik

Untuk menambahkan pekerjaan baru, pilih '...' pada saluran alur di tab Tugas dari alur. Kondisi dan urutan eksekusi untuk pekerjaan ditampilkan saat Anda memilih pekerjaan di editor.

Saat Anda menentukan beberapa pekerjaan dalam alur build, pekerjaan berjalan secara paralel secara default. Anda dapat menentukan urutan pekerjaan yang harus dijalankan dengan mengonfigurasi dependensi antar pekerjaan. Dependensi pekerjaan tidak didukung dalam alur rilis. Beberapa pekerjaan dalam alur rilis berjalan secara berurutan.

Beberapa pekerjaan yang Anda tambahkan ke build atau alur rilis berjalan secara berurutan. Anda tidak dapat mengonfigurasi urutan dependensi antara pekerjaan dalam versi TFS ini.

Beberapa pekerjaan yang Anda tambahkan ke alur rilis berjalan secara berurutan. Anda tidak dapat mengonfigurasi urutan dependensi antara pekerjaan dalam versi TFS ini. Anda juga tidak dapat menggunakan pekerjaan dengan alur build.

Misalnya, alur yang ditunjukkan di bawah ini membagi eksekusi rilis keseluruhan menjadi pekerjaan eksekusi terpisah dengan menggunakan dua pekerjaan agen dan pekerjaan server.

Dalam contoh di atas:

1. Tugas dalam pekerjaan pertama rilis berjalan pada agen dan, setelah pekerjaan ini selesai, agen dirilis.

2. Pekerjaan server berisi tugas Intervensi Manual yang berjalan pada Azure Pipelines atau TFS. Pekerjaan tidak dijalankan pada, atau memerlukan, agen atau server target apa pun. Tugas Intervensi Manual menampilkan pesannya dan menunggu respons "lanjutkan" atau "tolak" dari pengguna. Dalam contoh ini, jika batas waktu yang dikonfigurasi tercapai, tugas akan secara otomatis menolak penyebaran (atur batas waktu di bagian opsi kontrol ke nol jika Anda tidak ingin respons otomatis dihasilkan).

3. Jika rilis dilanjutkan, tugas dalam pekerjaan ketiga berjalan - mungkin pada agen yang berbeda. Jika rilis ditolak, pekerjaan ini tidak berjalan dan rilis ditandai sebagai gagal.

Penting untuk memahami beberapa konsekuensi dari eksekusi bertahas:

• Setiap pekerjaan dapat menggunakan agen yang berbeda. Jangan berasumsi bahwa status dari pekerjaan sebelumnya tersedia selama pekerjaan berikutnya.

• Opsi Lanjutkan pada Kesalahan dan Selalu jalankan untuk tugas di setiap pekerjaan tidak berpengaruh pada tugas dalam pekerjaan berikutnya. Misalnya, mengatur Selalu jalankan pada tugas di akhir pekerjaan pertama tidak akan menjamin bahwa tugas dalam pekerjaan berikutnya akan berjalan.

Kondisi

Anda dapat menentukan kondisi di mana setiap pekerjaan berjalan. Secara default, pekerjaan berjalan jika tidak bergantung pada pekerjaan lain, atau jika semua pekerjaan yang bergantung pada pekerjaan telah selesai dan berhasil. Anda dapat menyesuaikan perilaku ini dengan memaksa pekerjaan untuk dijalankan meskipun pekerjaan sebelumnya gagal atau dengan menentukan kondisi kustom.

YAML

Contoh untuk menjalankan pekerjaan berdasarkan status menjalankan pekerjaan sebelumnya:

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

Contoh penggunaan kondisi kustom:

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

Anda dapat menentukan bahwa pekerjaan berjalan berdasarkan nilai variabel output yang ditetapkan dalam pekerjaan sebelumnya. Dalam hal ini, Anda hanya dapat menggunakan variabel yang diatur dalam pekerjaan dependen langsung:

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 tidak didukung di TFS.

Klasik

Gunakan opsi Jalankan pekerjaan ini pada pekerjaan agen atau server untuk menjalankan tugas hanya ketika kondisi tertentu terpenuhi. Pilih kondisi yang telah ditentukan sebelumnya, atau pilih "kustom" dan masukkan ekspresi yang mengevaluasi ke true atau false. Ekspresi berlapis dapat digunakan, dan ekspresi dapat mengakses variabel yang tersedia dalam alur rilis.

Kondisi tidak didukung dalam versi TFS ini.

Waktu habis

Untuk menghindari mengambil sumber daya ketika pekerjaan Anda tidak responsif atau menunggu terlalu lama, ada baiknya untuk menetapkan batas berapa lama pekerjaan Anda diizinkan untuk dijalankan. Gunakan pengaturan batas waktu pekerjaan untuk menentukan batas dalam menit untuk menjalankan pekerjaan. Mengatur nilai ke nol berarti pekerjaan dapat berjalan:

• Selamanya pada agen yang dihost sendiri
• Selama 360 menit (6 jam) pada agen yang dihosting Microsoft dengan proyek publik dan repositori publik
• Selama 60 menit pada agen yang dihosting Microsoft dengan proyek privat atau repositori privat (kecuali kapasitas tambahan dibayar)

Periode batas waktu dimulai ketika pekerjaan mulai berjalan. Ini tidak termasuk waktu pekerjaan diantrekan atau sedang menunggu agen.

YAML

timeoutInMinutes memungkinkan batas untuk ditetapkan untuk waktu eksekusi pekerjaan. Ketika tidak ditentukan, defaultnya adalah 60 menit. Ketika 0 ditentukan, batas maksimum digunakan (dijelaskan di atas).

cancelTimeoutInMinutes memungkinkan batas untuk diatur untuk waktu pembatalan pekerjaan ketika tugas penyebaran diatur untuk tetap berjalan jika tugas sebelumnya gagal. Ketika tidak ditentukan, defaultnya adalah 5 menit. Nilai harus berkisar antara 1 hingga 35790 menit.

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 tidak didukung di TFS.

Klasik

Pilih pekerjaan lalu tentukan nilai batas waktu.

Pada tab Opsi, Anda dapat menentukan nilai default untuk semua pekerjaan dalam alur. Jika Anda menentukan nilai bukan nol untuk batas waktu pekerjaan, nilai tersebut akan menggantikan nilai apa pun yang ditentukan dalam opsi alur. Jika Anda menentukan nilai nol, maka nilai batas waktu dari opsi alur digunakan. Jika nilai alur juga diatur ke nol, maka tidak ada batas waktu.

Pekerjaan yang menargetkan agen yang dihosting Microsoft memiliki batasan tambahan tentang berapa lama mereka dapat berjalan.

Anda juga dapat mengatur batas waktu untuk setiap tugas satu per satu - lihat opsi kontrol tugas.

Konfigurasi multi-pekerjaan

Dari satu pekerjaan yang Anda tulis, Anda dapat menjalankan beberapa pekerjaan di beberapa agen secara paralel. Beberapa contoh termasuk:

• Build multi-konfigurasi: Anda dapat membangun beberapa konfigurasi secara paralel. Misalnya, Anda dapat membuat aplikasi Visual C++ untuk debug konfigurasi dan release pada x86 platform dan x64 . Untuk mempelajari selengkapnya, lihat Visual Studio Build - beberapa konfigurasi untuk beberapa platform.

• Penyebaran multi-konfigurasi: Anda dapat menjalankan beberapa penyebaran secara paralel, misalnya, ke wilayah geografis yang berbeda.

• Pengujian multi-konfigurasi: Anda dapat menjalankan pengujian beberapa konfigurasi secara paralel.

• Multi-konfigurasi akan selalu menghasilkan setidaknya satu pekerjaan, bahkan jika variabel multi-konfigurasi kosong.

YAML

Strategi ini matrix memungkinkan pekerjaan dikirim beberapa kali, dengan set variabel yang berbeda. Tag maxParallel membatasi jumlah paralelisme. Pekerjaan berikut akan dikirim tiga kali dengan nilai Lokasi dan Browser yang ditetapkan sebagaimana ditentukan. Namun, hanya dua pekerjaan yang akan berjalan pada saat yang sama.

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

Catatan

Nama konfigurasi matriks (seperti US_IE di atas) hanya boleh berisi huruf alfabet Latin dasar (A-Z, a-z), angka, dan garis bawah (_). Nama kolom harus diawali dengan huruf. Selain itu, karakter harus 100 karakter atau kurang.

Anda juga dapat menggunakan variabel output untuk menghasilkan matriks. Ini bisa berguna jika Anda perlu menghasilkan matriks menggunakan skrip.

matrix akan menerima ekspresi runtime yang berisi objek JSON yang di string. Objek JSON tersebut, ketika diperluas, harus cocok dengan sintaks matriks. Dalam contoh di bawah ini, kami telah mengkodekan string JSON secara permanen, tetapi dapat dihasilkan oleh bahasa skrip atau program baris perintah.

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

YAML tidak didukung di TFS.

Klasik

Untuk menjalankan beberapa pekerjaan menggunakan opsi multi-konfigurasi, Anda mengidentifikasi variabel bernama pengali, dan menentukan daftar nilai untuk pengali tersebut. Pekerjaan terpisah dijalankan untuk setiap nilai dalam daftar. Untuk menggunakan perkalian untuk build atau penyebaran, Anda harus:

• Tentukan satu atau beberapa variabel pada tab Variabel dari alur atau dalam grup variabel. Setiap variabel, yang dikenal dalam konteks ini sebagai variabel pengali , harus didefinisikan sebagai daftar nilai yang dibatasi koma yang ingin Anda teruskan satu per satu ke agen.

• Masukkan nama variabel pengali, tanpa $ tanda kurung dan , sebagai nilai parameter Pengali . Menggunakan variabel rahasia sebagai variabel pengali tidak didukung.

• Jika Anda ingin menjalankan pekerjaan untuk lebih dari satu variabel pengali, masukkan nama variabel sebagai daftar yang dibatasi koma - menghilangkan $ tanda kurung dan untuk masing-masing variabel.

• Jika Anda ingin membatasi jumlah agen yang digunakan selama penyebaran ke angka yang kurang dari yang telah Anda konfigurasi untuk langganan Anda, masukkan nilai tersebut sebagai parameter Jumlah maksimum agen .

Misalnya, Anda dapat menentukan dua variabel bernama Lokasi dan Browser sebagai berikut:

• Lokasi = US,Europe
• Browser = IE,Chrome,Edge,Firefox

Konfigurasi berikut akan menjalankan penyebaran delapan kali menggunakan maksimum empat agen kapan saja:

• Pengganda = Location,Browser
• Jumlah maksimum agen = 4

Dengan multi-konfigurasi, Anda dapat menjalankan beberapa pekerjaan, masing-masing dengan nilai yang berbeda untuk satu, atau beberapa variabel (perkalian). Jika Anda ingin menjalankan pekerjaan yang sama pada beberapa agen, maka Anda dapat menggunakan opsi paralelisme multi-agen . Contoh pemotongan pengujian di atas dapat dicapai melalui opsi multi-agen.

Membelah

Pekerjaan agen dapat digunakan untuk menjalankan serangkaian pengujian secara paralel. Misalnya, Anda dapat menjalankan rangkaian besar 1000 pengujian pada satu agen. Atau, Anda dapat menggunakan dua agen dan menjalankan 500 pengujian pada masing-masing secara paralel.

Untuk memanfaatkan pemotongan, tugas dalam pekerjaan harus cukup cerdas untuk memahami irisan miliknya.

Tugas Uji Visual Studio adalah salah satu tugas yang mendukung pengirisan pengujian. Jika Anda telah menginstal beberapa agen, Anda dapat menentukan bagaimana tugas Pengujian Visual Studio akan berjalan secara paralel pada agen ini.

YAML

Strategi ini parallel memungkinkan pekerjaan diduplikasi berkali-kali. System.JobPositionInPhase Variabel dan System.TotalJobsInPhase ditambahkan ke setiap pekerjaan. Variabel kemudian dapat digunakan dalam skrip Anda untuk membagi pekerjaan di antara pekerjaan. Lihat Paralel dan beberapa eksekusi menggunakan pekerjaan agen.

Pekerjaan berikut akan dikirim lima kali dengan nilai System.JobPositionInPhase dan System.TotalJobsInPhase diatur dengan tepat.

jobs:
- job: Test
  strategy:
    parallel: 5

YAML tidak didukung di TFS.

Klasik

Tentukan opsi multi-agen pada pekerjaan agen untuk memanfaatkan pemotongan. Pekerjaan dikirim sebanyak jumlah agen yang Anda tentukan, dan variabel System.JobPositionInPhase dan System.TotalJobsInPhase secara otomatis diatur dalam setiap pekerjaan.

Variabel pekerjaan

Jika Anda menggunakan YAML, variabel dapat ditentukan pada pekerjaan. Variabel dapat diteruskan ke input tugas menggunakan sintaks makro $(variableName), atau diakses dalam skrip menggunakan variabel tahap.

YAML

Berikut adalah contoh menentukan variabel dalam pekerjaan dan menggunakannya dalam tugas.

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 tidak didukung di TFS.

Klasik

Variabel pekerjaan belum didukung di editor web.

Untuk informasi tentang menggunakan kondisi, lihat Menentukan kondisi.

Ruang kerja

Saat Anda menjalankan pekerjaan kumpulan agen, itu membuat ruang kerja pada agen. Ruang kerja adalah direktori tempat ia mengunduh sumber, menjalankan langkah-langkah, dan menghasilkan output. Direktori ruang kerja dapat direferensikan dalam pekerjaan Anda menggunakan Pipeline.Workspace variabel. Di bawah ini, berbagai subdirektori dibuat:

Saat Anda menjalankan pekerjaan kumpulan agen, itu membuat ruang kerja pada agen. Ruang kerja adalah direktori tempat ia mengunduh sumber, menjalankan langkah-langkah, dan menghasilkan output. Direktori ruang kerja dapat direferensikan dalam pekerjaan Anda menggunakan Agent.BuildDirectory variabel. Di bawah ini, berbagai subdirektori dibuat:

• Build.SourcesDirectory adalah tempat tugas mengunduh kode sumber aplikasi.
• Build.ArtifactStagingDirectory adalah tempat tugas mengunduh artefak yang diperlukan untuk alur atau mengunggah artefak sebelum diterbitkan.
• Build.BinariesDirectory adalah tempat tugas menulis output mereka.
• Common.TestResultsDirectory adalah tempat tugas mengunggah hasil pengujiannya.

YAML

$(Build.ArtifactStagingDirectory) dan $(Common.TestResultsDirectory) selalu dihapus dan dibuat ulang sebelum setiap build.

Saat Anda menjalankan alur pada agen yang dihost sendiri, secara default, tidak ada subdirektori selain $(Build.ArtifactStagingDirectory) dan $(Common.TestResultsDirectory) dibersihkan di antara dua eksekusi berturut-turut. Akibatnya, Anda dapat melakukan build dan penyebaran inkremental, asalkan tugas diimplementasikan untuk memanfaatkannya. Anda dapat mengambil alih perilaku ini menggunakan workspace pengaturan pada pekerjaan.

Penting

Opsi bersih ruang kerja hanya berlaku untuk agen yang dihost sendiri. Saat menggunakan agen yang dihosting Microsoft, pekerjaan selalu dijalankan pada agen baru.

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

Saat Anda menentukan salah satu opsi, opsi tersebut clean ditafsirkan sebagai berikut:

• outputs: Hapus Build.BinariesDirectory sebelum menjalankan pekerjaan baru.
• resources: Hapus Build.SourcesDirectory sebelum menjalankan pekerjaan baru.
• all: Hapus seluruh Pipeline.Workspace direktori sebelum menjalankan pekerjaan baru.

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

Catatan

Bergantung pada kemampuan agen dan permintaan alur Anda, setiap pekerjaan dapat dirutekan ke agen yang berbeda di kumpulan yang dihost sendiri. Akibatnya, Anda mungkin mendapatkan agen baru untuk eksekusi alur berikutnya (atau tahap atau pekerjaan dalam alur yang sama), jadi tidak membersihkan bukanlah jaminan bahwa eksekusi, pekerjaan, atau tahap berikutnya akan dapat mengakses output dari eksekusi, pekerjaan, atau tahap sebelumnya. Anda dapat mengonfigurasi kemampuan agen dan tuntutan alur untuk menentukan agen mana yang digunakan untuk menjalankan pekerjaan alur, tetapi kecuali hanya ada satu agen di kumpulan yang memenuhi tuntutan, tidak ada jaminan bahwa pekerjaan berikutnya akan menggunakan agen yang sama dengan pekerjaan sebelumnya. Untuk informasi selengkapnya, lihat Menentukan permintaan.

Selain membersihkan ruang kerja, Anda juga dapat mengonfigurasi pembersihan dengan mengonfigurasi pengaturan Bersihkan di antarmuka pengguna pengaturan alur. Ketika pengaturan Bersihkanbenar, yang juga merupakan nilai defaultnya, setara dengan menentukan clean: true untuk setiap langkah checkout di alur Anda. Saat Anda menentukan clean: true, Anda akan berjalan git clean -ffdx diikuti oleh git reset --hard HEAD sebelum pengambilan git. Untuk mengonfigurasi pengaturan Bersihkan :

1. Edit alur Anda, pilih ..., dan pilih Pemicu.

   

2. Pilih YAML, Dapatkan sumber, dan konfigurasikan pengaturan Bersih yang Anda inginkan. Defaultnya adalah true

   

YAML tidak didukung di TFS.

Klasik

Saat Anda menjalankan alur pada agen yang dihost sendiri, secara default, tidak ada subdirektori yang dibersihkan di antara dua eksekusi berturut-turut. Akibatnya, Anda dapat menjalankan build dan penyebaran inkremental, asalkan tugas diimplementasikan untuk melakukannya. Namun, Anda dapat mengambil alih perilaku ini menggunakan opsi di Clean build bawah Get sources tugas. Opsi bervariasi tergantung pada jenis repositori yang Anda gunakan.

• GitHub
• Azure Repos Git
• TFVC

Unduhan artefak

Contoh file YAML ini menerbitkan artefak WebSite dan kemudian mengunduh artefak ke $(Pipeline.Workspace). Pekerjaan Sebarkan hanya berjalan jika pekerjaan Build berhasil.

YAML

# 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 tidak didukung di TFS.

Klasik

Dalam alur rilis, Anda dapat memilih untuk melewati pengunduhan artefak selama eksekusi pekerjaan. Gunakan opsi ini jika Anda ingin menerapkan logika kustom Anda sendiri untuk mengunduh artefak dengan menggunakan tugas, atau jika tugas dalam pekerjaan tertentu tidak bergantung pada artefak.

Atau, Anda dapat memilih untuk mengunduh artefak tertentu selama eksekusi pekerjaan dalam rilis. Gunakan opsi ini jika tugas dalam pekerjaan tertentu hanya mengandalkan artefak tertentu.

Untuk informasi tentang menggunakan dependsOn dan kondisi, lihat Menentukan kondisi.

Akses ke token OAuth

Anda dapat mengizinkan skrip yang berjalan dalam pekerjaan untuk mengakses token keamanan Azure Pipelines atau TFS OAuth saat ini. Token dapat digunakan untuk mengautentikasi ke AZURE Pipelines REST API.

YAML

Token OAuth selalu tersedia untuk alur YAML. Ini harus secara eksplisit dipetakan ke dalam tugas atau langkah menggunakan env. Berikut contohnya:

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 tidak didukung di TFS.

Klasik

Pilih opsi Izinkan skrip untuk mengakses token OAuth di opsi kontrol untuk pekerjaan tersebut. Token akan tersedia sebagai variabel SYSTEM_ACCESSTOKENlingkungan .

Selanjutnya

• Pekerjaan grup penyebaran
• Kondisi