Bagikan melalui

az spring app deployment

  • Referensi

Nota

Referensi ini adalah bagian dari ekstensi spring untuk Azure CLI (versi 2.56.0 atau yang lebih tinggi). Ekstensi akan secara otomatis menginstal pertama kali Anda menjalankan perintah penyebaran aplikasi az spring . Pelajari selengkapnya tentang ekstensi.

Perintah untuk mengelola siklus hidup penyebaran aplikasi di Azure Spring Apps. Lebih banyak operasi pada penyebaran dapat dilakukan pada tingkat aplikasi dengan parameter --deployment. misalnya az spring app deploy --deployment <staging deployment>.

Perintah

Nama Deskripsi Jenis Status
az spring app deployment create

Buat penyebaran penahapan untuk aplikasi. Untuk menyebarkan kode atau memperbarui pengaturan ke penyebaran yang ada, gunakan az spring app deploy/update --deployment <staging deployment>.

 Ekstensi GA
az spring app deployment delete

Menghapus penyebaran aplikasi.

 Ekstensi GA
az spring app deployment generate-heap-dump

Buat heap dump instans aplikasi target Anda ke jalur file yang diberikan.

 Ekstensi GA
az spring app deployment generate-thread-dump

Buat cadangan utas instans aplikasi target Anda ke jalur file yang diberikan.

 Ekstensi GA
az spring app deployment list

Mencantumkan semua penyebaran dalam aplikasi.

 Ekstensi GA
az spring app deployment show

Menampilkan detail penyebaran.

 Ekstensi GA
az spring app deployment start-jfr

Mulai JFR pada instans aplikasi target Anda ke jalur file yang diberikan.

 Ekstensi GA

az spring app deployment create

Buat penyebaran penahapan untuk aplikasi. Untuk menyebarkan kode atau memperbarui pengaturan ke penyebaran yang ada, gunakan az spring app deploy/update --deployment <staging deployment>.

az spring app deployment create --app
                                --name
                                --resource-group
                                --service
                                [--apms]
                                [--artifact-path]
                                [--build-certificates]
                                [--build-env]
                                [--builder]
                                [--config-file-patterns]
                                [--container-args]
                                [--container-command]
                                [--container-image]
                                [--container-registry]
                                [--cpu]
                                [--custom-actuator-path]
                                [--custom-actuator-port]
                                [--disable-app-log]
                                [--disable-probe {false, true}]
                                [--disable-validation {false, true}]
                                [--enable-liveness-probe {false, true}]
                                [--enable-readiness-probe {false, true}]
                                [--enable-startup-probe {false, true}]
                                [--env]
                                [--grace-period]
                                [--instance-count]
                                [--jvm-options]
                                [--language-framework]
                                [--liveness-probe-config]
                                [--main-entry]
                                [--max-replicas]
                                [--memory]
                                [--min-replicas]
                                [--no-wait]
                                [--readiness-probe-config]
                                [--registry-password]
                                [--registry-username]
                                [--runtime-version {Java_11, Java_17, Java_21, Java_8, NetCore_31}]
                                [--scale-rule-auth]
                                [--scale-rule-http-concurrency]
                                [--scale-rule-metadata]
                                [--scale-rule-name]
                                [--scale-rule-type]
                                [--server-version]
                                [--skip-clone-settings]
                                [--source-path]
                                [--startup-probe-config]
                                [--target-module]
                                [--version]

Contoh

Sebarkan kode sumber ke penyebaran baru aplikasi. Ini akan mengemas direktori saat ini, membangun biner dengan Pivotal Build Service lalu menyebarkan.

az spring app deployment create -n green-deployment --app MyApp -s MyCluster -g MyResourceGroup --source-path

Sebarkan jar bawaan ke aplikasi dengan opsi jvm dan variabel lingkungan.

az spring app deployment create -n green-deployment --app MyApp -s MyCluster -g MyResourceGroup --artifact-path app.jar --jvm-options="-XX:+UseG1GC -XX:+UseStringDeduplication" --env foo=bar

Sebarkan gambar kontainer di Docker Hub ke aplikasi.

az spring app deployment create -n green-deployment --app MyApp -s MyCluster -g MyResourceGroup --container-image contoso/your-app:v1

Sebarkan gambar kontainer pada registri privat ke aplikasi.

az spring app deployment create -n green-deployment --app MyApp -s MyCluster -g MyResourceGroup --container-image contoso/your-app:v1 --container-registry myacr.azurecr.io --registry-username <username> --registry-password <password>

Parameter yang Diperlukan

--app

Nama aplikasi.

--name -n

Nama penyebaran.

--resource-group -g

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

--service -s

Nama instans Azure Spring Apps, Anda dapat mengonfigurasi layanan default menggunakan az configure --defaults spring=<name>.

Parameter Opsional

--apms

(Hanya Tingkat Perusahaan) Nama APM yang dipisahkan spasi.

--artifact-path

Sebarkan artefak bawaan yang ditentukan (jar, perang, atau zip netcore, perang ada di pratinjau publik).

--build-certificates

