definisi alur

Alur adalah satu atau lebih tahapan yang menggambarkan proses CI/CD.

Implementasi

Penerapan	Deskripsi
alur: tahapan	Alur dengan tahapan.
alur: memperluas	Alur yang memperluas templat.
alur: pekerjaan	Alur dengan pekerjaan dan satu tahap implisit.
alur: langkah-langkah	Alur dengan langkah-langkah dan satu pekerjaan implisit.

Keterangan

Alur adalah satu atau lebih tahapan yang menggambarkan proses CI/CD. Tahapan adalah pembagian utama dalam alur. Tahapan "Bangun aplikasi ini", "Jalankan pengujian ini", dan "Sebarkan ke praproduksi" adalah contoh yang baik.

Tahapan adalah satu atau lebih pekerjaan, yang merupakan unit pekerjaan yang dapat ditugaskan ke komputer yang sama. Anda dapat mengatur tahapan dan pekerjaan ke dalam grafik dependensi. Contohnya termasuk "Jalankan tahapan ini sebelum tahapan itu" dan "Pekerjaan ini bergantung pada output pekerjaan itu."

Pekerjaan adalah serangkaian langkah linier. Langkah dapat berupa tugas, skrip, atau referensi ke templat eksternal.

Hierarki ini tercermin dalam struktur file YAML seperti:

- Pipeline
  - Stage A
    - Job 1
      - Step 1.1
      - Step 1.2
      - ...
    - Job 2
      - Step 2.1
      - Step 2.2
      - ...
  - Stage B
    - ...

Alur sederhana tidak memerlukan semua tingkat ini. Misalnya, dalam build satu pekerjaan, Anda dapat menghilangkan kontainer untuk tahapan dan pekerjaan karena hanya ada langkah-langkah. Dan karena banyak opsi yang ditampilkan dalam artikel ini tidak diperlukan dan memiliki default yang baik, definisi YAML Anda tidak mungkin menyertakan semuanya.

Jika Anda memiliki satu tahap, Anda dapat menghilangkan stages kata kunci dan secara langsung menentukan kata kunci pekerjaan :

# ... other pipeline-level keywords
jobs: [ job | template ]

Jika Anda memiliki satu tahap dan satu pekerjaan, Anda dapat menghilangkan stages kata kunci dan jobs dan secara langsung menentukan kata kunci langkah-langkah :

# ... other pipeline-level keywords
steps: [ script | bash | pwsh | powershell | checkout | task | template | ... ]

name Gunakan properti untuk mengonfigurasi nomor eksekusi alur. Untuk informasi selengkapnya, lihat Mengonfigurasi nomor eksekusi atau build.

alur: tahapan

Alur dengan tahapan.

stages: [ stage | template ] # Required. Stages are groups of jobs that can run without human intervention.
pool: string | pool # Pool where jobs in this pipeline will run unless otherwise specified.
name: string # Pipeline run number.
appendCommitMessageToRunName: boolean # Append the commit message to the build number. The default is true.
trigger: none | trigger | [ string ] # Continuous integration triggers.
parameters: [ parameter ] # Pipeline template parameters.
pr: none | pr | [ string ] # Pull request triggers.
schedules: [ cron ] # Scheduled triggers.
resources: # Containers and repositories used in the build.
  builds: [ build ] # List of build resources referenced by the pipeline.
  containers: [ container ] # List of container images.
  pipelines: [ pipeline ] # List of pipeline resources.
  repositories: [ repository ] # List of repository resources.
  webhooks: [ webhook ] # List of webhooks.
  packages: [ package ] # List of package resources.
variables: variables | [ variable ] # Variables for this pipeline.
lockBehavior: string # Behavior lock requests from this stage should exhibit in relation to other exclusive lock requests.

Properti

stagestahapan. Wajib diisi.
Tahapan adalah kelompok pekerjaan yang dapat berjalan tanpa campur tangan manusia.

poolkolam renang.
Kumpulan tempat pekerjaan dalam alur ini akan berjalan kecuali ditentukan lain.

name String.
Nomor eksekusi alur.

