Bagikan melalui

az acr task

  • Referensi

Kelola kumpulan langkah-langkah untuk membangun, menguji, dan MENambal OS & Framework gambar kontainer menggunakan Azure Container Registries.

Perintah

Nama Deskripsi Jenis Status
az acr task cancel-run

Batalkan eksekusi Azure Container Registry yang ditentukan.

 Core GA
az acr task create

Buat serangkaian langkah untuk membangun, menguji, dan kontainer patching OS & Framework. Tugas mendukung pemicu dari penerapan git dan pembaruan gambar dasar.

 Core GA
az acr task credential

Mengelola kredensial untuk tugas. Lihat https://aka.ms/acr/tasks/cross-registry-authentication untuk mengetahui informasi selengkapnya.

 Core GA
az acr task credential add

Tambahkan kredensial masuk registri kustom ke tugas.

 Core GA
az acr task credential list

Cantumkan semua kredensial registri kustom untuk tugas.

 Core GA
az acr task credential remove

Menghapus kredensial untuk tugas.

 Core GA
az acr task credential update

Perbarui kredensial masuk registri untuk tugas.

 Core GA
az acr task delete

Menghapus tugas dari Azure Container Registry.

 Core GA
az acr task identity

Identitas Terkelola untuk Tugas. Lihat https://aka.ms/acr/tasks/task-create-managed-identity untuk mengetahui informasi selengkapnya.

 Core GA
az acr task identity assign

Perbarui identitas terkelola untuk tugas.

 Core GA
az acr task identity remove

Menghapus identitas terkelola untuk tugas.

 Core GA
az acr task identity show

Tampilkan identitas terkelola untuk tugas.

 Core GA
az acr task list

Mencantumkan tugas untuk Azure Container Registry.

 Core GA
az acr task list-runs

Cantumkan semua eksekusi yang dijalankan untuk Azure Container Registry, dengan kemampuan untuk memfilter menurut Tugas tertentu.

 Core GA
az acr task logs

Tampilkan log untuk eksekusi tertentu. Jika tidak ada run-id yang disediakan, tampilkan log untuk eksekusi terakhir yang dibuat.

 Core GA
az acr task run

Memicu tugas secara manual yang mungkin menunggu penerapan git atau pemicu pembaruan gambar dasar.

 Core GA
az acr task show

Dapatkan properti tugas bernama untuk Azure Container Registry.

 Core GA
az acr task show-run

Dapatkan properti dari eksekusi tugas Azure Container Registry yang ditentukan.

 Core GA
az acr task timer

Mengelola pemicu timer untuk tugas.

 Core GA
az acr task timer add

Tambahkan pemicu timer ke tugas.

 Core GA
az acr task timer list

Mencantumkan semua pemicu timer untuk tugas.

 Core GA
az acr task timer remove

Menghapus pemicu timer dari tugas.

 Core GA
az acr task timer update

Perbarui pemicu timer untuk tugas.

 Core GA
az acr task update

Perbarui tugas untuk Azure Container Registry.

 Core GA
az acr task update-run

Patch properti eksekusi Tugas Azure Container Registry.

 Core GA

az acr task cancel-run

Edit

Batalkan eksekusi Azure Container Registry yang ditentukan.

az acr task cancel-run --registry
                       --run-id
                       [--resource-group]

Contoh

Membatalkan eksekusi

az acr task cancel-run -r myregistry --run-id runId

Parameter yang Diperlukan

--registry -r

Nama registri kontainer. Ini harus ditentukan dalam huruf kecil. Anda dapat mengonfigurasi nama registri default menggunakan az configure --defaults acr=<registry name>.

--run-id

Pengidentifikasi eksekusi unik.

Parameter Opsional

--resource-group -g

Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

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 acr task create

Edit

Buat serangkaian langkah untuk membangun, menguji, dan kontainer patching OS & Framework. Tugas mendukung pemicu dari penerapan git dan pembaruan gambar dasar.