(Hanya Tingkat Perusahaan) Nama sertifikat yang dipisahkan spasi, sertifikat digunakan selama waktu build.

--build-env

Variabel lingkungan yang dipisahkan spasi dalam format 'key[=value]'.

--builder

(Hanya Tingkat Perusahaan) Build service builder yang digunakan untuk membangun executable.

Nilai default: default
--config-file-patterns

(Hanya Tingkat Perusahaan) Pola file konfigurasi dipisahkan dengan ',' untuk memutuskan pola Layanan Konfigurasi Aplikasi mana yang akan digunakan. Gunakan '""' untuk menghapus konfigurasi yang ada.

--container-args

Argumen gambar kontainer.

--container-command

Perintah gambar kontainer.

--container-image

Tag gambar kontainer.

--container-registry

Registri gambar kontainer.

Nilai default: docker.io
--cpu

Kuantitas sumber daya CPU. Harus 250m, 500m, 750m, 1250m atau jumlah inti CPU.

--custom-actuator-path

(Hanya Tingkat Perusahaan) Jalur aktuator kustom untuk aplikasi. Default ke "/aktuator".

--custom-actuator-port

(Hanya Tingkat Perusahaan) Port aktuator kustom untuk aplikasi. Default ke 8080.

--disable-app-log

Jangan mencetak log aplikasi saat menyebarkan aplikasi.

Nilai default: False
--disable-probe

Jika true, nonaktifkan pemeriksaan keaktifan dan kesiapan.

Nilai yang diterima: false, true
--disable-validation

Jika true, nonaktifkan validasi jar.

Nilai yang diterima: false, true
--enable-liveness-probe
Pratinjau

Jika false, akan menonaktifkan pemeriksaan keaktifan instans aplikasi.

Nilai yang diterima: false, true
--enable-readiness-probe
Pratinjau

Jika false, akan menonaktifkan pemeriksaan kesiapan instans aplikasi.

Nilai yang diterima: false, true
--enable-startup-probe
Pratinjau

Jika false, akan menonaktifkan pemeriksaan startup instans aplikasi.

Nilai yang diterima: false, true
--env

Variabel lingkungan yang dipisahkan spasi dalam format 'key[=value]'.

--grace-period --termination-grace-period-seconds
Pratinjau

Durasi opsional dalam detik instans aplikasi perlu dihentikan dengan lancar.

--instance-count

Jumlah instans.

--jvm-options

String yang berisi opsi jvm, gunakan '=' alih-alih ' ' untuk argumen ini untuk menghindari kesalahan penguraian bash, misalnya: --jvm-options='-Xms1024m -Xmx2048m'.

--language-framework

Kerangka kerja bahasa gambar kontainer yang diunggah. Nilai yang didukung: "springboot", "".

--liveness-probe-config
Pratinjau

Jalur file json menunjukkan konfigurasi pemeriksaan keaktifan.

--main-entry -m

String yang berisi jalur ke .NET executable relatif terhadap akar zip.

--max-replicas

Jumlah maksimum replika.

Nilai default: 10
--memory

Kuantitas sumber daya memori. Harus 512Mi, 1536Mi, 2560Mi, 3584Mi atau #Gi, misalnya, 1Gi, 3Gi.

--min-replicas

Jumlah minimum replika.

Nilai default: 1
--no-wait

Jangan menunggu operasi jangka panjang selesai.

Nilai default: False
--readiness-probe-config
Pratinjau

Jalur file json menunjukkan konfigurasi pemeriksaan kesiapan.

--registry-password

Kata sandi registri kontainer.

--registry-username

Nama pengguna registri kontainer.

--runtime-version

Versi runtime bahasa yang digunakan.

Nilai yang diterima: Java_11, Java_17, Java_21, Java_8, NetCore_31
--scale-rule-auth --sra

Parameter autentikasi aturan skala. Format <triggerParameter>=<secretRef> dan dipisahkan oleh spasi.

--scale-rule-http-concurrency --scale-rule-tcp-concurrency --srhc --srtc

Jumlah maksimum permintaan bersamaan sebelum peluasan skala. Hanya didukung untuk aturan skala http dan tcp.

--scale-rule-metadata --srm

Metadata aturan skala. Format "key[=value]" dan dipisahkan oleh spasi.

--scale-rule-name --srn

Nama aturan skala.

--scale-rule-type --srt

Jenis aturan skala. Default: http.

--server-version

(Hanya Tingkat Standar dan Dasar) Versi server Tomcat. Cantumkan semua versi server yang didukung dengan menjalankan az spring list-support-server-versions -o table. Fitur ini ada di pratinjau publik.

--skip-clone-settings

Membuat penyebaran penahapan akan secara otomatis menyalin pengaturan dari penyebaran produksi.

Nilai default: False
--source-path

Sebarkan folder sumber yang ditentukan. Folder akan dikemas ke dalam tar, diunggah, dan dibangun menggunakan kpack. Default ke folder saat ini jika tidak ada nilai yang disediakan.

--startup-probe-config
Pratinjau

Jalur file json menunjukkan konfigurasi pemeriksaan startup.

--target-module

