az pipelines

  • Referensi

Catatan

Referensi ini adalah bagian dari ekstensi azure-devops untuk Azure CLI (versi 2.30.0 atau yang lebih tinggi). Ekstensi akan secara otomatis menginstal pertama kali Anda menjalankan perintah alur az. Pelajari lebih lanjut tentang ekstensi.

Mengelola Azure Pipelines.

Grup perintah ini adalah bagian dari ekstensi azure-devops.

Perintah

Nama Deskripsi Jenis Status
az pipelines agent

Mengelola agen.

 Ekstensi GA
az pipelines agent list

Dapatkan daftar agen di kumpulan.

 Ekstensi GA
az pipelines agent show

Tampilkan detail agen.

 Ekstensi GA
az pipelines build

Mengelola build.

 Ekstensi GA
az pipelines build cancel

Membatalkan jika build sedang berjalan.

 Ekstensi GA
az pipelines build definition

Mengelola definisi build.

 Ekstensi GA
az pipelines build definition list

Mencantumkan definisi build.

 Ekstensi GA
az pipelines build definition show

Dapatkan detail definisi build.

 Ekstensi GA
az pipelines build list

Mencantumkan hasil build.

 Ekstensi GA
az pipelines build queue

Meminta (antrean) build.

 Ekstensi GA
az pipelines build show

Dapatkan detail build.

 Ekstensi GA
az pipelines build tag

Mengelola tag build.

 Ekstensi GA
az pipelines build tag add

Tambahkan tag untuk build.

 Ekstensi GA
az pipelines build tag delete

Menghapus tag build.

 Ekstensi GA
az pipelines build tag list

Mendapatkan tag untuk build.

 Ekstensi GA
az pipelines create

Buat Azure Pipeline baru (berbasis YAML).

 Ekstensi GA
az pipelines delete

Menghapus alur.

 Ekstensi GA
az pipelines folder

Mengelola folder untuk mengatur alur.

 Ekstensi GA
az pipelines folder create

Buat folder.

 Ekstensi GA
az pipelines folder delete

Menghapus folder.

 Ekstensi GA
az pipelines folder list

Mencantumkan semua folder.

 Ekstensi GA
az pipelines folder update

Perbarui nama atau deskripsi folder.

 Ekstensi GA
az pipelines list

Mencantumkan alur.

 Ekstensi GA
az pipelines pool

Mengelola kumpulan agen.

 Ekstensi GA
az pipelines pool list

Mencantumkan kumpulan agen.

 Ekstensi GA
az pipelines pool show

Tampilkan detail kumpulan agen.

 Ekstensi GA
az pipelines queue

Mengelola antrean agen.

 Ekstensi GA
az pipelines queue list

Mencantumkan antrean agen.

 Ekstensi GA
az pipelines queue show

Tampilkan detail antrean agen.

 Ekstensi GA
az pipelines release

Mengelola rilis.

 Ekstensi GA
az pipelines release create

Meminta (membuat) rilis.

 Ekstensi GA
az pipelines release definition

Mengelola definisi rilis.

 Ekstensi GA
az pipelines release definition list

Mencantumkan definisi rilis.

 Ekstensi GA
az pipelines release definition show

Dapatkan detail definisi rilis.

 Ekstensi GA
az pipelines release list

Mencantumkan hasil rilis.

 Ekstensi GA
az pipelines release show

Dapatkan detail rilis.

 Ekstensi GA
az pipelines run

Antrean (jalankan) alur.

 Ekstensi GA
az pipelines runs

Mengelola eksekusi alur.

 Ekstensi GA
az pipelines runs artifact

Mengelola artefak eksekusi alur.

 Ekstensi GA
az pipelines runs artifact download

Unduh artefak alur.

 Ekstensi GA
az pipelines runs artifact list

Mencantumkan artefak yang terkait dengan eksekusi.

 Ekstensi GA
az pipelines runs artifact upload

Unggah artefak alur.

 Ekstensi GA
az pipelines runs list

Mencantumkan eksekusi alur dalam proyek.

 Ekstensi GA
