Share via

Mengelola alur Anda dengan Azure CLI

  • Artikel

Layanan Azure DevOps | Azure DevOps Server 2022 | Azure DevOps Server 2020

Anda dapat mengelola alur di organisasi Anda menggunakan perintah ini az pipelines :

Perintah ini memerlukan nama atau ID alur yang ingin Anda kelola. Anda bisa mendapatkan ID alur menggunakan perintah az pipelines list .

Untuk memulai, lihat Mulai menggunakan Azure DevOps CLI.

Menjalankan alur

Anda dapat mengantre (menjalankan) alur yang ada dengan perintah az pipelines run .

az pipelines run [--branch]
                 [--commit-id]
                 [--folder-path]
                 [--id]
                 [--name]
                 [--open]
                 [--org]
                 [--project]
                 [--variables]

Parameter

  • cabang: Nama cabang tempat eksekusi alur akan diantrekan, misalnya, refs/heads/main.
  • commit-id: Commit-id tempat eksekusi alur akan diantrekan.
  • folder-path: Jalur folder alur. Defaultnya adalah folder tingkat akar.
  • id: Diperlukan jika nama tidak disediakan. ID alur ke antrean.
  • nama: Diperlukan jika ID tidak disediakan, tetapi diabaikan jika ID disediakan. Nama alur yang akan diantrekan.
  • buka: Buka halaman hasil alur di browser web Anda.
  • org: URL organisasi Azure DevOps. Anda dapat mengonfigurasi organisasi default menggunakan az devops configure -d organization=ORG_URL. Diperlukan jika tidak dikonfigurasi sebagai default atau diambil menggunakan git config. Contoh: --org https://dev.azure.com/MyOrganizationName/.
  • project: Nama atau ID proyek. Anda dapat mengonfigurasi proyek default menggunakan az devops configure -d project=NAME_OR_ID. Diperlukan jika tidak dikonfigurasi sebagai default atau diambil menggunakan git config.
  • variabel: Pasangan "name=value" yang dipisahkan spasi untuk variabel yang ingin Anda atur.

Contoh

Perintah berikut menjalankan alur bernama myGithubname.pipelines-java di alur cabang dan memperlihatkan hasilnya dalam format tabel.

az pipelines run --name myGithubname.pipelines-java --branch pipeline --output table

Run ID    Number      Status      Result    Pipeline ID    Pipeline Name                Source Branch    Queued Time               Reason
--------  ----------  ----------  --------  -------------  ---------------------------  ---------------  --------------------------  --------
123       20200123.2  notStarted            12             myGithubname.pipelines-java  pipeline           2020-01-23 11:55:56.633450  manual

Memperbarui alur

Anda dapat memperbarui alur yang ada dengan perintah az pipelines update . Untuk memulai, lihat Mulai menggunakan Azure DevOps CLI.

az pipelines update [--branch]
                    [--description]
                    [--id]
                    [--name]
                    [--new-folder-path]
                    [--new-name]
                    [--org]
                    [--project]
                    [--queue-id]
                    [--yaml-path]

Parameter

  • cabang: Nama cabang tempat eksekusi alur akan dikonfigurasi, misalnya, refs/heads/main.
  • description: Deskripsi baru untuk alur.
  • id: Diperlukan jika nama tidak disediakan. ID alur yang akan diperbarui.
  • nama: Diperlukan jika ID tidak disediakan. Nama alur yang akan diperbarui.
  • new-folder-path: Jalur lengkap baru folder tempat alur dipindahkan, misalnya, user1/production_pipelines.
  • new-name: Nama baru alur yang diperbarui.
  • org: URL organisasi Azure DevOps. Anda dapat mengonfigurasi organisasi default menggunakan az devops configure -d organization=ORG_URL. Diperlukan jika tidak dikonfigurasi sebagai default atau diambil menggunakan git config. Contoh: --org https://dev.azure.com/MyOrganizationName/.
  • project: Nama atau ID proyek. Anda dapat mengonfigurasi proyek default menggunakan az devops configure -d project=NAME_OR_ID. Diperlukan jika tidak dikonfigurasi sebagai default atau diambil menggunakan git config.
  • queue-id: ID antrean kumpulan agen tempat alur perlu dijalankan.
  • yaml-path: Jalur file yaml alur di repositori.

