Condividi tramite

az spring app deployment

  • Deprecato

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.

Questo gruppo di comandi è deprecato in modo implicito perché il gruppo di comandi 'spring' è deprecato e verrà rimosso in una versione futura.

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 <staging deployment>.

Comandi

Nome Descrizione Tipo Status
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 Deprecated
az spring app deployment delete

Eliminare una distribuzione dell'app.

 Estensione Deprecated
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 Deprecated
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 Deprecated
az spring app deployment list

Elencare tutte le distribuzioni in un'app.

 Estensione Deprecated
az spring app deployment show

Visualizzare i dettagli di una distribuzione.

 Estensione Deprecated
az spring app deployment start-jfr

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

 Estensione Deprecated

az spring app deployment create

Deprecato

Questo comando è deprecato in modo implicito perché il gruppo di comandi 'spring' è deprecato e verrà rimosso in una versione futura.

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 --termination-grace-period-seconds]
                                [--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 --sra]
                                [--scale-rule-http-concurrency --scale-rule-tcp-concurrency --srhc --srtc]
                                [--scale-rule-metadata --srm]
                                [--scale-rule-name --srn]
                                [--scale-rule-type --srt]
                                [--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 usando 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=<name>.

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--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.

Proprietà Valore
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.

Proprietà Valore
Gruppo di parametri: Custom Container Arguments
--container-command

Comando dell'immagine del contenitore.

Proprietà Valore
Gruppo di parametri: Custom Container Arguments
--container-image

Tag dell'immagine del contenitore.

Proprietà Valore
Gruppo di parametri: Custom Container Arguments
--container-registry

Registro dell'immagine del contenitore.

Proprietà Valore
Gruppo di parametri: Custom Container Arguments
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.

Proprietà Valore
Valore predefinito: False
--disable-probe

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

Proprietà Valore
Valori accettati: false, true
--disable-validation

Se true, disabilitare la convalida jar.

Proprietà Valore
Valori accettati: false, true
--enable-liveness-probe
Anteprima

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

Proprietà Valore
Gruppo di parametri: App Customization Arguments
Valori accettati: false, true
--enable-readiness-probe
Anteprima

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

Proprietà Valore
Gruppo di parametri: App Customization Arguments
Valori accettati: false, true
--enable-startup-probe
Anteprima

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

Proprietà Valore
Gruppo di parametri: App Customization Arguments
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.

Proprietà Valore
Gruppo di parametri: App Customization Arguments
--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", "".

Proprietà Valore
Gruppo di parametri: Custom Container Arguments
--liveness-probe-config
Anteprima

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

Proprietà Valore
Gruppo di parametri: App Customization Arguments
--main-entry -m

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

--max-replicas

Numero massimo di repliche.

Proprietà Valore
Gruppo di parametri: StandardGen2 Arguments
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.

Proprietà Valore
Gruppo di parametri: StandardGen2 Arguments
Valore predefinito: 1
--no-wait

Non attendere il completamento dell'operazione a esecuzione prolungata.

Proprietà Valore
Valore predefinito: False
--readiness-probe-config
Anteprima

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

Proprietà Valore
Gruppo di parametri: App Customization Arguments
--registry-password

Password del registro contenitori.

Proprietà Valore
Gruppo di parametri: Custom Container Arguments
--registry-username

Nome utente del registro contenitori.

Proprietà Valore
Gruppo di parametri: Custom Container Arguments
--runtime-version

Versione di runtime del linguaggio usato.

Proprietà Valore
Valori accettati: Java_11, Java_17, Java_21, Java_8, NetCore_31
--scale-rule-auth --sra

Parametri di autenticazione delle regole di scalabilità. Formattare <triggerParameter>=<secretRef> e separare lo spazio.

Proprietà Valore
Gruppo di parametri: StandardGen2 Arguments
--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.

Proprietà Valore
Gruppo di parametri: StandardGen2 Arguments
--scale-rule-metadata --srm

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

Proprietà Valore
Gruppo di parametri: StandardGen2 Arguments
--scale-rule-name --srn

Nome della regola di scalabilità.

Proprietà Valore
Gruppo di parametri: StandardGen2 Arguments
--scale-rule-type --srt

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

Proprietà Valore
Gruppo di parametri: StandardGen2 Arguments
--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.

Proprietà Valore
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.

Proprietà Valore
Gruppo di parametri: Source Code deploy Arguments
--startup-probe-config
Anteprima

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

Proprietà Valore
Gruppo di parametri: App Customization Arguments
--target-module

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

Proprietà Valore
Gruppo di parametri: Source Code deploy Arguments
--version

Versione di distribuzione, mantenere invariata se non impostata.

Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

Proprietà Valore
Valore predefinito: json
Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

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

Proprietà Valore
Valore predefinito: False

az spring app deployment delete

Deprecato

Questo comando è deprecato in modo implicito perché il gruppo di comandi 'spring' è deprecato e verrà rimosso in una versione futura.

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 usando 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=<name>.

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--no-wait

Non attendere il completamento dell'operazione a esecuzione prolungata.

Proprietà Valore
Valore predefinito: False
Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

Proprietà Valore
Valore predefinito: json
Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

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

Proprietà Valore
Valore predefinito: False

az spring app deployment generate-heap-dump

Deprecato

Questo comando è deprecato in modo implicito perché il gruppo di comandi 'spring' è deprecato e verrà rimosso in una versione futura.

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 usando 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=<name>.

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--deployment -d

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

Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

Proprietà Valore
Valore predefinito: json
Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

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

Proprietà Valore
Valore predefinito: False

az spring app deployment generate-thread-dump

Deprecato

Questo comando è deprecato in modo implicito perché il gruppo di comandi 'spring' è deprecato e verrà rimosso in una versione futura.

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 usando 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=<name>.

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--deployment -d

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

Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

Proprietà Valore
Valore predefinito: json
Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

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

Proprietà Valore
Valore predefinito: False

az spring app deployment list

Deprecato

Questo comando è deprecato in modo implicito perché il gruppo di comandi 'spring' è deprecato e verrà rimosso in una versione futura.

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 usando 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=<name>.

Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

Proprietà Valore
Valore predefinito: json
Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

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

Proprietà Valore
Valore predefinito: False

az spring app deployment show

Deprecato

Questo comando è deprecato in modo implicito perché il gruppo di comandi 'spring' è deprecato e verrà rimosso in una versione futura.

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 usando 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=<name>.

Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

Proprietà Valore
Valore predefinito: json
Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

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

Proprietà Valore
Valore predefinito: False

az spring app deployment start-jfr

Deprecato

Questo comando è deprecato in modo implicito perché il gruppo di comandi 'spring' è deprecato e verrà rimosso in una versione futura.

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 usando 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=<name>.

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--deployment -d

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

--duration

Durata di JFR.

Proprietà Valore
Valore predefinito: 60s
Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

Proprietà Valore
Valore predefinito: json
Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

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

Proprietà Valore
Valore predefinito: False