az acr task create --name
                   --registry
                   [--agent-pool]
                   [--arg]
                   [--assign-identity]
                   [--auth-mode {Default, None}]
                   [--base-image-trigger-enabled {false, true}]
                   [--base-image-trigger-name]
                   [--base-image-trigger-type {All, Runtime}]
                   [--cmd]
                   [--commit-trigger-enabled {false, true}]
                   [--context]
                   [--cpu]
                   [--file]
                   [--git-access-token]
                   [--image]
                   [--is-system-task]
                   [--log-template]
                   [--no-cache {false, true}]
                   [--no-push {false, true}]
                   [--platform]
                   [--pull-request-trigger-enabled {false, true}]
                   [--resource-group]
                   [--schedule]
                   [--secret-arg]
                   [--set]
                   [--set-secret]
                   [--source-trigger-name]
                   [--status {Disabled, Enabled}]
                   [--target]
                   [--timeout]
                   [--update-trigger-endpoint]
                   [--update-trigger-payload-type {Default, Token}]
                   [--values]

Contoh

Buat tugas tanpa lokasi sumber.

az acr task create -n hello-world -r myregistry --cmd '$Registry/myimage' -c /dev/null

Buat tugas dengan definisi dari input standar dan dengan pemicu timer yang menjalankan tugas di bagian atas setiap jam menggunakan nama pemicu default. Baik 'Ctrl + Z'(Windows) atau 'Ctrl + D'(Linux) mengakhiri aliran input.

cat task.yaml | az acr task create -n hello-world -r myregistry -f - -c /dev/null \
    --schedule "0 */1 * * *"
az acr task create -n hello-world -r myregistry -f - -c /dev/null --schedule "0 */1 * * *"

Buat tugas Linux dari repositori GitHub publik yang membangun gambar hello-world tanpa pemicu dan menggunakan argumen build.

az acr task create -t hello-world:{{.Run.ID}} -n hello-world -r myregistry \
    -c https://github.com/Azure/acr-builder.git -f Dockerfile \
    --commit-trigger-enabled false --base-image-trigger-enabled false \
    --arg DOCKER_CLI_BASE_IMAGE=docker:18.03.0-ce-git

Buat tugas Linux menggunakan cabang tertentu dari repositori Azure DevOps privat yang membangun gambar hello-world pada arsitektur Arm (varian V7) dan telah mengaktifkan pemicu.

az acr task create -t hello-world:{{.Run.ID}} -n hello-world -r myregistry \
    -c https://msazure.visualstudio.com/DefaultCollection/Project/_git/Repo#Branch:Folder \
    -f Dockerfile --git-access-token <Personal Access Token> --platform linux/arm/v7

Buat tugas Linux dari repositori GitHub publik yang membangun gambar hello-world dengan penerapan git dan pemicu permintaan pull diaktifkan. Perhatikan bahwa tugas ini tidak menggunakan Registri Sumber (myregistry), sehingga kami dapat secara eksplisit mengatur mode Auth sebagai Tidak Ada untuk itu.

az acr task create -t hello-world:{{.Run.ID}} -n hello-world -r myregistry  -f Dockerfile \
    --no-push true --auth-mode None -c https://github.com/Azure-Samples/acr-build-helloworld-node.git \
    --pull-request-trigger-enabled true --git-access-token 000000000000000000000000000000000

Buat tugas Windows dari repositori GitHub publik yang membangun gambar Azure Container Builder pada arsitektur Amd64 hanya dengan pemicu gambar dasar yang diaktifkan.

az acr task create -t acb:{{.Run.ID}} -n acb-win -r myregistry \
    -c https://github.com/Azure/acr-builder.git -f Windows.Dockerfile \
    --commit-trigger-enabled false --platform Windows/amd64

Buat tugas multi-langkah Linux dari repositori GitHub publik dengan identitas terkelola dan gambar dasar yang ditetapkan sistem dan ditetapkan pengguna, penerapan git, permintaan pull, dan pemicu timer yang menjalankan tugas pada siang hari pada hari Senin hingga Jumat dengan nama pemicu timer yang disediakan.