appendCommitMessageToRunNameboolean.
Tambahkan pesan penerapan ke nomor build. Secara default adalah benar.

triggerpemicu.
Pemicu integrasi berkelanjutan.

parametersparameter.
Parameter templat alur.

prpr.
Pemicu permintaan pull.

schedulesjadwal.
Pemicu terjadwal.

resourcessumber daya.
Kontainer dan repositori yang digunakan dalam build.

variablesvariabel.
Variabel untuk alur ini.

lockBehavior String.
Permintaan kunci perilaku dari tahap ini harus dipamerkan sehubungan dengan permintaan kunci eksklusif lainnya. berurutan | runLatest.

Contoh

trigger:
- main

pool: 
  vmImage: ubuntu-latest

stages:
- stage: CI
  jobs:
  - job: CIWork
    steps:
    - script: "Do CI work"

- stage: Test
  jobs:
  - job: TestWork
    steps:
    - script: "Do test work"

alur: memperluas

Alur yang memperluas templat.

extends: # Required. Extends a template.
  template: string # The template referenced by the pipeline to extend.
  parameters: # Parameters used in the extend.
pool: string | pool # Pool where jobs in this pipeline will run unless otherwise specified.
name: string # Pipeline run number.
appendCommitMessageToRunName: boolean # Append the commit message to the build number. The default is true.
trigger: none | trigger | [ string ] # Continuous integration triggers.
parameters: [ parameter ] # Pipeline template parameters.
pr: none | pr | [ string ] # Pull request triggers.
schedules: [ cron ] # Scheduled triggers.
resources: # Containers and repositories used in the build.
  builds: [ build ] # List of build resources referenced by the pipeline.
  containers: [ container ] # List of container images.
  pipelines: [ pipeline ] # List of pipeline resources.
  repositories: [ repository ] # List of repository resources.
  webhooks: [ webhook ] # List of webhooks.
  packages: [ package ] # List of package resources.
variables: variables | [ variable ] # Variables for this pipeline.
lockBehavior: string # Behavior lock requests from this stage should exhibit in relation to other exclusive lock requests.

Properti

extendsmeluas. Wajib diisi.
Memperluas templat.

poolkolam renang.
Kumpulan tempat pekerjaan dalam alur ini akan berjalan kecuali ditentukan lain.

name String.
Nomor eksekusi alur.

appendCommitMessageToRunNameboolean.
Tambahkan pesan penerapan ke nomor build. Secara default adalah benar.

triggerpemicu.
Pemicu integrasi berkelanjutan.

parametersparameter.
Parameter templat alur.

prpr.
Pemicu permintaan pull.

schedulesjadwal.
Pemicu terjadwal.

resourcessumber daya.
Kontainer dan repositori yang digunakan dalam build.

variablesvariabel.
Variabel untuk alur ini.

lockBehavior String.
Permintaan kunci perilaku dari tahap ini harus dipamerkan sehubungan dengan permintaan kunci eksklusif lainnya. berurutan | runLatest.

alur: pekerjaan

Alur dengan pekerjaan dan satu tahap implisit.

jobs: [ job | deployment | template ] # Required. Jobs represent units of work which can be assigned to a single agent or server.
pool: string | pool # Pool where jobs in this pipeline will run unless otherwise specified.
name: string # Pipeline run number.
appendCommitMessageToRunName: boolean # Append the commit message to the build number. The default is true.
trigger: none | trigger | [ string ] # Continuous integration triggers.
parameters: [ parameter ] # Pipeline template parameters.
pr: none | pr | [ string ] # Pull request triggers.
schedules: [ cron ] # Scheduled triggers.
resources: # Containers and repositories used in the build.
  builds: [ build ] # List of build resources referenced by the pipeline.
  containers: [ container ] # List of container images.
  pipelines: [ pipeline ] # List of pipeline resources.
  repositories: [ repository ] # List of repository resources.
  webhooks: [ webhook ] # List of webhooks.
  packages: [ package ] # List of package resources.
variables: variables | [ variable ] # Variables for this pipeline.
lockBehavior: string # Behavior lock requests from this stage should exhibit in relation to other exclusive lock requests.

Properti

