Referensi skema YAML untuk Azure Pipelines
Referensi skema YAML untuk Azure Pipelines adalah referensi terperinci untuk alur YAML yang mencantumkan semua sintaks YAML yang didukung dan opsi yang tersedia.
Untuk membuat alur YAML, mulailah dengan definisi alur . Untuk informasi selengkapnya tentang membangun alur YAML, lihat Menyesuaikan alur Anda.
Referensi skema YAML tidak mencakup tugas. Untuk informasi selengkapnya tentang tugas, lihat indeks tugas Azure Pipelines.
Indeks definisi skema YAML
Alur adalah satu atau beberapa pekerjaan yang menjelaskan proses CI/CD.
Daftar pekerjaan menentukan pekerjaan yang membentuk pekerjaan tahapan.
Kata matrix
kunci dan parallel
menentukan strategi yang saling eksklusif untuk menduplikasi pekerjaan.
Kata pool
kunci menentukan kumpulan mana yang akan digunakan untuk pekerjaan alur.
pool
Spesifikasi juga menyimpan informasi tentang strategi pekerjaan untuk berjalan.
Pemicu permintaan pull menentukan cabang mana yang menyebabkan build permintaan pull berjalan.
Sumber daya menentukan build, repositori, alur, dan sumber daya lain yang digunakan oleh alur.
Daftar sumber daya build yang dirujuk oleh alur.
Jika Anda memiliki sistem build CI eksternal yang menghasilkan artefak, Anda dapat menggunakan artefak dengan sumber daya build.
Daftar sumber daya kontainer yang dirujuk oleh alur.
Sumber daya kontainer mereferensikan gambar kontainer.
Daftar sumber daya alur yang dirujuk oleh alur.
Jika Anda memiliki Azure Pipeline yang menghasilkan artefak, alur Anda dapat menggunakan artefak dengan menentukan sumber daya alur. Pada Azure DevOps Server 2020 dan yang lebih tinggi, Anda juga dapat mengaktifkan pemicu penyelesaian alur menggunakan sumber daya alur.
Daftar sumber daya repositori yang direferensikan oleh alur.
Kata repository
kunci memungkinkan Anda menentukan repositori eksternal.
Langkah-langkah adalah urutan operasi linier yang membentuk pekerjaan.
Langkah ini bash
menjalankan skrip di Bash di Windows, macOS, dan Linux.
Gunakan checkout
untuk mengonfigurasi cara alur memeriksa kode sumber.
Langkah ini download
mengunduh artefak yang terkait dengan eksekusi saat ini atau dari Alur Azure lain yang terkait sebagai sumber daya alur.
Langkah ini downloadBuild
mengunduh artefak build.
Langkah ini powershell
menjalankan skrip menggunakan Windows PowerShell (di Windows) atau pwsh
(Linux dan macOS).
Kata publish
kunci menerbitkan (mengunggah) file atau folder sebagai artefak alur yang dapat dikonsumsi pekerjaan dan alur lain.
Langkah ini pwsh
menjalankan skrip di PowerShell Core di Windows, macOS, dan Linux.
Langkah ini script
menjalankan skrip menggunakan cmd.exe di Windows dan Bash pada platform lain.
Langkah task
menjalankan tugas.
Anda dapat menentukan sekumpulan langkah dalam satu file dan menggunakannya beberapa kali di file lain.
Pemicu pendorongan menentukan cabang mana yang menyebabkan build integrasi berkelanjutan berjalan.
Tentukan variabel yang akan digunakan dalam alur Anda.
Variabel referensi dari grup variabel.
Tentukan variabel menggunakan sintaks penuh.
Anda dapat menentukan sekumpulan variabel dalam satu file dan menggunakannya beberapa kali di file lain.
Alur adalah satu atau beberapa pekerjaan yang menjelaskan proses CI/CD.
Daftar pekerjaan menentukan pekerjaan yang membentuk pekerjaan tahapan.
Pekerjaan kontainer memungkinkan Anda menjalankan pekerjaan pada kontainer alih-alih host agen.
Kata matrix
kunci dan parallel
menentukan strategi yang saling eksklusif untuk menduplikasi pekerjaan.
Kata pool
kunci menentukan kumpulan mana yang akan digunakan untuk pekerjaan alur.
pool
Spesifikasi juga menyimpan informasi tentang strategi pekerjaan untuk berjalan.
Pemicu permintaan pull menentukan cabang mana yang menyebabkan build permintaan pull berjalan.
Sumber daya menentukan build, repositori, alur, dan sumber daya lain yang digunakan oleh alur.
Daftar sumber daya build yang dirujuk oleh alur.
Jika Anda memiliki sistem build CI eksternal yang menghasilkan artefak, Anda dapat menggunakan artefak dengan sumber daya build.
Daftar sumber daya kontainer yang dirujuk oleh alur.
Sumber daya kontainer mereferensikan gambar kontainer.
Daftar sumber daya alur yang dirujuk oleh alur.
Jika Anda memiliki Azure Pipeline yang menghasilkan artefak, alur Anda dapat menggunakan artefak dengan menentukan sumber daya alur. Pada Azure DevOps Server 2020 dan yang lebih tinggi, Anda juga dapat mengaktifkan pemicu penyelesaian alur menggunakan sumber daya alur.
Daftar sumber daya repositori yang direferensikan oleh alur.
Kata repository
kunci memungkinkan Anda menentukan repositori eksternal.
Langkah-langkah adalah urutan operasi linier yang membentuk pekerjaan.
Langkah ini bash
menjalankan skrip di Bash di Windows, macOS, dan Linux.
Gunakan checkout
untuk mengonfigurasi cara alur memeriksa kode sumber.
Langkah ini download
mengunduh artefak yang terkait dengan eksekusi saat ini atau dari Alur Azure lain yang terkait sebagai sumber daya alur.
Langkah ini downloadBuild
mengunduh artefak build.
Langkah ini powershell
menjalankan skrip menggunakan Windows PowerShell (di Windows) atau pwsh
(Linux dan macOS).
Kata publish
kunci menerbitkan (mengunggah) file atau folder sebagai artefak alur yang dapat dikonsumsi pekerjaan dan alur lain.
Langkah ini pwsh
menjalankan skrip di PowerShell Core di Windows, macOS, dan Linux.
Langkah ini script
menjalankan skrip menggunakan cmd.exe di Windows dan Bash pada platform lain.
Langkah task
menjalankan tugas.
Anda dapat menentukan sekumpulan langkah dalam satu file dan menggunakannya beberapa kali di file lain.
Pemicu pendorongan menentukan cabang mana yang menyebabkan build integrasi berkelanjutan berjalan.
Tentukan variabel yang akan digunakan dalam alur Anda.
Variabel referensi dari grup variabel.
Tentukan variabel menggunakan sintaks penuh.
Anda dapat menentukan sekumpulan variabel dalam satu file dan menggunakannya beberapa kali di file lain.
Alur adalah satu atau lebih tahapan yang menggambarkan proses CI/CD.
Memperluas alur menggunakan templat.
Daftar pekerjaan menentukan pekerjaan yang membentuk pekerjaan tahapan.
Pekerjaan penyebaran adalah jenis pekerjaan khusus. Ini adalah kumpulan langkah-langkah untuk berjalan secara berurutan terhadap lingkungan.
Kata environment
kunci menentukan lingkungan atau sumber dayanya yang ditargetkan oleh pekerjaan penyebaran alur.
Strategi penyebaran memungkinkan Anda mengonfigurasi bagaimana pembaruan dikirimkan.
Strategi penyebaran kenari meluncurkan perubahan pada subset kecil server.
Penyebaran bergulir menggantikan instans versi aplikasi sebelumnya dengan instans versi baru aplikasi pada sekumpulan komputer virtual tetap (set bergulir) di setiap iterasi.
Strategi penyebaran runOnce meluncurkan perubahan dengan menjalankan masing-masing langkahnya satu kali.
Pekerjaan kontainer memungkinkan Anda menjalankan pekerjaan pada kontainer alih-alih host agen.
Kata matrix
kunci dan parallel
menentukan strategi yang saling eksklusif untuk menduplikasi pekerjaan.
Anda dapat menentukan sekumpulan pekerjaan dalam satu file dan menggunakannya beberapa kali di file lain. Lihat templat untuk informasi selengkapnya tentang bekerja dengan templat pekerjaan.
Daftar parameter menentukan parameter runtime yang diteruskan ke alur.
Parameter mewakili nilai yang diteruskan ke alur.
Kata pool
kunci menentukan kumpulan mana yang akan digunakan untuk pekerjaan alur.
pool
Spesifikasi juga menyimpan informasi tentang strategi pekerjaan untuk berjalan.
Pemicu permintaan pull menentukan cabang mana yang menyebabkan build permintaan pull berjalan.
Sumber daya menentukan build, repositori, alur, dan sumber daya lain yang digunakan oleh alur.
Daftar sumber daya build yang dirujuk oleh alur.
Jika Anda memiliki sistem build CI eksternal yang menghasilkan artefak, Anda dapat menggunakan artefak dengan sumber daya build.
Daftar sumber daya kontainer yang dirujuk oleh alur.
Sumber daya kontainer mereferensikan gambar kontainer.
Daftar sumber daya paket yang dirujuk oleh alur.
Anda dapat menggunakan paket NuGet dan npm GitHub sebagai sumber daya dalam alur YAML. Saat menentukan sumber daya paket, atur paket sebagai NuGet
atau npm
.
Daftar sumber daya alur yang dirujuk oleh alur.
Jika Anda memiliki Azure Pipeline yang menghasilkan artefak, alur Anda dapat menggunakan artefak dengan menentukan sumber daya alur. Pada Azure DevOps Server 2020 dan yang lebih tinggi, Anda juga dapat mengaktifkan pemicu penyelesaian alur menggunakan sumber daya alur.
Daftar sumber daya repositori yang direferensikan oleh alur.
Kata repository
kunci memungkinkan Anda menentukan repositori eksternal.
Daftar jadwal menentukan pemicu terjadwal untuk alur.
Pemicu terjadwal menentukan jadwal di mana cabang dibangun.
Tahapan adalah kumpulan pekerjaan terkait.
Tahapan adalah kumpulan pekerjaan terkait. Secara default, tahapan berjalan secara berurutan. Setiap tahap dimulai hanya setelah tahap sebelumnya selesai kecuali ditentukan lain melalui dependsOn
properti .
Anda dapat menentukan sekumpulan tahapan dalam satu file dan menggunakannya beberapa kali di file lain.
Langkah-langkah adalah urutan operasi linier yang membentuk pekerjaan.
Langkah ini bash
menjalankan skrip di Bash di Windows, macOS, dan Linux.
Gunakan checkout
untuk mengonfigurasi cara alur memeriksa kode sumber.
Langkah ini download
mengunduh artefak yang terkait dengan eksekusi saat ini atau dari Alur Azure lain yang terkait sebagai sumber daya alur.
Langkah ini downloadBuild
mengunduh artefak build.
Langkah ini getPackage
mengunduh paket dari umpan manajemen paket di Azure Artifacts atau Azure DevOps Server.
Langkah ini powershell
menjalankan skrip menggunakan Windows PowerShell (di Windows) atau pwsh
(Linux dan macOS).
Kata publish
kunci menerbitkan (mengunggah) file atau folder sebagai artefak alur yang dapat dikonsumsi pekerjaan dan alur lain.
Langkah ini pwsh
menjalankan skrip di PowerShell Core di Windows, macOS, dan Linux.
Langkah reviewApp
mengunduh membuat sumber daya secara dinamis di bawah penyedia fase penyebaran.
Langkah ini script
menjalankan skrip menggunakan cmd.exe di Windows dan Bash pada platform lain.
Langkah task
menjalankan tugas.
Anda dapat menentukan sekumpulan langkah dalam satu file dan menggunakannya beberapa kali di file lain.
Tugas berjalan dalam konteks eksekusi, yang merupakan host agen atau kontainer.
Pemicu pendorongan menentukan cabang mana yang menyebabkan build integrasi berkelanjutan berjalan.
Tentukan variabel yang akan digunakan dalam alur Anda.
Variabel referensi dari grup variabel.
Tentukan variabel menggunakan sintaks penuh.
Anda dapat menentukan sekumpulan variabel dalam satu file dan menggunakannya beberapa kali di file lain.
Alur adalah satu atau lebih tahapan yang menggambarkan proses CI/CD.
Memperluas alur menggunakan templat.
Daftar pekerjaan menentukan pekerjaan yang membentuk pekerjaan tahapan.
Pekerjaan penyebaran adalah jenis pekerjaan khusus. Ini adalah kumpulan langkah-langkah untuk berjalan secara berurutan terhadap lingkungan.
Kata environment
kunci menentukan lingkungan atau sumber dayanya yang ditargetkan oleh pekerjaan penyebaran alur.
Strategi penyebaran memungkinkan Anda mengonfigurasi bagaimana pembaruan dikirimkan.
Strategi penyebaran kenari meluncurkan perubahan pada subset kecil server.
Penyebaran bergulir menggantikan instans versi aplikasi sebelumnya dengan instans versi baru aplikasi pada sekumpulan komputer virtual tetap (set bergulir) di setiap iterasi.
Strategi penyebaran runOnce meluncurkan perubahan dengan menjalankan masing-masing langkahnya satu kali.
Pekerjaan kontainer memungkinkan Anda menjalankan pekerjaan pada kontainer alih-alih host agen.
Kata matrix
kunci dan parallel
menentukan strategi yang saling eksklusif untuk menduplikasi pekerjaan.
Anda dapat menentukan sekumpulan pekerjaan dalam satu file dan menggunakannya beberapa kali di file lain. Lihat templat untuk informasi selengkapnya tentang bekerja dengan templat pekerjaan.
Daftar parameter menentukan parameter runtime yang diteruskan ke alur.
Parameter mewakili nilai yang diteruskan ke alur.
Kata pool
kunci menentukan kumpulan mana yang akan digunakan untuk pekerjaan alur.
pool
Spesifikasi juga menyimpan informasi tentang strategi pekerjaan untuk berjalan.
Pemicu permintaan pull menentukan cabang mana yang menyebabkan build permintaan pull berjalan.
Sumber daya menentukan build, repositori, alur, dan sumber daya lain yang digunakan oleh alur.
Daftar sumber daya build yang dirujuk oleh alur.
Jika Anda memiliki sistem build CI eksternal yang menghasilkan artefak, Anda dapat menggunakan artefak dengan sumber daya build.
Daftar sumber daya kontainer yang dirujuk oleh alur.
Sumber daya kontainer mereferensikan gambar kontainer.
Daftar sumber daya paket yang dirujuk oleh alur.
Anda dapat menggunakan paket NuGet dan npm GitHub sebagai sumber daya dalam alur YAML. Saat menentukan sumber daya paket, atur paket sebagai NuGet
atau npm
.
Daftar sumber daya alur yang dirujuk oleh alur.
Jika Anda memiliki Azure Pipeline yang menghasilkan artefak, alur Anda dapat menggunakan artefak dengan menentukan sumber daya alur. Pada Azure DevOps Server 2020 dan yang lebih tinggi, Anda juga dapat mengaktifkan pemicu penyelesaian alur menggunakan sumber daya alur.
Daftar sumber daya repositori yang direferensikan oleh alur.
Kata repository
kunci memungkinkan Anda menentukan repositori eksternal.
Daftar sumber daya webhook yang direferensikan oleh alur.
Sumber daya webhook memungkinkan Anda mengintegrasikan alur dengan layanan eksternal untuk mengotomatiskan alur kerja.
Filter yang digunakan untuk menyesuaikan pemicu untuk peristiwa webhook.
Filter webhook digunakan untuk menyesuaikan pemicu untuk peristiwa webhook.
Daftar jadwal menentukan pemicu terjadwal untuk alur.
Pemicu terjadwal menentukan jadwal di mana cabang dibangun.
Tahapan adalah kumpulan pekerjaan terkait.
Tahapan adalah kumpulan pekerjaan terkait. Secara default, tahapan berjalan secara berurutan. Setiap tahap dimulai hanya setelah tahap sebelumnya selesai kecuali ditentukan lain melalui dependsOn
properti .
Anda dapat menentukan sekumpulan tahapan dalam satu file dan menggunakannya beberapa kali di file lain.
Langkah-langkah adalah urutan operasi linier yang membentuk pekerjaan.
Langkah ini bash
menjalankan skrip di Bash di Windows, macOS, dan Linux.
Gunakan checkout
untuk mengonfigurasi cara alur memeriksa kode sumber.
Langkah ini download
mengunduh artefak yang terkait dengan eksekusi saat ini atau dari Azure Pipeline lain yang terkait sebagai sumber daya alur.
Langkah ini downloadBuild
mengunduh artefak build.
Langkah ini getPackage
mengunduh paket dari umpan manajemen paket di Azure Artifacts atau Azure DevOps Server.
Langkah ini powershell
menjalankan skrip menggunakan Windows PowerShell (di Windows) atau pwsh
(Linux dan macOS).
Kata publish
kunci menerbitkan (mengunggah) file atau folder sebagai artefak alur yang dapat dikonsumsi oleh pekerjaan dan alur lain.
Langkah ini pwsh
menjalankan skrip di PowerShell Core di Windows, macOS, dan Linux.
Langkah reviewApp
unduhan membuat sumber daya secara dinamis di bawah penyedia fase penyebaran.
Langkah ini script
menjalankan skrip menggunakan cmd.exe di Windows dan Bash pada platform lain.
Langkah task
menjalankan tugas.
Anda dapat menentukan sekumpulan langkah dalam satu file dan menggunakannya beberapa kali di file lain.
Tugas berjalan dalam konteks eksekusi, yang merupakan host agen atau kontainer.
Pemicu dorong menentukan cabang mana yang menyebabkan build integrasi berkelanjutan berjalan.
Tentukan variabel yang akan digunakan dalam alur Anda.
Variabel referensi dari grup variabel.
Tentukan variabel menggunakan sintaks penuh.
Anda dapat menentukan sekumpulan variabel dalam satu file dan menggunakannya beberapa kali di file lain.
Alur adalah satu atau lebih tahapan yang menggambarkan proses CI/CD.
Memperluas alur menggunakan templat.
Daftar pekerjaan menentukan pekerjaan yang membentuk pekerjaan tahapan.
Pekerjaan penyebaran adalah jenis pekerjaan khusus. Ini adalah kumpulan langkah-langkah untuk berjalan secara berurutan terhadap lingkungan.
Kata environment
kunci menentukan lingkungan atau sumber dayanya yang ditargetkan oleh pekerjaan penyebaran alur.
Strategi penyebaran memungkinkan Anda mengonfigurasi bagaimana pembaruan dikirimkan.
Strategi penyebaran kenari meluncurkan perubahan pada subset kecil server.
Penyebaran bergulir menggantikan instans versi aplikasi sebelumnya dengan instans versi baru aplikasi pada sekumpulan komputer virtual tetap (set bergulir) di setiap iterasi.
Strategi penyebaran runOnce meluncurkan perubahan dengan menjalankan masing-masing langkahnya satu kali.
Pekerjaan kontainer memungkinkan Anda menjalankan pekerjaan pada kontainer alih-alih host agen.
Kata matrix
kunci dan parallel
menentukan strategi yang saling eksklusif untuk menduplikasi pekerjaan.
Anda dapat menentukan sekumpulan pekerjaan dalam satu file dan menggunakannya beberapa kali di file lain. Lihat templat untuk informasi selengkapnya tentang bekerja dengan templat pekerjaan.
Daftar parameter menentukan parameter runtime yang diteruskan ke alur.
Parameter mewakili nilai yang diteruskan ke alur.
Kata pool
kunci menentukan kumpulan mana yang akan digunakan untuk pekerjaan alur.
pool
Spesifikasi juga menyimpan informasi tentang strategi pekerjaan untuk berjalan.
Pemicu permintaan pull menentukan cabang mana yang menyebabkan build permintaan pull dijalankan.
Sumber daya menentukan build, repositori, alur, dan sumber daya lain yang digunakan oleh alur.
Daftar sumber daya build yang dirujuk oleh alur.
Jika Anda memiliki sistem build CI eksternal yang menghasilkan artefak, Anda dapat menggunakan artefak dengan sumber daya build.
Daftar sumber daya kontainer yang dirujuk oleh alur.
Sumber daya kontainer mereferensikan gambar kontainer.
Daftar sumber daya paket yang dirujuk oleh alur.
Anda dapat menggunakan paket NuGet dan npm GitHub sebagai sumber daya dalam alur YAML. Saat menentukan sumber daya paket, atur paket sebagai NuGet
atau npm
.
Daftar sumber daya alur yang dirujuk oleh alur.
Jika Anda memiliki Azure Pipeline yang menghasilkan artefak, alur Anda dapat menggunakan artefak dengan menentukan sumber daya alur. Pada Azure DevOps Server 2020 dan yang lebih tinggi, Anda juga dapat mengaktifkan pemicu penyelesaian alur menggunakan sumber daya alur.
Daftar sumber daya repositori yang direferensikan oleh alur.
Kata repository
kunci memungkinkan Anda menentukan repositori eksternal.
Daftar sumber daya webhook yang direferensikan oleh alur.
Sumber daya webhook memungkinkan Anda mengintegrasikan alur dengan layanan eksternal untuk mengotomatiskan alur kerja.
Filter yang digunakan untuk menyesuaikan pemicu untuk peristiwa webhook.
Filter webhook digunakan untuk menyesuaikan pemicu untuk peristiwa webhook.
Daftar jadwal menentukan pemicu terjadwal untuk alur.
Pemicu terjadwal menentukan jadwal di mana cabang dibangun.
Tahapan adalah kumpulan pekerjaan terkait.
Tahapan adalah kumpulan pekerjaan terkait. Secara default, tahapan berjalan secara berurutan. Setiap tahap dimulai hanya setelah tahap sebelumnya selesai kecuali ditentukan lain melalui dependsOn
properti .
Anda dapat menentukan sekumpulan tahapan dalam satu file dan menggunakannya beberapa kali di file lain.
Langkah-langkah adalah urutan operasi linier yang membentuk pekerjaan.
Langkah ini bash
menjalankan skrip di Bash di Windows, macOS, dan Linux.
Gunakan checkout
untuk mengonfigurasi cara alur memeriksa kode sumber.
Langkah ini download
mengunduh artefak yang terkait dengan eksekusi saat ini atau dari Azure Pipeline lain yang terkait sebagai sumber daya alur.
Langkah ini downloadBuild
mengunduh artefak build.
Langkah ini getPackage
mengunduh paket dari umpan manajemen paket di Azure Artifacts atau Azure DevOps Server.
Langkah ini powershell
menjalankan skrip menggunakan Windows PowerShell (di Windows) atau pwsh
(Linux dan macOS).
Kata publish
kunci menerbitkan (mengunggah) file atau folder sebagai artefak alur yang dapat dikonsumsi oleh pekerjaan dan alur lain.
Langkah ini pwsh
menjalankan skrip di PowerShell Core di Windows, macOS, dan Linux.
Langkah reviewApp
unduhan membuat sumber daya secara dinamis di bawah penyedia fase penyebaran.
Langkah ini script
menjalankan skrip menggunakan cmd.exe di Windows dan Bash pada platform lain.
Langkah task
menjalankan tugas.
Anda dapat menentukan sekumpulan langkah dalam satu file dan menggunakannya beberapa kali di file lain.
Tugas berjalan dalam konteks eksekusi, yang merupakan host agen atau kontainer.
Variabel yang dapat diatur oleh langkah.
Pemicu dorong menentukan cabang mana yang menyebabkan build integrasi berkelanjutan berjalan.
Tentukan variabel yang akan digunakan dalam alur Anda.
Variabel referensi dari grup variabel.
Tentukan variabel menggunakan sintaks penuh.
Anda dapat menentukan sekumpulan variabel dalam satu file dan menggunakannya beberapa kali di file lain.
Alur adalah satu atau lebih tahapan yang menggambarkan proses CI/CD.
Memperluas alur menggunakan templat.
Daftar pekerjaan menentukan pekerjaan yang membentuk pekerjaan tahapan.
Pekerjaan penyebaran adalah jenis pekerjaan khusus. Ini adalah kumpulan langkah-langkah untuk berjalan secara berurutan terhadap lingkungan.
Kata environment
kunci menentukan lingkungan atau sumber dayanya yang ditargetkan oleh pekerjaan penyebaran alur.
Strategi penyebaran memungkinkan Anda mengonfigurasi bagaimana pembaruan dikirimkan.
Strategi penyebaran kenari meluncurkan perubahan pada subset kecil server.
Penyebaran bergulir menggantikan instans versi aplikasi sebelumnya dengan instans versi baru aplikasi pada sekumpulan komputer virtual tetap (set bergulir) di setiap iterasi.
Strategi penyebaran runOnce meluncurkan perubahan dengan menjalankan masing-masing langkahnya satu kali.
Pekerjaan kontainer memungkinkan Anda menjalankan pekerjaan pada kontainer alih-alih host agen.
Kata matrix
kunci dan parallel
menentukan strategi yang saling eksklusif untuk menduplikasi pekerjaan.
Anda dapat menentukan sekumpulan pekerjaan dalam satu file dan menggunakannya beberapa kali di file lain. Lihat templat untuk informasi selengkapnya tentang bekerja dengan templat pekerjaan.
Daftar parameter menentukan parameter runtime yang diteruskan ke alur.
Parameter mewakili nilai yang diteruskan ke alur.
Kata pool
kunci menentukan kumpulan mana yang akan digunakan untuk pekerjaan alur.
pool
Spesifikasi juga menyimpan informasi tentang strategi pekerjaan untuk berjalan.
Pemicu permintaan pull menentukan cabang mana yang menyebabkan build permintaan pull berjalan.
Sumber daya menentukan build, repositori, alur, dan sumber daya lain yang digunakan oleh alur.
Daftar sumber daya build yang dirujuk oleh alur.
Jika Anda memiliki sistem build CI eksternal yang menghasilkan artefak, Anda dapat menggunakan artefak dengan sumber daya build.
Daftar sumber daya kontainer yang dirujuk oleh alur.
Sumber daya kontainer mereferensikan gambar kontainer.
Daftar sumber daya paket yang dirujuk oleh alur.
Anda dapat menggunakan paket NuGet dan npm GitHub sebagai sumber daya dalam alur YAML. Saat menentukan sumber daya paket, atur paket sebagai NuGet
atau npm
.
Daftar sumber daya alur yang dirujuk oleh alur.
Jika Anda memiliki Azure Pipeline yang menghasilkan artefak, alur Anda dapat menggunakan artefak dengan menentukan sumber daya alur. Pada Azure DevOps Server 2020 dan yang lebih tinggi, Anda juga dapat mengaktifkan pemicu penyelesaian alur menggunakan sumber daya alur.
Daftar sumber daya repositori yang direferensikan oleh alur.
Kata repository
kunci memungkinkan Anda menentukan repositori eksternal.
Daftar sumber daya webhook yang direferensikan oleh alur.
Sumber daya webhook memungkinkan Anda mengintegrasikan alur Dengan layanan eksternal untuk mengotomatiskan alur kerja.
Filter yang digunakan untuk menyesuaikan pemicu untuk peristiwa webhook.
Filter webhook digunakan untuk menyesuaikan pemicu untuk peristiwa webhook.
Daftar jadwal menentukan pemicu terjadwal untuk alur.
Pemicu terjadwal menentukan jadwal di mana cabang dibangun.
Tahapan adalah kumpulan pekerjaan terkait.
Tahapan adalah kumpulan pekerjaan terkait. Secara default, tahapan berjalan secara berurutan. Setiap tahap dimulai hanya setelah tahap sebelumnya selesai kecuali ditentukan lain melalui dependsOn
properti .
Anda dapat menentukan sekumpulan tahapan dalam satu file dan menggunakannya beberapa kali di file lain.
Langkah-langkah adalah urutan operasi linier yang membentuk pekerjaan.
Langkah ini bash
menjalankan skrip di Bash di Windows, macOS, dan Linux.
Gunakan checkout
untuk mengonfigurasi cara alur memeriksa kode sumber.
Langkah ini download
mengunduh artefak yang terkait dengan eksekusi saat ini atau dari Alur Azure lain yang terkait sebagai sumber daya alur.
Langkah ini downloadBuild
mengunduh artefak build.
Langkah ini getPackage
mengunduh paket dari umpan manajemen paket di Azure Artifacts atau Azure DevOps Server.
Langkah ini powershell
menjalankan skrip menggunakan Windows PowerShell (di Windows) atau pwsh
(Linux dan macOS).
Kata publish
kunci menerbitkan (mengunggah) file atau folder sebagai artefak alur yang dapat dikonsumsi pekerjaan dan alur lain.
Langkah ini pwsh
menjalankan skrip di PowerShell Core di Windows, macOS, dan Linux.
Langkah reviewApp
mengunduh membuat sumber daya secara dinamis di bawah penyedia fase penyebaran.
Langkah ini script
menjalankan skrip menggunakan cmd.exe di Windows dan Bash pada platform lain.
Langkah task
menjalankan tugas.
Anda dapat menentukan sekumpulan langkah dalam satu file dan menggunakannya beberapa kali di file lain.
Tugas berjalan dalam konteks eksekusi, yang merupakan host agen atau kontainer.
Variabel yang dapat diatur oleh langkah.
Pemicu dorong menentukan cabang mana yang menyebabkan build integrasi berkelanjutan berjalan.
Tentukan variabel yang akan digunakan dalam alur Anda.
Variabel referensi dari grup variabel.
Tentukan variabel menggunakan sintaks penuh.
Anda dapat menentukan sekumpulan variabel dalam satu file dan menggunakannya beberapa kali di file lain.
Konvensi dokumentasi skema YAML
Referensi skema YAML adalah panduan referensi terperinci untuk alur YAML Azure Pipelines. Ini termasuk katalog semua kemampuan YAML yang didukung dan opsi yang tersedia.
Berikut adalah konvensi sintaksis yang digunakan dalam referensi skema YAML.
- Di sebelah kiri
:
adalah kata kunci harfiah yang digunakan dalam definisi alur. - Di sebelah kanan
:
adalah jenis data. Jenis data dapat menjadi jenis primitif seperti string atau referensi ke struktur kaya yang ditentukan di tempat lain dalam referensi ini. - Jenis data
]
notasi[
menunjukkan array dari jenis definisi yang disebutkan. Misalnya,[ string ]
adalah array string. - Jenisdata
}
jenis data:
notasi{
menunjukkan pemetaan satu jenis data ke jenis data lainnya. Misalnya,{ string: string }
adalah pemetaan string ke string. - Simbol
|
menunjukkan ada beberapa jenis data yang tersedia untuk kata kunci. Misalnya,job | template
berarti definisi kerja atau referensi templat diizinkan.
Lihat juga
Referensi ini mencakup skema file YAML Azure Pipelines.
Untuk mempelajari dasar-dasar YAML, lihat Pelajari YAML dalam Y Minutes.
Azure Pipelines tidak mendukung semua fitur YAML.
Fitur yang tidak didukung termasuk jangkar, kunci kompleks, dan set.
Selain itu, tidak seperti YAML standar, Azure Pipelines bergantung pada melihat stage
, , task
job
, atau pintasan tugas seperti script
sebagai kunci pertama dalam pemetaan.