Share via


az spring app deployment

Nota

Questo riferimento fa parte dell'estensione spring per l'interfaccia della riga di comando di Azure (versione 2.56.0 o successiva). L'estensione installerà automaticamente la prima volta che si esegue un comando az spring app deployment . Altre informazioni sulle estensioni.

Comandi per gestire il ciclo di vita delle distribuzioni di un'app in Azure Spring Apps. È possibile eseguire altre operazioni sulle distribuzioni a livello di app con il parametro --deployment. ad esempio az spring app deploy --deployment .

Comandi

Nome Descrizione Tipo Stato
az spring app deployment create

Creare una distribuzione di staging per l'app. Per distribuire il codice o aggiornare l'impostazione in una distribuzione esistente, usare az spring app deploy/update --deployment <staging deployment>.

Estensione Disponibilità generale
az spring app deployment delete

Eliminare una distribuzione dell'app.

Estensione Disponibilità generale
az spring app deployment generate-heap-dump

Generare un dump dell'heap dell'istanza dell'app di destinazione in base al percorso del file specificato.

Estensione Disponibilità generale
az spring app deployment generate-thread-dump

Generare un dump del thread dell'istanza dell'app di destinazione in un percorso di file specificato.

Estensione Disponibilità generale
az spring app deployment list

Elencare tutte le distribuzioni in un'app.

Estensione Disponibilità generale
az spring app deployment show

Visualizzare i dettagli di una distribuzione.

Estensione Disponibilità generale
az spring app deployment start-jfr

Avviare un JFR nell'istanza dell'app di destinazione per specificare il percorso del file.

Estensione Disponibilità generale

az spring app deployment create

Creare una distribuzione di staging per l'app. Per distribuire il codice o aggiornare l'impostazione in una distribuzione esistente, usare 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]

Esempio

Distribuire il codice sorgente in una nuova distribuzione di un'app. In questo modo si comprimerà la directory corrente, si compilerà il file binario con Pivotal Build Service e quindi si distribuirà.

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

Distribuire un file JAR predefinito in un'app con opzioni jvm e variabili di ambiente.

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

Distribuire un'immagine del contenitore nell'hub Docker in un'app.

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

Distribuire un'immagine del contenitore in un registro privato in un'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>

Parametri necessari

--app

Nome dell'app.

--name -n

Nome della distribuzione.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--service -s

Il nome dell'istanza di Azure Spring Apps consente di configurare il servizio predefinito usando az configure --defaults spring=.

Parametri facoltativi

--apms

(Solo livello Enterprise) Nomi APM separati da spazi.

--artifact-path

Distribuire l'artefatto predefinito specificato (jar, war o netcore zip, war è in anteprima pubblica).

--build-certificates

(Solo livello Enterprise) Nomi di certificato separati da spazi, i certificati vengono usati durante la fase di compilazione.

--build-env

Variabili di ambiente separate da spazi nel formato 'key[=value]'.

--builder

(Solo livello Enterprise) Compilare il generatore di servizi usato per compilare il file eseguibile.

valore predefinito: default
--config-file-patterns

(Solo livello Enterprise) Modelli di file di configurazione separati con "", per decidere quali modelli del servizio di configurazione dell'applicazione verranno usati. Usare """ per cancellare le configurazioni esistenti.

--container-args

Argomenti dell'immagine del contenitore.

--container-command

Comando dell'immagine del contenitore.

--container-image

Tag dell'immagine del contenitore.

--container-registry

Registro dell'immagine del contenitore.

valore predefinito: docker.io
--cpu

Quantità di risorse CPU. Deve essere 250m, 500m, 750m, 1250m o numero di core CPU.

--custom-actuator-path

(Solo livello Enterprise) Percorso dell'attuatore personalizzato per l'app. L'impostazione predefinita è "/attuatore".

--custom-actuator-port

(Solo livello Enterprise) Porta dell'attuatore personalizzata per l'app. Il valore predefinito è 8080.

--disable-app-log

Non stampare i log applicazioni quando si distribuisce l'applicazione.

valore predefinito: False
--disable-probe

Se true, disabilitare il probe di attività e conformità.

valori accettati: false, true
--disable-validation

Se true, disabilitare la convalida jar.

valori accettati: false, true
--enable-liveness-probe
Anteprima

Se false, disabiliterà il probe di attività dell'istanza dell'app.

valori accettati: false, true
--enable-readiness-probe
Anteprima

Se false, disabiliterà il probe di idoneità dell'istanza dell'app.

valori accettati: false, true
--enable-startup-probe
Anteprima

Se false, disabiliterà il probe di avvio dell'istanza dell'app.

valori accettati: false, true
--env

Variabili di ambiente separate da spazi nel formato 'key[=value]'.

--grace-period --termination-grace-period-seconds
Anteprima

La durata facoltativa in secondi dell'istanza dell'app deve terminare normalmente.

--instance-count

Numero di istanza.

--jvm-options

Stringa contenente le opzioni jvm, usare '=' anziché ' per questo argomento per evitare l'errore di analisi bash, ad esempio --jvm-options='-Xms1024m -Xmx2048m'.

--language-framework

Framework del linguaggio dell'immagine del contenitore caricata. Valori supportati: "springboot", "".

--liveness-probe-config
Anteprima