jobspekerjaan. Wajib diisi.
Pekerjaan mewakili unit kerja yang dapat ditetapkan ke satu agen atau server.

poolkolam renang.
Kumpulan tempat pekerjaan dalam alur ini akan berjalan kecuali ditentukan lain.

name String.
Nomor eksekusi alur.

appendCommitMessageToRunNameboolean.
Tambahkan pesan penerapan ke nomor build. Secara default adalah benar.

triggerpemicu.
Pemicu integrasi berkelanjutan.

parametersparameter.
Parameter templat alur.

prpr.
Pemicu permintaan pull.

schedulesjadwal.
Pemicu terjadwal.

resourcessumber daya.
Kontainer dan repositori yang digunakan dalam build.

variablesvariabel.
Variabel untuk alur ini.

lockBehavior String.
Permintaan kunci perilaku dari tahap ini harus dipamerkan sehubungan dengan permintaan kunci eksklusif lainnya. berurutan | runLatest.

Contoh

trigger:
- main

pool: 
  vmImage: ubuntu-latest

jobs:
- job: PreWork
  steps:
  - script: "Do pre-work"

- job: PostWork
  pool: windows-latest
  steps:
  - script: "Do post-work using a different hosted image"

alur: langkah-langkah

Alur dengan langkah-langkah dan satu pekerjaan implisit.

steps: [ task | script | powershell | pwsh | bash | checkout | download | downloadBuild | getPackage | publish | template | reviewApp ] # Required. A list of steps to run in this job.
strategy: strategy # Execution strategy for this job.
continueOnError: string # Continue running even on failure?
pool: string | pool # Pool where jobs in this pipeline will run unless otherwise specified.
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.
name: string # Pipeline run number.
appendCommitMessageToRunName: boolean # Append the commit message to the build number. The default is true.
trigger: none | trigger | [ string ] # Continuous integration triggers.
parameters: [ parameter ] # Pipeline template parameters.
pr: none | pr | [ string ] # Pull request triggers.
schedules: [ cron ] # Scheduled triggers.
resources: # Containers and repositories used in the build.
  builds: [ build ] # List of build resources referenced by the pipeline.
  containers: [ container ] # List of container images.
  pipelines: [ pipeline ] # List of pipeline resources.
  repositories: [ repository ] # List of repository resources.
  webhooks: [ webhook ] # List of webhooks.
  packages: [ package ] # List of package resources.
variables: variables | [ variable ] # Variables for this pipeline.
lockBehavior: string # Behavior lock requests from this stage should exhibit in relation to other exclusive lock requests.

Properti

stepslangkah-langkah. Wajib diisi.
Daftar langkah-langkah untuk dijalankan dalam pekerjaan ini.

strategyjobs.job.strategy.
Strategi eksekusi untuk pekerjaan ini.

continueOnError String.
Terus berjalan bahkan pada kegagalan?

poolkolam renang.
Kumpulan tempat pekerjaan dalam alur ini akan berjalan kecuali ditentukan lain.

containerjobs.job.container.
Nama sumber daya kontainer.

services kamus string.
Sumber daya kontainer untuk dijalankan sebagai kontainer layanan.

workspaceruang kerja.
Opsi ruang kerja pada agen.

name String.
Nomor eksekusi alur.

appendCommitMessageToRunNameboolean.
Tambahkan pesan penerapan ke nomor build. Secara default adalah benar.

triggerpemicu.
Pemicu integrasi berkelanjutan.

parametersparameter.
Parameter templat alur.

prpr.
Pemicu permintaan pull.

schedulesjadwal.
Pemicu terjadwal.

resourcessumber daya.
Kontainer dan repositori yang digunakan dalam build.

variablesvariabel.
Variabel untuk alur ini.

lockBehavior String.
Permintaan kunci perilaku dari tahap ini harus dipamerkan sehubungan dengan permintaan kunci eksklusif lainnya. berurutan | runLatest.

Contoh

trigger:
- main

pool: 
  vmImage: ubuntu-latest

steps:
- script: "Hello world!"

Lihat juga

• Alur dengan beberapa pekerjaan
• Pemicu
• Variabel
• Format nomor build