az pipelines runs show

Tampilkan detail eksekusi alur.

 Ekstensi GA
az pipelines runs tag

Mengelola tag eksekusi alur.

 Ekstensi GA
az pipelines runs tag add

Tambahkan tag untuk eksekusi alur.

 Ekstensi GA
az pipelines runs tag delete

Menghapus tag eksekusi alur.

 Ekstensi GA
az pipelines runs tag list

Mendapatkan tag untuk eksekusi alur.

 Ekstensi GA
az pipelines show

Dapatkan detail alur.

 Ekstensi GA
az pipelines update

Memperbarui alur.

 Ekstensi GA
az pipelines variable

Mengelola variabel alur.

 Ekstensi GA
az pipelines variable-group

Mengelola grup variabel.

 Ekstensi GA
az pipelines variable-group create

Buat grup variabel.

 Ekstensi GA
az pipelines variable-group delete

Menghapus grup variabel.

 Ekstensi GA
az pipelines variable-group list

Mencantumkan grup variabel.

 Ekstensi GA
az pipelines variable-group show

Tampilkan detail grup variabel.

 Ekstensi GA
az pipelines variable-group update

Memperbarui grup variabel.

 Ekstensi GA
az pipelines variable-group variable

Mengelola variabel dalam grup variabel.

 Ekstensi GA
az pipelines variable-group variable create

Tambahkan variabel ke grup variabel.

 Ekstensi GA
az pipelines variable-group variable delete

Menghapus variabel dari grup variabel.

 Ekstensi GA
az pipelines variable-group variable list

Mencantumkan variabel dalam grup variabel.

 Ekstensi GA
az pipelines variable-group variable update

Perbarui variabel dalam grup variabel.

 Ekstensi GA
az pipelines variable create

Tambahkan variabel ke alur.

 Ekstensi GA
az pipelines variable delete

Menghapus variabel dari alur.

 Ekstensi GA
az pipelines variable list

Mencantumkan variabel dalam alur.

 Ekstensi GA
az pipelines variable update

Memperbarui variabel dalam alur.

 Ekstensi GA

az pipelines create

Buat Azure Pipeline baru (berbasis YAML).

az pipelines create --name
                    [--branch]
                    [--description]
                    [--detect {false, true}]
                    [--folder-path]
                    [--org]
                    [--project]
                    [--queue-id]
                    [--repository]
                    [--repository-type {github, tfsgit}]
                    [--service-connection]
                    [--skip-first-run {false, true}]
                    [--yaml-path]

Contoh

Membuat Azure Pipeline dari konteks repositori checkout lokal

Repository name/url (--repository), type (--repository-type) and branch name (--branch) will be detected from the local git repository
az pipelines create --name 'ContosoBuild' --description 'Pipeline for contoso project'

Membuat Azure Pipeline untuk repositori yang dihosting di Github menggunakan url kloning

az pipelines create --name 'ContosoBuild' --description 'Pipeline for contoso project'
--repository https://github.com/SampleOrg/SampleRepo --branch master

Membuat Azure Pipeline untuk repositori yang dihosting di organisasi Github SampleOrg, nama repositori SampleRepo

az pipelines create --name 'ContosoBuild' --description 'Pipeline for contoso project'
--repository SampleOrg/SampleRepoName --branch master --repository-type github

Membuat Azure Pipeline untuk repositori yang dihosting di Azure Repo dalam proyek yang sama

az pipelines create --name 'ContosoBuild' --description 'Pipeline for contoso project'
--repository SampleRepoName --branch master --repository-type tfsgit

Membuat Azure Pipeline untuk repositori dengan yaml alur yang sudah diperiksa ke repositori

Service connection required for non Azure Repos can be optionally provided in the command to run it non interatively
az pipelines create --name 'ContosoBuild' --description 'Pipeline for contoso project'
--repository https://github.com/SampleOrg/SampleRepo --branch master --yml-path azure-pipelines.yml [--service-connection SERVICE_CONNECTION]

Parameter yang Diperlukan

--name

Nama alur baru.