Un percorso di file JSON indica la configurazione del probe di attività.

--main-entry -m

Stringa contenente il percorso dell'eseguibile .NET relativo alla radice zip.

--max-replicas

Numero massimo di repliche.

valore predefinito: 10
--memory

Quantità di risorse di memoria. Deve essere 512Mi, 1536Mi, 2560Mi, 3584Mi o #Gi, ad esempio 1Gi, 3Gi.

--min-replicas

Numero minimo di repliche.

valore predefinito: 1
--no-wait

Indica che non è necessario attendere il termine dell'operazione a esecuzione prolungata.

valore predefinito: False
--readiness-probe-config
Anteprima

Un percorso di file JSON indica la configurazione del probe di idoneità.

--registry-password

Password del registro contenitori.

--registry-username

Nome utente del registro contenitori.

--runtime-version

Versione di runtime del linguaggio usato.

valori accettati: Java_11, Java_17, Java_21, Java_8, NetCore_31
--scale-rule-auth --sra

Parametri di autenticazione delle regole di scalabilità. Formattare "=" e separare lo spazio.

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

Numero massimo di richieste simultanee prima dell'aumento del numero di istanze. Supportato solo per le regole di scalabilità HTTP e TCP.

--scale-rule-metadata --srm

Ridimensionare i metadati delle regole. Formattare "key[=value]" e separati da spazio.

--scale-rule-name --srn

Nome della regola di scalabilità.

--scale-rule-type --srt

Tipo della regola di scalabilità. Impostazione predefinita: http.

--server-version

(Solo livelli Standard e Basic) Versione del server Tomcat. Elencare tutte le versioni del server supportate eseguendo az spring list-support-server-versions -o table. Questa funzionalità è disponibile in anteprima pubblica.

--skip-clone-settings

Creare la distribuzione di staging copierà automaticamente le impostazioni dalla distribuzione di produzione.

valore predefinito: False
--source-path

Distribuire la cartella di origine specificata. La cartella verrà compressa in tar, caricata e compilata usando kpack. L'impostazione predefinita è la cartella corrente se non viene specificato alcun valore.

--startup-probe-config
Anteprima

Un percorso di file JSON indica la configurazione del probe di avvio.

--target-module

Modulo figlio da distribuire, necessario per più pacchetti JAR compilati dal codice sorgente.

--version

Versione di distribuzione, mantenere invariata se non impostata.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az spring app deployment delete

Eliminare una distribuzione dell'app.

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

Parametri necessari

--app

Nome dell'app.

--name -n

Nome della distribuzione.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--service -s

Il nome dell'istanza di Azure Spring Apps consente di configurare il servizio predefinito usando az configure --defaults spring=.

Parametri facoltativi

--no-wait

Indica che non è necessario attendere il termine dell'operazione a esecuzione prolungata.

valore predefinito: False
Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az spring app deployment generate-heap-dump

Generare un dump dell'heap dell'istanza dell'app di destinazione in base al percorso del file specificato.

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

Parametri necessari

--app

Nome dell'app.

--app-instance

Istanza dell'app di destinazione che si vuole eseguire il dump.

--file-path

Percorso del file di montaggio per il file di dump.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--service -s

Il nome dell'istanza di Azure Spring Apps consente di configurare il servizio predefinito usando az configure --defaults spring=.

Parametri facoltativi

--deployment -d

Nome di una distribuzione esistente dell'app. L'impostazione predefinita è la distribuzione di produzione se non è specificata.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az spring app deployment generate-thread-dump

Generare un dump del thread dell'istanza dell'app di destinazione in un percorso di file specificato.

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

Parametri necessari

--app

Nome dell'app.

--app-instance

Istanza dell'app di destinazione che si vuole eseguire il dump.

--file-path

Percorso del file di montaggio per il file di dump.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--service -s

Il nome dell'istanza di Azure Spring Apps consente di configurare il servizio predefinito usando az configure --defaults spring=.

Parametri facoltativi

--deployment -d

Nome di una distribuzione esistente dell'app. L'impostazione predefinita è la distribuzione di produzione se non è specificata.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az spring app deployment list

Elencare tutte le distribuzioni in un'app.

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

Parametri necessari

--app

Nome dell'app.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--service -s

Il nome dell'istanza di Azure Spring Apps consente di configurare il servizio predefinito usando az configure --defaults spring=.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az spring app deployment show

Visualizzare i dettagli di una distribuzione.

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

Parametri necessari

--app

Nome dell'app.

--name -n

Nome della distribuzione.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--service -s

Il nome dell'istanza di Azure Spring Apps consente di configurare il servizio predefinito usando az configure --defaults spring=.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az spring app deployment start-jfr

Avviare un JFR nell'istanza dell'app di destinazione per specificare il percorso del file.

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

Parametri necessari

--app

Nome dell'app.

--app-instance

Istanza dell'app di destinazione che si vuole eseguire il dump.

--file-path

Percorso del file di montaggio per il file di dump.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--service -s

Il nome dell'istanza di Azure Spring Apps consente di configurare il servizio predefinito usando az configure --defaults spring=.

Parametri facoltativi

--deployment -d

Nome di una distribuzione esistente dell'app. L'impostazione predefinita è la distribuzione di produzione se non è specificata.

--duration

Durata di JFR.

valore predefinito: 60s
Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.