az acr task create -t hello-world:{{.Run.ID}} -n hello-world -r myregistry \
    --pull-request-trigger-enabled true --schedule "dailyTimer:0 12 * * Mon-Fri" \
    -c https://github.com/Azure-Samples/acr-tasks.git#:multipleRegistries -f testtask.yaml \
    --assign-identity [system] "/subscriptions/<subscriptionId>/resourcegroups/<myResourceGroup>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<myUserAssignedIdentitiy>"

Parameter yang Diperlukan

--name -n

Nama tugas.

--registry -r

Nama registri kontainer. Ini harus ditentukan dalam huruf kecil. Anda dapat mengonfigurasi nama registri default menggunakan az configure --defaults acr=<registry name>.

Parameter Opsional

--agent-pool
Pratinjau

Nama kumpulan agen.

--arg

Argumen build dalam format '--arg name[=value]'. Beberapa kali didukung dengan meneruskan '--arg name[=value]' beberapa kali. PENTING: Parameter ini tidak boleh menyertakan kata sandi, token akses, atau informasi sensitif dalam bentuk apa pun. Nilai parameter ini akan terlihat oleh tim ACR untuk tujuan penelusuran kesalahan.

--assign-identity

Menetapkan identitas terkelola ke tugas. Gunakan '[system]' untuk merujuk ke identitas yang ditetapkan sistem atau ID sumber daya untuk merujuk ke identitas yang ditetapkan pengguna. Lihat https://aka.ms/acr/tasks/task-create-managed-identity untuk mengetahui informasi selengkapnya.

--auth-mode

Mode autentikasi registri sumber.

Nilai yang diterima: Default, None
--base-image-trigger-enabled

Menunjukkan apakah pemicu gambar dasar diaktifkan.

Nilai yang diterima: false, true
Nilai default: True
--base-image-trigger-name

Nama pemicu gambar dasar.

Nilai default: defaultBaseimageTriggerName
--base-image-trigger-type

Jenis pemicu otomatis untuk pembaruan dependensi gambar dasar.

Nilai yang diterima: All, Runtime
Nilai default: Runtime
--cmd