Modul anak yang akan disebarkan, diperlukan untuk beberapa paket jar yang dibangun dari kode sumber.

--version

Versi penyebaran, tetap tidak berubah jika tidak diatur.

Parameter Global
--debug

Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Tampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya tampilkan kesalahan, menekan 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 dan contoh selengkapnya.

--subscription

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

--verbose

Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.

az spring app deployment delete

Menghapus penyebaran aplikasi.

az spring app deployment delete --app
                                --name
                                --resource-group
                                --service
                                [--no-wait]

Parameter yang Diperlukan

--app

Nama aplikasi.

--name -n

Nama penyebaran.

--resource-group -g

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

--service -s

Nama instans Azure Spring Apps, Anda dapat mengonfigurasi layanan default menggunakan az configure --defaults spring=<name>.

Parameter Opsional

--no-wait

Jangan menunggu operasi jangka panjang selesai.

Nilai default: False
Parameter Global
--debug

Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Tampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya tampilkan kesalahan, menekan 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 dan contoh selengkapnya.

--subscription

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

--verbose

Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.

az spring app deployment generate-heap-dump

Buat heap dump instans aplikasi target Anda ke jalur file yang diberikan.

az spring app deployment generate-heap-dump --app
                                            --app-instance
                                            --file-path
                                            --resource-group
                                            --service
                                            [--deployment]

Parameter yang Diperlukan

--app

Nama aplikasi.

--app-instance

Instans aplikasi target yang ingin Anda buang.

--file-path

Jalur file pemasangan untuk file cadangan Anda.

--resource-group -g

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

--service -s

Nama instans Azure Spring Apps, Anda dapat mengonfigurasi layanan default menggunakan az configure --defaults spring=<name>.

Parameter Opsional

--deployment -d

Nama penyebaran aplikasi yang ada. Default ke penyebaran produksi jika tidak ditentukan.

Parameter Global
--debug

Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Tampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya tampilkan kesalahan, menekan 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 dan contoh selengkapnya.

--subscription

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

--verbose

Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.

az spring app deployment generate-thread-dump

Buat cadangan utas instans aplikasi target Anda ke jalur file yang diberikan.

az spring app deployment generate-thread-dump --app
                                              --app-instance
                                              --file-path
                                              --resource-group
                                              --service
                                              [--deployment]

Parameter yang Diperlukan

--app

Nama aplikasi.

--app-instance

Instans aplikasi target yang ingin Anda buang.

--file-path

Jalur file pemasangan untuk file cadangan Anda.

--resource-group -g

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

--service -s

Nama instans Azure Spring Apps, Anda dapat mengonfigurasi layanan default menggunakan az configure --defaults spring=<name>.

Parameter Opsional

--deployment -d

Nama penyebaran aplikasi yang ada. Default ke penyebaran produksi jika tidak ditentukan.

Parameter Global
--debug

Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Tampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya tampilkan kesalahan, menekan 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 dan contoh selengkapnya.

--subscription

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

--verbose

Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.

az spring app deployment list

Mencantumkan semua penyebaran dalam aplikasi.

az spring app deployment list --app
                              --resource-group
                              --service

Parameter yang Diperlukan

--app

Nama aplikasi.

--resource-group -g

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

--service -s

Nama instans Azure Spring Apps, Anda dapat mengonfigurasi layanan default menggunakan az configure --defaults spring=<name>.

Parameter Global
--debug

Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Tampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya tampilkan kesalahan, menekan 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 dan contoh selengkapnya.

--subscription

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

--verbose

Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.

az spring app deployment show

Menampilkan detail penyebaran.

az spring app deployment show --app
                              --name
                              --resource-group
                              --service

Parameter yang Diperlukan

--app

Nama aplikasi.

--name -n

Nama penyebaran.

--resource-group -g

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

--service -s

Nama instans Azure Spring Apps, Anda dapat mengonfigurasi layanan default menggunakan az configure --defaults spring=<name>.

Parameter Global
--debug

Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Tampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya tampilkan kesalahan, menekan 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 dan contoh selengkapnya.

--subscription

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

--verbose

Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.

az spring app deployment start-jfr

Mulai JFR pada instans aplikasi target Anda ke jalur file yang diberikan.

az spring app deployment start-jfr --app
                                   --app-instance
                                   --file-path
                                   --resource-group
                                   --service
                                   [--deployment]
                                   [--duration]

Parameter yang Diperlukan

--app

Nama aplikasi.

--app-instance

Instans aplikasi target yang ingin Anda buang.

--file-path

Jalur file pemasangan untuk file cadangan Anda.

--resource-group -g

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

--service -s

Nama instans Azure Spring Apps, Anda dapat mengonfigurasi layanan default menggunakan az configure --defaults spring=<name>.

Parameter Opsional

--deployment -d

Nama penyebaran aplikasi yang ada. Default ke penyebaran produksi jika tidak ditentukan.

--duration

Durasi JFR.

Nilai default: 60s
Parameter Global
--debug

Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Tampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya tampilkan kesalahan, menekan 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 dan contoh selengkapnya.

--subscription

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

--verbose

Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.