Dela via

az spring app deployment

  • Referens

Not

Den här referensen är en del av spring-tillägget för Azure CLI (version 2.56.0 eller senare). Tillägget installeras automatiskt första gången du kör ett az spring app deployment command. Läs mer om tillägg.

Kommandon för att hantera livscykeln för distributioner av en app i Azure Spring Apps. Fler åtgärder för distributioner kan utföras på appnivå med parametern --deployment. t.ex. az spring app deploy --deployment <staging deployment>.

Kommandon

Name Description Typ Status
az spring app deployment create

Skapa en mellanlagringsdistribution för appen. Om du vill distribuera kod- eller uppdateringsinställningen till en befintlig distribution använder du az spring app deploy/update --deployment <staging deployment>.

 Förlängning GA
az spring app deployment delete

Ta bort en distribution av appen.

 Förlängning GA
az spring app deployment generate-heap-dump

Generera en heapdump av målappinstansen till den angivna filsökvägen.

 Förlängning GA
az spring app deployment generate-thread-dump

Generera en tråddumpning av målappinstansen till den angivna filsökvägen.

 Förlängning GA
az spring app deployment list

Visa en lista över alla distributioner i en app.

 Förlängning GA
az spring app deployment show

Visa information om en distribution.

 Förlängning GA
az spring app deployment start-jfr

Starta en JFR på målappinstansen till den angivna filsökvägen.

 Förlängning GA

az spring app deployment create

Skapa en mellanlagringsdistribution för appen. Om du vill distribuera kod- eller uppdateringsinställningen till en befintlig distribution använder du 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]

Exempel

Distribuera källkod till en ny distribution av en app. Då packas den aktuella katalogen, binärfilen skapas med Pivotal Build Service och distribueras sedan.

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

Distribuera en fördefinierad jar till en app med jvm-alternativ och miljövariabler.

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

Distribuera en containeravbildning på Docker Hub till en app.

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

Distribuera en containeravbildning i ett privat register till en app.

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>

Obligatoriska parametrar

--app

Namnet på appen.

--name -n

Namn på distribution.

--resource-group -g

Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

--service -s

Namnet på Azure Spring Apps-instansen kan du konfigurera standardtjänsten med hjälp av az configure --defaults spring=<name>.

Valfria parametrar

--apms

(Endast företagsnivå) Blankstegsavgränsade APM-namn.

--artifact-path

Distribuera den angivna fördefinierade artefakten (jar, war eller netcore zip, war is in public preview).

--build-certificates

(Endast företagsnivå) Utrymmesavgränsade certifikatnamn, certifikaten används under byggtiden.

--build-env

Utrymmesavgränsade miljövariabler i formatet "key[=value]".

--builder

(Endast företagsnivå) Build Service Builder används för att skapa den körbara filen.

Standardvärde: default
--config-file-patterns

(Endast företagsnivå) Konfigurationsfilmönster avgränsade med för att avgöra vilka mönster i programkonfigurationstjänsten som ska användas. Använd "" för att rensa befintliga konfigurationer.

--container-args

Argumenten för containeravbildningen.

--container-command

Kommandot för containeravbildningen.

--container-image

Containeravbildningstaggen.

--container-registry

Registret för containeravbildningen.

Standardvärde: docker.io
--cpu

CPU-resurskvantitet. Ska vara 250m, 500m, 750m, 1250m eller antal CPU-kärnor.

--custom-actuator-path

(Endast företagsnivå) Anpassad aktuatorsökväg för appen. Standardvärdet är "/actuator".

--custom-actuator-port

(Endast företagsnivå) Anpassad aktuatorport för appen. Standardvärdet är 8080.

--disable-app-log

Skriv inte ut programloggar när du distribuerar programmet.

Standardvärde: False
--disable-probe

Om det är sant inaktiverar du liveness- och beredskapsavsökningen.

Godkända värden: false, true
--disable-validation

Om det är sant inaktiverar du jar-validering.

Godkända värden: false, true
--enable-liveness-probe
Förhandsgranskning

Om det är falskt inaktiveras liveness-avsökningen för appinstansen.

Godkända värden: false, true
--enable-readiness-probe
Förhandsgranskning

Om det är falskt inaktiveras beredskapsavsökningen för appinstansen.

Godkända värden: false, true
--enable-startup-probe
Förhandsgranskning

Om det är falskt inaktiveras startavsökningen för appinstansen.

Godkända värden: false, true
--env

Utrymmesavgränsade miljövariabler i formatet "key[=value]".

--grace-period --termination-grace-period-seconds
Förhandsgranskning

Valfri varaktighet i sekunder som appinstansen måste avslutas korrekt.

--instance-count

Antal instanser.

--jvm-options

En sträng som innehåller jvm-alternativ, använd '=' i stället för ' ' för det här argumentet för att undvika bash-parsningsfel, t.ex. --jvm-options='-Xms1024m -Xmx2048m'.

--language-framework

Språkramverk för containeravbildningen som laddats upp. Värden som stöds: "springboot", "".

--liveness-probe-config
Förhandsgranskning

En json-filsökväg anger konfigurationen för livenessavsökning.

--main-entry -m

En sträng som innehåller sökvägen till den körbara .NET-filen i förhållande till zip-roten.

--max-replicas

Det maximala antalet repliker.

Standardvärde: 10
--memory