Perintah untuk dijalankan. Ini juga mendukung parameter eksekusi docker tambahan (https://docs.docker.com/engine/reference/commandline/run/) atau bahkan perintah docker lainnya (https://docs.docker.com/engine/reference/commandline/docker/).

--commit-trigger-enabled

Menunjukkan apakah pemicu penerapan kontrol sumber diaktifkan.

Nilai yang diterima: false, true
Nilai default: True
--context -c

URL lengkap ke repositori kode sumber (Memerlukan akhiran '.git' untuk repositori github) atau tarball jarak jauh (misalnya, 'http://server/context.tar.gz'), atau repositori artefak OCI dalam registri kontainer Azure (misalnya, 'oci://myregistry.azurecr.io/myartifact:mytag'). Jika '/dev/null' ditentukan, nilai akan diatur ke Tidak Ada dan diabaikan. Ini adalah argumen yang diperlukan jika tugas bukan tugas sistem.

--cpu

Konfigurasi CPU dalam hal jumlah inti yang diperlukan untuk eksekusi.

Nilai default: 2
--file -f

Jalur relatif file tugas/docker ke folder akar kode sumber. File tugas harus diakhiri dengan '.yaml' atau disalurkan dari input standar menggunakan '-'.

--git-access-token

Token akses yang digunakan untuk mengakses penyedia kontrol sumber.

--image -t

Nama dan tag gambar menggunakan format: '-t repo/image:tag'. Beberapa tag didukung dengan meneruskan -t beberapa kali.

--is-system-task
Pratinjau

Menunjukkan apakah sumber daya tugas adalah tugas sistem. Nama tugas harus 'quicktask'. Hanya berlaku untuk registri yang diaktifkan CMK.

Nilai default: False
--log-template
Pratinjau

Templat repositori dan tag untuk menjalankan artefak log menggunakan format: 'log/repo:tag' (misalnya, 'acr/logs:{{.Run.ID}}'). Hanya berlaku untuk registri yang diaktifkan CMK.

--no-cache

Menunjukkan apakah cache gambar diaktifkan.

Nilai yang diterima: false, true
Nilai default: False
--no-push

Menunjukkan apakah gambar yang dibuat harus didorong ke registri.

Nilai yang diterima: false, true
Nilai default: False
--platform

Platform tempat build/task dijalankan, Misalnya, 'windows' dan 'linux'. Saat digunakan dalam perintah build, perintah tersebut juga dapat ditentukan dalam format 'os/arch/variant' untuk gambar yang dihasilkan. Misalnya, linux/arm/v7. Bagian 'arch' dan 'varian' bersifat opsional.

--pull-request-trigger-enabled

Menunjukkan apakah pemicu permintaan pull kontrol sumber diaktifkan. Pemicu dinonaktifkan secara default.

Nilai yang diterima: false, true
Nilai default: False
--resource-group -g

Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

--schedule

Jadwal untuk pemicu timer yang direpresentasikan sebagai ekspresi cron. Nama pemicu opsional dapat ditentukan menggunakan --schedule name:schedule format. Kelipatan didukung dengan meneruskan --jadwal beberapa kali.

--secret-arg

Argumen build rahasia dalam format '--secret-arg name[=value]'. Perkalian didukung dengan meneruskan '--secret-arg name[=value]' beberapa kali. Nilai parameter ini tidak muncul ke tim ACR dan lebih cocok untuk informasi sensitif.

--set

Nilai tugas dalam format '--set nama[=value]'. Kelipatan didukung dengan meneruskan --set beberapa kali.

--set-secret

Nilai tugas rahasia dalam format '--set-secret name[=value]'. Kelipatan didukung dengan meneruskan --set-secret beberapa kali.

--source-trigger-name

Nama pemicu sumber.

Nilai default: defaultSourceTriggerName
--status

Status tugas saat ini.

Nilai yang diterima: Disabled, Enabled
Nilai default: Enabled
--target

Nama tahap build target.

--timeout

Batas waktu dalam detik.

Nilai default: 3600
--update-trigger-endpoint
Pratinjau

URL lengkap titik akhir untuk menerima pemberitahuan pemicu pembaruan gambar dasar.

--update-trigger-payload-type
Pratinjau

Menunjukkan apakah akan menyertakan metadata tentang pemicu gambar dasar dalam payload bersama dengan token pemicu pembaruan, saat pemberitahuan dikirim.

Nilai yang diterima: Default, Token
Nilai default: Default
--values

Jalur file nilai tugas/parameter relatif terhadap konteks sumber.

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 acr task delete

Edit

Menghapus tugas dari Azure Container Registry.

az acr task delete --name
                   --registry
                   [--resource-group]
                   [--yes]

Contoh

Menghapus tugas dari Azure Container Registry.

az acr task delete -n MyTask -r myregistry

Parameter yang Diperlukan

--name -n

Nama tugas.

--registry -r

Nama registri kontainer. Ini harus ditentukan dalam huruf kecil. Anda dapat mengonfigurasi nama registri default menggunakan az configure --defaults acr=<registry name>.

Parameter Opsional

--resource-group -g

Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

--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 acr task list

Edit

Mencantumkan tugas untuk Azure Container Registry.

az acr task list --registry
                 [--resource-group]

Contoh

Mencantumkan tugas dan memperlihatkan hasilnya dalam tabel.

az acr task list -r myregistry -o table

Parameter yang Diperlukan

--registry -r

Nama registri kontainer. Ini harus ditentukan dalam huruf kecil. Anda dapat mengonfigurasi nama registri default menggunakan az configure --defaults acr=<registry name>.

Parameter Opsional

--resource-group -g

Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

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 acr task list-runs

Edit

Cantumkan semua eksekusi yang dijalankan untuk Azure Container Registry, dengan kemampuan untuk memfilter menurut Tugas tertentu.

az acr task list-runs --registry
                      [--image]
                      [--name]
                      [--resource-group]
                      [--run-status {Canceled, Error, Failed, Queued, Running, Started, Succeeded, Timeout}]
                      [--top]

Contoh

Cantumkan semua eksekusi untuk registri dan perlihatkan hasilnya dalam tabel.

az acr task list-runs -r myregistry -o table

Daftar berjalan untuk tugas dan memperlihatkan hasilnya dalam tabel.

az acr task list-runs -r myregistry -n MyTask -o table

Cantumkan 10 eksekusi terakhir yang berhasil untuk registri dan tampilkan hasilnya dalam tabel.

az acr task list-runs -r myregistry --run-status Succeeded --top 10 -o table

Cantumkan semua eksekusi yang membangun gambar 'hello-world' untuk registri dan tampilkan hasilnya dalam tabel.

az acr task list-runs -r myregistry --image hello-world -o table

Parameter yang Diperlukan

--registry -r

Nama registri kontainer. Ini harus ditentukan dalam huruf kecil. Anda dapat mengonfigurasi nama registri default menggunakan az configure --defaults acr=<registry name>.

Parameter Opsional

--image -t

Nama gambar. Dapat menyertakan tag dalam format 'name:tag' atau digest dalam format 'name@digest'.

--name -n

Nama tugas.

--resource-group -g

Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

--run-status

Status eksekusi saat ini.

Nilai yang diterima: Canceled, Error, Failed, Queued, Running, Started, Succeeded, Timeout
--top

Batasi jumlah eksekusi terbaru dalam hasil.

Nilai default: 15
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 acr task logs

Edit

Tampilkan log untuk eksekusi tertentu. Jika tidak ada run-id yang disediakan, tampilkan log untuk eksekusi terakhir yang dibuat.

az acr task logs --registry
                 [--image]
                 [--name]
                 [--no-format]
                 [--resource-group]
                 [--run-id]

Contoh

Tampilkan log untuk eksekusi terakhir yang dibuat di registri.

az acr task logs -r myregistry

Perlihatkan log untuk eksekusi yang terakhir dibuat di registri, difilter menurut tugas.

az acr task logs -r myregistry -n MyTask

Tampilkan log untuk eksekusi tertentu.

az acr task logs -r myregistry --run-id runId

Tampilkan log untuk eksekusi terakhir yang dibuat di registri yang membangun gambar 'hello-world'.

az acr task logs -r myregistry --image hello-world

Parameter yang Diperlukan

--registry -r

Nama registri kontainer. Ini harus ditentukan dalam huruf kecil. Anda dapat mengonfigurasi nama registri default menggunakan az configure --defaults acr=<registry name>.

Parameter Opsional

--image -t

Nama gambar. Dapat menyertakan tag dalam format 'name:tag' atau digest dalam format 'name@digest'.

--name -n

Nama tugas.

--no-format

Menunjukkan apakah log harus ditampilkan dalam format mentah.

Nilai default: False
--resource-group -g

Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

--run-id

Pengidentifikasi eksekusi unik.

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 acr task run

Edit

Memicu tugas secara manual yang mungkin menunggu penerapan git atau pemicu pembaruan gambar dasar.

az acr task run --name
                --registry
                [--agent-pool]
                [--arg]
                [--context]
                [--file]
                [--log-template]
                [--no-format]
                [--no-logs]
                [--no-wait]
                [--resource-group]
                [--secret-arg]
                [--set]
                [--set-secret]
                [--target]
                [--update-trigger-token]

Contoh

Memicu eksekusi tugas.

az acr task run -n MyTask -r myregistry

Picu eksekusi tugas dengan menimpa konteks dan file yang diteruskan selama Pembuatan tugas dengan repositori jarak jauh.

az acr task run -n MyTask -r myregistry -c https://github.com/Azure-Samples/acr-build-helloworld-node.git -f Dockerfile

Picu eksekusi tugas dengan menimpa konteks dan file yang diteruskan selama Pembuatan tugas dengan konteks lokal.

az acr task run -n MyTask -r myregistry -c . -f Dockerfile

Picu eksekusi tugas dengan menambahkan atau menimpa kumpulan argumen build selama Pembuatan tugas.

az acr task run -n MyTask -r myregistry --arg DOCKER_CLI_BASE_IMAGE=docker:18.03.0-ce-git

Parameter yang Diperlukan

--name -n

Nama tugas.

--registry -r

Nama registri kontainer. Ini harus ditentukan dalam huruf kecil. Anda dapat mengonfigurasi nama registri default menggunakan az configure --defaults acr=<registry name>.

Parameter Opsional

--agent-pool
Pratinjau

Nama kumpulan agen.

--arg

Argumen build dalam format '--arg name[=value]'. Beberapa kali didukung dengan meneruskan '--arg name[=value]' beberapa kali. PENTING: Parameter ini tidak boleh menyertakan kata sandi, token akses, atau informasi sensitif dalam bentuk apa pun. Nilai parameter ini akan terlihat oleh tim ACR untuk tujuan penelusuran kesalahan.

--context -c

URL lengkap ke repositori kode sumber (Memerlukan akhiran '.git' untuk repositori github) atau tarball jarak jauh (misalnya, 'http://server/context.tar.gz'), atau repositori artefak OCI dalam registri kontainer Azure (misalnya, 'oci://myregistry.azurecr.io/myartifact:mytag'). Jika '/dev/null' ditentukan, nilai akan diatur ke Tidak Ada dan diabaikan. Ini adalah argumen yang diperlukan jika tugas bukan tugas sistem.

--file -f

Jalur relatif file tugas/docker ke folder akar kode sumber. File tugas harus diakhiri dengan '.yaml' atau disalurkan dari input standar menggunakan '-'.

--log-template
Pratinjau

Templat repositori dan tag untuk menjalankan artefak log menggunakan format: 'log/repo:tag' (misalnya, 'acr/logs:{{.Run.ID}}'). Hanya berlaku untuk registri yang diaktifkan CMK.

--no-format

Menunjukkan apakah log harus ditampilkan dalam format mentah.

Nilai default: False
--no-logs

Jangan tampilkan log setelah berhasil mengantre build.

Nilai default: False
--no-wait

Jangan menunggu eksekusi selesai dan kembali segera setelah mengantre eksekusi.

Nilai default: False
--resource-group -g

Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

--secret-arg

Argumen build rahasia dalam format '--secret-arg name[=value]'. Perkalian didukung dengan meneruskan '--secret-arg name[=value]' beberapa kali. Nilai parameter ini tidak muncul ke tim ACR dan lebih cocok untuk informasi sensitif.

--set

Nilai tugas dalam format '--set nama[=value]'. Kelipatan didukung dengan meneruskan --set beberapa kali.

--set-secret

Nilai tugas rahasia dalam format '--set-secret name[=value]'. Kelipatan didukung dengan meneruskan --set-secret beberapa kali.

--target

Nama tahap build target.

--update-trigger-token
Pratinjau

Payload yang akan diteruskan kembali bersama dengan pemberitahuan pemicu gambar dasar.

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 acr task show

Edit

Dapatkan properti tugas bernama untuk Azure Container Registry.

az acr task show --name
                 --registry
                 [--resource-group]
                 [--with-secure-properties]

Contoh

Dapatkan properti tugas, menampilkan hasil dalam tabel.

az acr task show -n MyTask -r myregistry -o table

Dapatkan properti tugas, termasuk properti aman.

az acr task show -n MyTask -r myregistry --with-secure-properties

Parameter yang Diperlukan

--name -n

Nama tugas.

--registry -r

Nama registri kontainer. Ini harus ditentukan dalam huruf kecil. Anda dapat mengonfigurasi nama registri default menggunakan az configure --defaults acr=<registry name>.

Parameter Opsional

--resource-group -g

Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

--with-secure-properties

Menunjukkan apakah properti aman tugas harus dikembalikan.

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 acr task show-run

Edit

Dapatkan properti dari eksekusi tugas Azure Container Registry yang ditentukan.

az acr task show-run --registry
                     --run-id
                     [--resource-group]

Contoh

Dapatkan detail eksekusi, menampilkan hasilnya dalam tabel.

az acr task show-run -r myregistry --run-id runId -o table

Parameter yang Diperlukan

--registry -r

Nama registri kontainer. Ini harus ditentukan dalam huruf kecil. Anda dapat mengonfigurasi nama registri default menggunakan az configure --defaults acr=<registry name>.

--run-id

Pengidentifikasi eksekusi unik.

Parameter Opsional

--resource-group -g

Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

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 acr task update

Edit

Perbarui tugas untuk Azure Container Registry.

az acr task update --name
                   --registry
                   [--agent-pool]
                   [--arg]
                   [--auth-mode {Default, None}]
                   [--base-image-trigger-enabled {false, true}]
                   [--base-image-trigger-type {All, Runtime}]
                   [--cmd]
                   [--commit-trigger-enabled {false, true}]
                   [--context]
                   [--cpu]
                   [--file]
                   [--git-access-token]
                   [--image]
                   [--log-template]
                   [--no-cache {false, true}]
                   [--no-push {false, true}]
                   [--platform]
                   [--pull-request-trigger-enabled {false, true}]
                   [--resource-group]
                   [--secret-arg]
                   [--set]
                   [--set-secret]
                   [--status {Disabled, Enabled}]
                   [--target]
                   [--timeout]
                   [--update-trigger-endpoint]
                   [--update-trigger-payload-type {Default, Token}]
                   [--values]

Contoh

Perbarui pembaruan gambar dasar untuk memicu semua gambar dependen dockerfile multi-tahap, dan status tugas di Azure Container Registry.

az acr task update -n MyTask -r myregistry --base-image-trigger-type All --status Disabled

Perbarui platform untuk langkah Build Tugas Anda ke Windows (Linux sebelumnya).

az acr task update -n MyTask -r myregistry --platform Windows

Perbarui pemicu dan konteks tugas untuk Azure Container Registry.

az acr task update -n hello-world -r myregistry -f Dockerfile \
    --commit-trigger-enabled false --pull-request-trigger-enabled true \
    -c https://msazure.visualstudio.com/DefaultCollection/Project/_git/Repo#Branch:Folder

Perbarui tugas untuk Azure Container Registry. (dibuat otomatis)

az acr task update --image MyImage --name MyTask --registry myregistry \
    --context https://github.com/Azure-Samples/acr-build-helloworld-node.git

Parameter yang Diperlukan

--name -n

Nama tugas.

--registry -r

Nama registri kontainer. Ini harus ditentukan dalam huruf kecil. Anda dapat mengonfigurasi nama registri default menggunakan az configure --defaults acr=<registry name>.

Parameter Opsional

--agent-pool
Pratinjau

Nama kumpulan agen.

--arg

Argumen build dalam format '--arg name[=value]'. Beberapa kali didukung dengan meneruskan '--arg name[=value]' beberapa kali. PENTING: Parameter ini tidak boleh menyertakan kata sandi, token akses, atau informasi sensitif dalam bentuk apa pun. Nilai parameter ini akan terlihat oleh tim ACR untuk tujuan penelusuran kesalahan.

--auth-mode

Mode autentikasi registri sumber.

Nilai yang diterima: Default, None
--base-image-trigger-enabled

Menunjukkan apakah pemicu gambar dasar diaktifkan.

Nilai yang diterima: false, true
--base-image-trigger-type

Jenis pemicu otomatis untuk pembaruan dependensi gambar dasar.

Nilai yang diterima: All, Runtime
--cmd

Perintah untuk dijalankan. Ini juga mendukung parameter eksekusi docker tambahan (https://docs.docker.com/engine/reference/commandline/run/) atau bahkan perintah docker lainnya (https://docs.docker.com/engine/reference/commandline/docker/).

--commit-trigger-enabled

Menunjukkan apakah pemicu penerapan kontrol sumber diaktifkan.

Nilai yang diterima: false, true
--context -c

URL lengkap ke repositori kode sumber (Memerlukan akhiran '.git' untuk repositori github) atau tarball jarak jauh (misalnya, 'http://server/context.tar.gz'), atau repositori artefak OCI dalam registri kontainer Azure (misalnya, 'oci://myregistry.azurecr.io/myartifact:mytag'). Jika '/dev/null' ditentukan, nilai akan diatur ke Tidak Ada dan diabaikan. Ini adalah argumen yang diperlukan jika tugas bukan tugas sistem.

--cpu

Konfigurasi CPU dalam hal jumlah inti yang diperlukan untuk eksekusi.

--file -f

Jalur relatif file tugas/docker ke folder akar kode sumber. File tugas harus diakhiri dengan '.yaml' atau disalurkan dari input standar menggunakan '-'.

--git-access-token

Token akses yang digunakan untuk mengakses penyedia kontrol sumber.

--image -t

Nama dan tag gambar menggunakan format: '-t repo/image:tag'. Beberapa tag didukung dengan meneruskan -t beberapa kali.

--log-template
Pratinjau

Templat repositori dan tag untuk menjalankan artefak log menggunakan format: 'log/repo:tag' (misalnya, 'acr/logs:{{.Run.ID}}'). Hanya berlaku untuk registri yang diaktifkan CMK.

--no-cache

Menunjukkan apakah cache gambar diaktifkan.

Nilai yang diterima: false, true
--no-push

Menunjukkan apakah gambar yang dibuat harus didorong ke registri.

Nilai yang diterima: false, true
--platform

Platform tempat build/task dijalankan, Misalnya, 'windows' dan 'linux'. Saat digunakan dalam perintah build, perintah tersebut juga dapat ditentukan dalam format 'os/arch/variant' untuk gambar yang dihasilkan. Misalnya, linux/arm/v7. Bagian 'arch' dan 'varian' bersifat opsional.

--pull-request-trigger-enabled

Menunjukkan apakah pemicu permintaan pull kontrol sumber diaktifkan. Pemicu dinonaktifkan secara default.

Nilai yang diterima: false, true
--resource-group -g

Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

--secret-arg

Argumen build rahasia dalam format '--secret-arg name[=value]'. Perkalian didukung dengan meneruskan '--secret-arg name[=value]' beberapa kali. Nilai parameter ini tidak muncul ke tim ACR dan lebih cocok untuk informasi sensitif.

--set

Nilai tugas dalam format '--set nama[=value]'. Kelipatan didukung dengan meneruskan --set beberapa kali.

--set-secret

Nilai tugas rahasia dalam format '--set-secret name[=value]'. Kelipatan didukung dengan meneruskan --set-secret beberapa kali.

--status

Status tugas saat ini.

Nilai yang diterima: Disabled, Enabled
--target

Nama tahap build target.

--timeout

Batas waktu dalam detik.

--update-trigger-endpoint
Pratinjau

URL lengkap titik akhir untuk menerima pemberitahuan pemicu pembaruan gambar dasar.

--update-trigger-payload-type
Pratinjau

Menunjukkan apakah akan menyertakan metadata tentang pemicu gambar dasar dalam payload bersama dengan token pemicu pembaruan, saat pemberitahuan dikirim.

Nilai yang diterima: Default, Token
--values

Jalur file nilai tugas/parameter relatif terhadap konteks sumber.

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 acr task update-run

Edit

Patch properti eksekusi Tugas Azure Container Registry.

az acr task update-run --registry
                       --run-id
                       [--no-archive {false, true}]
                       [--resource-group]

Contoh

Perbarui eksekusi yang ada untuk diarsipkan.

az acr task update-run -r myregistry --run-id runId --no-archive false

Parameter yang Diperlukan

--registry -r

Nama registri kontainer. Ini harus ditentukan dalam huruf kecil. Anda dapat mengonfigurasi nama registri default menggunakan az configure --defaults acr=<registry name>.

--run-id

Pengidentifikasi eksekusi unik.

Parameter Opsional

--no-archive

Menunjukkan apakah eksekusi harus diarsipkan.

Nilai yang diterima: false, true
--resource-group -g

Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

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.