Parameter Opsional

--branch

Nama cabang tempat alur akan dikonfigurasi. Jika dihilangkan, repositori lokal akan terdeteksi secara otomatis.

--description

Deskripsi untuk alur baru.

--detect

Mendeteksi organisasi secara otomatis.

nilai yang diterima: false, true
--folder-path

Jalur folder tempat alur perlu dibuat. Defaultnya adalah folder akar. misalnya, "user1/test_pipelines".

--org --organization

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 melalui konfigurasi git. Contoh: https://dev.azure.com/MyOrganizationName/.

--project -p

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 melalui konfigurasi git.

--queue-id

Id antrean di kumpulan agen yang tersedia. Akan terdeteksi secara otomatis jika tidak ditentukan.

--repository

Repositori yang alurnya perlu dikonfigurasi. Dapat berupa url kloning repositori git atau nama repositori untuk Azure Repos atau Owner/RepoName jika terjadi repositori GitHub. Jika dihilangkan, itu akan terdeteksi secara otomatis dari url jarak jauh repositori git lokal. Jika nama disebutkan alih-alih url, argumen --repository-type juga diperlukan.

--repository-type

Jenis repositori. Jika dihilangkan, itu akan terdeteksi secara otomatis dari url jarak jauh repositori lokal. 'tfsgit' untuk Azure Repos, 'github' untuk repositori GitHub.

nilai yang diterima: github, tfsgit
--service-connection

Id koneksi Layanan yang dibuat untuk repositori untuk repositori GitHub. Gunakan perintah az devops service-endpoint -h untuk membuat/mencantumkan service_connections. Tidak diperlukan untuk Azure Repos.

--skip-first-run --skip-run

Tentukan bendera ini untuk mencegah eksekusi pertama dipicu oleh perintah . Perintah akan mengembalikan alur jika eksekusi dilewati lagi, itu akan menghasilkan eksekusi alur.

nilai yang diterima: false, true
--yaml-path --yml-path

Jalur file yaml alur dalam repositori (jika yaml sudah ada di repositori).

Parameter Global
--debug

Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Menampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya menampilkan kesalahan, menyembunyikan peringatan.

--output -o

Format output.

nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.

az pipelines delete

Menghapus alur.

az pipelines delete --id
                    [--detect {false, true}]
                    [--org]
                    [--project]
                    [--yes]

Parameter yang Diperlukan

--id

ID alur.

Parameter Opsional

--detect

Mendeteksi organisasi secara otomatis.

nilai yang diterima: false, true
--org --organization

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 melalui konfigurasi git. Contoh: https://dev.azure.com/MyOrganizationName/.

--project -p

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 melalui konfigurasi git.

--yes -y

Jangan meminta konfirmasi.

nilai default: False
Parameter Global
--debug

Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Menampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya menampilkan kesalahan, menyembunyikan peringatan.

--output -o

Format output.

nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.

az pipelines list

Mencantumkan alur.

az pipelines list [--detect {false, true}]
                  [--folder-path]
                  [--name]
                  [--org]
                  [--project]
                  [--query-order {ModifiedAsc, ModifiedDesc, NameAsc, NameDesc, None}]
                  [--repository]
                  [--repository-type {bitbucket, git, github, githubenterprise, svn, tfsgit, tfsversioncontrol}]
                  [--top]

Parameter Opsional

--detect

Mendeteksi organisasi secara otomatis.

nilai yang diterima: false, true
--folder-path

Jika ditentukan, filter ke definisi di bawah folder ini.

--name

Batasi hasil ke alur dengan nama ini atau dimulai dengan nama ini. Contoh: "FabCI" atau "Fab*".

--org --organization

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 melalui konfigurasi git. Contoh: https://dev.azure.com/MyOrganizationName/.

--project -p

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 melalui konfigurasi git.

--query-order

Urutan hasilnya.

nilai yang diterima: ModifiedAsc, ModifiedDesc, NameAsc, NameDesc, None
--repository

Batasi hasil untuk alur yang terkait dengan repositori ini.

--repository-type