Minnesresurskvantitet. Ska vara 512Mi, 1536Mi, 2560Mi, 3584Mi eller #Gi, t.ex. 1Gi, 3Gi.

--min-replicas

Det minsta antalet repliker.

Standardvärde: 1
--no-wait

Vänta inte tills den långvariga åtgärden har slutförts.

Standardvärde: False
--readiness-probe-config
Förhandsgranskning

En json-filsökväg anger konfigurationen för beredskapsavsökningen.

--registry-password

Lösenordet för containerregistret.

--registry-username

Användarnamnet för containerregistret.

--runtime-version

Körningsversion av använt språk.

Godkända värden: Java_11, Java_17, Java_21, Java_8, NetCore_31
--scale-rule-auth --sra

Skalningsregelautentiseringsparametrar. Formatera <triggerParameter>=<secretRef> och avgränsat med blanksteg.

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

Det maximala antalet samtidiga begäranden innan du skalar ut. Stöds endast för http- och tcp-skalningsregler.

--scale-rule-metadata --srm

Skala regelmetadata. Formatera "key[=value]" och avgränsat med blanksteg.

--scale-rule-name --srn

Namnet på skalningsregeln.

--scale-rule-type --srt

Typ av skalningsregel. Standard: http.

--server-version

(Endast standard- och basicnivåer) Tomcat-serverversion. Visa en lista över alla serverversioner som stöds genom att köra az spring list-support-server-versions -o table. Den här funktionen är i offentlig förhandsversion.

--skip-clone-settings

Skapa mellanlagringsdistribution kopierar automatiskt inställningar från produktionsdistributionen.

Standardvärde: False
--source-path

Distribuera den angivna källmappen. Mappen packas i tjära, laddas upp och byggs med hjälp av kpack. Standardvärdet är den aktuella mappen om inget värde anges.

--startup-probe-config
Förhandsgranskning

En json-filsökväg anger konfigurationen för startavsökningen.

--target-module

Underordnad modul som ska distribueras krävs för flera jar-paket som skapats från källkoden.

--version

Distributionsversion, behåll oförändrad om den inte har angetts.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer information och exempel finns i http://jmespath.org/.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az spring app deployment delete

Ta bort en distribution av appen.

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

Obligatoriska parametrar

--app

Namnet på appen.

--name -n

Namn på distribution.

--resource-group -g

Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

--service -s

Namnet på Azure Spring Apps-instansen kan du konfigurera standardtjänsten med hjälp av az configure --defaults spring=<name>.

Valfria parametrar

--no-wait

Vänta inte tills den långvariga åtgärden har slutförts.

Standardvärde: False
Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer information och exempel finns i http://jmespath.org/.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az spring app deployment generate-heap-dump

Generera en heapdump av målappinstansen till den angivna filsökvägen.

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

Obligatoriska parametrar

--app

Namnet på appen.

--app-instance

Målappinstans som du vill dumpa.

--file-path

Sökvägen till monteringsfilen för dumpfilen.

--resource-group -g

Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

--service -s

Namnet på Azure Spring Apps-instansen kan du konfigurera standardtjänsten med hjälp av az configure --defaults spring=<name>.

Valfria parametrar

--deployment -d

Namnet på en befintlig distribution av appen. Standardvärdet för produktionsdistributionen om det inte anges.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer information och exempel finns i http://jmespath.org/.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az spring app deployment generate-thread-dump

Generera en tråddumpning av målappinstansen till den angivna filsökvägen.

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

Obligatoriska parametrar

--app

Namnet på appen.

--app-instance

Målappinstans som du vill dumpa.

--file-path

Sökvägen till monteringsfilen för dumpfilen.

--resource-group -g

Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

--service -s

Namnet på Azure Spring Apps-instansen kan du konfigurera standardtjänsten med hjälp av az configure --defaults spring=<name>.

Valfria parametrar

--deployment -d

Namnet på en befintlig distribution av appen. Standardvärdet för produktionsdistributionen om det inte anges.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer information och exempel finns i http://jmespath.org/.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az spring app deployment list

Visa en lista över alla distributioner i en app.

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

Obligatoriska parametrar

--app

Namnet på appen.

--resource-group -g

Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

--service -s

Namnet på Azure Spring Apps-instansen kan du konfigurera standardtjänsten med hjälp av az configure --defaults spring=<name>.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer information och exempel finns i http://jmespath.org/.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az spring app deployment show

Visa information om en distribution.

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

Obligatoriska parametrar

--app

Namnet på appen.

--name -n

Namn på distribution.

--resource-group -g

Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

--service -s

Namnet på Azure Spring Apps-instansen kan du konfigurera standardtjänsten med hjälp av az configure --defaults spring=<name>.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer information och exempel finns i http://jmespath.org/.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az spring app deployment start-jfr

Starta en JFR på målappinstansen till den angivna filsökvägen.

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

Obligatoriska parametrar

--app

Namnet på appen.

--app-instance

Målappinstans som du vill dumpa.

--file-path

Sökvägen till monteringsfilen för dumpfilen.

--resource-group -g

Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

--service -s

Namnet på Azure Spring Apps-instansen kan du konfigurera standardtjänsten med hjälp av az configure --defaults spring=<name>.

Valfria parametrar

--deployment -d

Namnet på en befintlig distribution av appen. Standardvärdet för produktionsdistributionen om det inte anges.

--duration

Varaktighet för JFR.

Standardvärde: 60s
Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer information och exempel finns i http://jmespath.org/.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.