Parameter global termasuk debug, , helponly-show-errors, query, , outputdan verbose.

Tip

Ada juga parameter global yang dapat Anda gunakan seperti --output. Parameter --output tersedia untuk semua perintah. Nilai tabel menyajikan output dalam format yang bersahabat. Untuk informasi selengkapnya, lihat Format output untuk perintah Azure CLI.

Contoh

Perintah berikut memperbarui alur dengan ID 12 dengan nama dan deskripsi baru dan memperlihatkan hasilnya dalam format tabel.

az pipelines update --id 12 --description "rename pipeline" --new-name updatedname.pipelines-java --output table

ID    Name                        Status    Default Queue
----  --------------------------  --------  ------------------
12    updatedname.pipelines-java  enabled   Hosted Ubuntu 1604

Perlihatkan alur

Anda dapat melihat detail alur yang ada dengan perintah az pipelines show . Untuk memulai, lihat Mulai menggunakan Azure DevOps CLI.

az pipelines show [--folder-path]
                  [--id]
                  [--name]
                  [--open]
                  [--org]
                  [--project]
                  [--query-examples]
                  [--subscription]

Parameter

  • folder-path: Jalur folder alur. Defaultnya adalah folder tingkat akar.
  • id: Diperlukan jika nama tidak disediakan. ID alur untuk menampilkan detail.
  • nama: Diperlukan jika nama tidak disediakan, tetapi diabaikan jika ID disediakan. Nama alur untuk menampilkan detail.
  • buka: Buka halaman ringkasan alur di browser web Anda.
  • org: URL organisasi Azure DevOps. Anda dapat mengonfigurasi organisasi default menggunakan az devops configure -d organization=ORG_URL. Diperlukan jika tidak dikonfigurasi sebagai default atau diambil menggunakan git config. Contoh: --org https://dev.azure.com/MyOrganizationName/.
  • project: Nama atau ID proyek. Anda dapat mengonfigurasi proyek default menggunakan az devops configure -d project=NAME_OR_ID. Diperlukan jika tidak dikonfigurasi sebagai default atau diambil menggunakan git config.
  • contoh kueri: Merekomendasikan string JMESPath untuk Anda.
  • langganan: Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

Contoh

Perintah berikut menunjukkan detail alur dengan ID 12 dan mengembalikan hasil dalam format tabel.

az pipelines show --id 12 --output table

ID    Name                        Status    Default Queue
----  --------------------------  --------  ------------------
12    updatedname.pipelines-java  enabled   Hosted Ubuntu 1604

Langkah berikutnya

Anda dapat menyesuaikan alur atau mempelajari selengkapnya tentang mengonfigurasi alur dalam bahasa pilihan Anda:

FAQ

Bagaimana cara membuat alur build secara terprogram?

Referensi REST API: Membuat alur build

Catatan

Anda juga dapat mengelola build dan membangun alur dari baris perintah atau skrip menggunakan Azure Pipelines CLI.

Bisakah saya menjalankan beberapa alur di Azure DevOps Services menggunakan satu perintah?

Saat ini, Azure CLI dan Azure API tidak menawarkan perintah yang menjalankan beberapa alur dari baris perintah. Anda dapat menggunakan perintah Azure CLI untuk mencantumkan semua alur dan definisi dan menyediakan satu ID rilis atau build sebagai parameter. Semua perintah dirancang untuk bekerja untuk eksekusi independen alur independen, dan memerlukan permintaan ID unik yang hanya memungkinkan satu, nilai unik. Untuk mempelajari tentang pemicu alur, lihat Menentukan peristiwa yang memicu alur.