Batasi hasil ke alur yang terkait dengan jenis repositori ini. Anda harus meneruskan argumen 'repositori' bersama dengan argumen ini.

nilai yang diterima: bitbucket, git, github, githubenterprise, svn, tfsgit, tfsversioncontrol
--top

Jumlah maksimum alur yang akan dicantumkan.

Parameter Global
--debug

Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Menampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya menampilkan kesalahan, menyembunyikan peringatan.

--output -o

Format output.

nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.

az pipelines run

Antrean (jalankan) alur.

az pipelines run [--branch]
                 [--commit-id]
                 [--detect {false, true}]
                 [--folder-path]
                 [--id]
                 [--name]
                 [--open]
                 [--org]
                 [--parameters]
                 [--project]
                 [--variables]

Parameter Opsional

--branch

Nama cabang tempat eksekusi alur akan diantrekan. Contoh: refs/heads/master atau master atau refs/pull/1/merge atau refs/tags/tag.

--commit-id

Commit-id tempat eksekusi alur akan diantrekan.

--detect

Mendeteksi organisasi secara otomatis.

nilai yang diterima: false, true
--folder-path

Jalur folder alur. Defaultnya adalah folder tingkat akar.

--id

ID alur ke antrean. Diperlukan jika --name tidak disediakan.

--name

Nama alur ke antrean. Diabaikan jika --id disediakan.

--open

Buka halaman hasil alur di browser web Anda.

nilai default: False
--org --organization

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 melalui konfigurasi git. Contoh: https://dev.azure.com/MyOrganizationName/.

--parameters

Spasi memisahkan pasangan "name=value" untuk parameter yang ingin Anda atur.

--project -p

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 melalui konfigurasi git.

--variables

Spasi dipisahkan pasangan "name=value" untuk variabel yang ingin Anda atur.

Parameter Global
--debug

Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Menampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya menampilkan kesalahan, menyembunyikan peringatan.

--output -o

Format output.

nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.

az pipelines show

Dapatkan detail alur.

az pipelines show [--detect {false, true}]
                  [--folder-path]
                  [--id]
                  [--name]
                  [--open]
                  [--org]
                  [--project]

Parameter Opsional

--detect

Mendeteksi organisasi secara otomatis.

nilai yang diterima: false, true
--folder-path

Jalur folder alur. Defaultnya adalah folder tingkat akar.

--id

ID alur.

--name

Nama alur. Diabaikan jika --id disediakan.

--open

Buka halaman ringkasan alur di browser web Anda.

nilai default: False
--org --organization

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 melalui konfigurasi git. Contoh: https://dev.azure.com/MyOrganizationName/.

--project -p

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 melalui konfigurasi git.

Parameter Global
--debug

Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Menampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya menampilkan kesalahan, menyembunyikan peringatan.

--output -o

Format output.

nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.

az pipelines update

Memperbarui alur.

az pipelines update --id
                    [--branch]
                    [--description]
                    [--detect {false, true}]
                    [--new-folder-path]
                    [--new-name]
                    [--org]
                    [--project]
                    [--queue-id]
                    [--yaml-path]

Parameter yang Diperlukan

--id

Id alur yang akan diperbarui.

Parameter Opsional

--branch

Nama cabang tempat alur akan dikonfigurasi.

--description

Deskripsi baru untuk alur.

--detect

Mendeteksi organisasi secara otomatis.

nilai yang diterima: false, true
--new-folder-path

Jalur lengkap baru folder untuk memindahkan alur ke. misalnya, "user1/production_pipelines".

--new-name

Nama baru yang diperbarui dari alur.

--org --organization

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 melalui konfigurasi git. Contoh: https://dev.azure.com/MyOrganizationName/.

--project -p

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 melalui konfigurasi git.

--queue-id

Id antrean kumpulan agen tempat alur perlu dijalankan.

--yaml-path --yml-path

Jalur file yaml alur dalam repositori.

Parameter Global
--debug

Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Menampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya menampilkan kesalahan, menyembunyikan peringatan.

--output -o

Format output.

nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.