az spring app

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 . Altre informazioni sulle estensioni.

Comandi per gestire le app in Azure Spring Apps.

Comandi

Nome Descrizione Tipo Stato
az spring app append-loaded-public-certificate

Aggiungere un nuovo certificato pubblico caricato a un'app in Azure Spring Apps.

Estensione Disponibilità generale
az spring app append-persistent-storage

Aggiungere una nuova risorsa di archiviazione permanente a un'app in Azure Spring Apps.

Estensione Disponibilità generale
az spring app binding

Comandi per gestire le associazioni con Azure Data Services, è necessario riavviare manualmente l'app per rendere effettive le impostazioni.

Estensione Deprecato
az spring app binding cosmos

Comandi per gestire le associazioni di Azure Cosmos DB.

Estensione Deprecato
az spring app binding cosmos add

Associare un'istanza di Azure Cosmos DB all'app.

Estensione Deprecato
az spring app binding cosmos update

Aggiornare un'associazione del servizio Azure Cosmos DB dell'app.

Estensione Deprecato
az spring app binding list

Elencare tutte le associazioni di servizio in un'app.

Estensione Deprecato
az spring app binding mysql

Comandi per gestire le associazioni Database di Azure per MySQL.

Estensione Deprecato
az spring app binding mysql add

Associare un Database di Azure per MySQL all'app.

Estensione Deprecato
az spring app binding mysql update

Aggiornare un'associazione del servizio Database di Azure per MySQL dell'app.

Estensione Deprecato
az spring app binding redis

Comandi per gestire cache di Azure per Redis associazioni.

Estensione Deprecato
az spring app binding redis add

Associare un cache di Azure per Redis all'app.

Estensione Deprecato
az spring app binding redis update

Aggiornare un'associazione del servizio cache di Azure per Redis dell'app.

Estensione Deprecato
az spring app binding remove

Rimuovere un'associazione di servizio dell'app.

Estensione Deprecato
az spring app binding show

Visualizzare i dettagli di un'associazione al servizio.

Estensione Deprecato
az spring app connect

Connessione alla shell interattiva di un'istanza dell'app per la risoluzione dei problemi".

Estensione Disponibilità generale
az spring app create

Creare una nuova app con una distribuzione predefinita nell'istanza di Azure Spring Apps.

Estensione Disponibilità generale
az spring app custom-domain

Comandi per gestire domini personalizzati.

Estensione Disponibilità generale
az spring app custom-domain bind

Associare un dominio personalizzato all'app.

Estensione Disponibilità generale
az spring app custom-domain list

Elencare tutti i domini personalizzati dell'app.

Estensione Disponibilità generale
az spring app custom-domain show

Mostra i dettagli di un dominio personalizzato.

Estensione Disponibilità generale
az spring app custom-domain unbind

Annullare l'associazione di un dominio personalizzato dell'app.

Estensione Disponibilità generale
az spring app custom-domain update

Aggiornare un dominio personalizzato dell'app.

Estensione Disponibilità generale
az spring app delete

Eliminare un'app nelle app Azure Spring.

Estensione Disponibilità generale
az spring app deploy

Distribuire il codice sorgente o il file binario predefinito in un'app e aggiornare le configurazioni correlate.

Estensione Disponibilità generale
az spring app deployment

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 .

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

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 disable-remote-debugging

Disabilitare il debug remoto per una distribuzione.

Estensione Disponibilità generale
az spring app enable-remote-debugging

Abilitare il debug remoto per una distribuzione.

Estensione Disponibilità generale
az spring app get-remote-debugging-config

Ottenere la configurazione di debug remoto di una distribuzione.

Estensione Disponibilità generale
az spring app identity

Gestire le identità gestite di un'app.

Estensione Disponibilità generale
az spring app identity assign

Abilitare l'identità gestita assegnata dal sistema o assegnare identità gestite assegnate dall'utente a un'app.

Estensione Disponibilità generale
az spring app identity force-set

Forzare l'impostazione delle identità gestite in un'app.

Estensione Disponibilità generale
az spring app identity remove

Rimuovere l'identità gestita da un'app.

Estensione Disponibilità generale
az spring app identity show

Visualizzare le informazioni sull'identità gestita dell'app.

Estensione Disponibilità generale
az spring app list

Elencare tutte le app in Azure Spring Apps.

Estensione Disponibilità generale
az spring app log

Comandi per i log delle istanze dell'app finale con più opzioni. Se l'app ha una sola istanza, il nome dell'istanza è facoltativo.

Estensione Deprecato
az spring app log tail

Mostra i log di un'istanza dell'app, i log verranno trasmessi durante l'impostazione di '-f/--follow'.

Estensione Deprecato
az spring app logs

Mostra i log di un'istanza dell'app, i log verranno trasmessi durante l'impostazione di '-f/--follow'.

Estensione Disponibilità generale
az spring app restart

Riavviare le istanze dell'app, per impostazione predefinita per la distribuzione di produzione.

Estensione Disponibilità generale
az spring app scale

Ridimensionare manualmente un'app o le relative distribuzioni.

Estensione Disponibilità generale
az spring app set-deployment

Impostare la distribuzione di produzione di un'app.

Estensione Disponibilità generale
az spring app show

Visualizzare i dettagli di un'app in Azure Spring Apps.

Estensione Disponibilità generale
az spring app show-deploy-log

Mostra il log di compilazione dell'ultima distribuzione, applicabile solo alla distribuzione del codice sorgente, per impostazione predefinita alla distribuzione di produzione.

Estensione Disponibilità generale
az spring app start

Avviare le istanze dell'app, per impostazione predefinita per la distribuzione di produzione.

Estensione Disponibilità generale
az spring app stop

Arrestare le istanze dell'app, per impostazione predefinita per la distribuzione di produzione.

Estensione Disponibilità generale
az spring app unset-deployment

Distribuzione di produzione unset di un'app.

Estensione Disponibilità generale
az spring app update

Aggiornare le configurazioni di un'app.

Estensione Disponibilità generale

az spring app append-loaded-public-certificate

Aggiungere un nuovo certificato pubblico caricato a un'app in Azure Spring Apps.

az spring app append-loaded-public-certificate --certificate-name
                                               --load-trust-store {false, true}
                                               --name
                                               --resource-group
                                               --service

Esempio

Aggiungere un nuovo certificato pubblico caricato a un'app.

az spring app append-loaded-public-certificate --name MyApp --service MyCluster --resource-group MyResourceGroup --certificate-name MyCertName --load-trust-store true

Parametri necessari

--certificate-name

Nome del certificato da aggiungere.

--load-trust-store

Se true, il certificato verrà caricato nell'archivio attendibilità per le applicazioni Java.

valori accettati: false, true
valore predefinito: False
--name -n

Nome dell'app in esecuzione nell'istanza di Azure Spring Apps specificata.

--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 append-persistent-storage

Aggiungere una nuova risorsa di archiviazione permanente a un'app in Azure Spring Apps.

az spring app append-persistent-storage --mount-path
                                        --name
                                        --persistent-storage-type
                                        --resource-group
                                        --service
                                        --storage-name
                                        [--enable-sub-path {false, true}]
                                        [--mount-options]
                                        [--read-only {false, true}]
                                        [--share-name]

Esempio

Aggiungere una nuova risorsa di archiviazione permanente a un'app.

az spring app append-persistent-storage --persistent-storage-type AzureFileVolume --share-name MyShareName --mount-path /MyMountPath --storage-name MyStorageName -n MyApp -g MyResourceGroup -s MyService

Parametri necessari

--mount-path

Percorso del volume di archiviazione permanente da montare.

--name -n

Nome dell'app in esecuzione nell'istanza di Azure Spring Apps specificata.

--persistent-storage-type -t

Tipo del volume di archiviazione permanente.

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

--storage-name

Nome della risorsa di archiviazione creata in Azure Spring Apps.

Parametri facoltativi

--enable-sub-path

[facoltativo] Se true, verrà montato in sottodirectory separate con lo stesso percorso per ogni istanza dell'app .

valori accettati: false, true
valore predefinito: False
--mount-options

[facoltativo] Opzioni di montaggio per il volume di archiviazione permanente.

--read-only

[facoltativo] Se true, il volume di archiviazione permanente sarà di sola lettura.

valori accettati: false, true
valore predefinito: False
--share-name

Nome della condivisione file creata in modo preliminare. ShareName deve essere fornito solo se il tipo del volume di archiviazione permanente è AzureFileVolume.

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 connect

Connessione alla shell interattiva di un'istanza dell'app per la risoluzione dei problemi".

az spring app connect --name
                      --resource-group
                      --service
                      [--deployment]
                      [--instance]
                      [--shell-cmd]

Parametri necessari

--name -n

Nome dell'app in esecuzione nell'istanza di Azure Spring Apps specificata.

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

--instance -i

Nome di un'istanza esistente della distribuzione.

--shell-cmd

Comando shell da eseguire quando ci si connette all'istanza dell'app.

valore predefinito: /bin/sh
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 create

Creare una nuova app con una distribuzione predefinita nell'istanza di Azure Spring Apps.

az spring app create --name
                     --resource-group
                     --service
                     [--assign-endpoint {false, true}]
                     [--assign-public-endpoint {false, true}]
                     [--backend-protocol {Default, GRPC}]
                     [--bind-acs]
                     [--bind-config-server]
                     [--bind-service-registry]
                     [--client-auth-certs]
                     [--cpu]
                     [--deployment-name]
                     [--disable-probe {false, true}]
                     [--enable-liveness-probe {false, true}]
                     [--enable-persistent-storage {false, true}]
                     [--enable-readiness-probe {false, true}]
                     [--enable-startup-probe {false, true}]
                     [--env]
                     [--grace-period]
                     [--ingress-read-timeout]
                     [--ingress-send-timeout]
                     [--instance-count]
                     [--jvm-options]
                     [--liveness-probe-config]
                     [--loaded-public-certificate-file]
                     [--max-replicas]
                     [--memory]
                     [--min-replicas]
                     [--persistent-storage]
                     [--readiness-probe-config]
                     [--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]
                     [--secrets]
                     [--session-affinity {Cookie, None}]
                     [--session-max-age]
                     [--startup-probe-config]
                     [--system-assigned {false, true}]
                     [--user-assigned]
                     [--workload-profile]

Esempio

Creare un'app con la configurazione predefinita.

az spring app create -n MyApp -s MyCluster -g MyResourceGroup

Creare un'app accessibile pubblica con 3 istanze e 2 core CPU e 3 GB di memoria per ogni istanza.

az spring app create -n MyApp -s MyCluster -g MyResourceGroup --assign-endpoint true --cpu 2 --memory 3 --instance-count 3

Creare un'associazione di app al Registro di sistema del servizio predefinito, al servizio di configurazione delle applicazioni e al server di configurazione Spring Cloud.

az spring app create -n MyApp -s MyCluster -g MyResourceGroup --bind-service-registry --bind-application-configuration-service --bind-config-server

Parametri necessari

--name -n

Nome dell'app in esecuzione nell'istanza di Azure Spring Apps specificata.

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

--assign-endpoint

Se true, assegnare l'URL dell'endpoint per l'accesso diretto.

valori accettati: false, true
valore predefinito: False
--assign-public-endpoint

Se true, assegnare l'URL dell'endpoint a cui è possibile accedere dalla rete virtuale per l'app dell'istanza di inserimento della rete virtuale.

valori accettati: false, true
--backend-protocol

Protocollo back-end in ingresso dell'app. Il valore predefinito indica HTTP/HTTPS/WebSocket.

valori accettati: Default, GRPC
--bind-acs --bind-application-configuration-service

Associare automaticamente l'app al servizio di configurazione dell'applicazione predefinito.

--bind-config-server --bind-cs
Anteprima

Associare automaticamente l'app al server di configurazione predefinito.

--bind-service-registry --bind-sr

Associare automaticamente l'app al Registro di sistema del servizio predefinito.

--client-auth-certs

Stringa separata da spazi contenente GLI ID risorsa dei certificati per l'autenticazione client. ad esempio: --client_auth_certs='id0 id1'. Usare '' per cancellare i certificati esistenti.

--cpu

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

--deployment-name

Nome della distribuzione predefinita.

valore predefinito: default
--disable-probe

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

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

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

valori accettati: false, true
--enable-persistent-storage --enable-ps

Se true, montare un disco 50G (piano tariffario Standard) o 1G (piano tariffario Basic) con il percorso predefinito.

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.

--ingress-read-timeout

Valore di timeout di lettura in ingresso in secondi. Il valore predefinito 300, minimo è 1, massimo è 1800.

--ingress-send-timeout

Valore di timeout dell'invio in ingresso in secondi. Il valore predefinito 60, minimo è 1, massimo è 1800.

--instance-count

Numero di istanza.

valore predefinito: 1
--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'.

--liveness-probe-config
Anteprima

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

--loaded-public-certificate-file -f

Un percorso di file JSON indica i certificati che verrebbero caricati nell'app.

--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
--persistent-storage

Percorso di file JSON per le risorse di archiviazione persistenti da montare nell'app.

--readiness-probe-config
Anteprima

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

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

--secrets

Elenco di segreti per l'app. Formattare "key[=value]" e separati da spazio.

--session-affinity

Affinità di sessione in ingresso dell'app.

valori accettati: Cookie, None
--session-max-age

Tempo fino alla scadenza del cookie. Il valore minimo è 1 secondo, massimo è 7 giorni. Se impostato su 0, il periodo di scadenza è uguale al periodo di sessione del browser.

--startup-probe-config
Anteprima

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

--system-assigned

Abilitare l'identità gestita assegnata dal sistema.

valori accettati: false, true
--user-assigned
Anteprima

ID risorsa identità gestita assegnata dall'utente separati da spazi a assgin a un'app.

--workload-profile

Profilo del carico di lavoro usato nell'ambiente gestito. Il valore predefinito è "Consumo".

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 delete

Eliminare un'app nelle app Azure Spring.

az spring app delete --name
                     --resource-group
                     --service

Parametri necessari

--name -n

Nome dell'app in esecuzione nell'istanza di Azure Spring Apps specificata.

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

Distribuire il codice sorgente o il file binario predefinito in un'app e aggiornare le configurazioni correlate.

az spring app deploy --name
                     --resource-group
                     --service
                     [--apms]
                     [--artifact-path]
                     [--build-certificates]
                     [--build-cpu]
                     [--build-env]
                     [--build-memory]
                     [--builder]
                     [--config-file-patterns]
                     [--container-args]
                     [--container-command]
                     [--container-image]
                     [--container-registry]
                     [--custom-actuator-path]
                     [--custom-actuator-port]
                     [--deployment]
                     [--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]
                     [--jvm-options]
                     [--language-framework]
                     [--liveness-probe-config]
                     [--main-entry]
                     [--no-wait]
                     [--readiness-probe-config]
                     [--registry-password]
                     [--registry-username]
                     [--runtime-version {Java_11, Java_17, Java_21, Java_8, NetCore_31}]
                     [--server-version]
                     [--source-path]
                     [--startup-probe-config]
                     [--target-module]
                     [--version]

Esempio

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

az spring app deploy -n 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 deploy -n MyApp -s MyCluster -g MyResourceGroup --artifact-path app.jar --jvm-options="-XX:+UseG1GC -XX:+UseStringDeduplication" --env foo=bar

Distribuire una guerra predefinita in un'app con versione del server, opzioni jvm e variabili di ambiente (solo livelli Standard e Basic).

az spring app deploy -n MyApp -s MyCluster -g MyResourceGroup --artifact-path app.war --server-version Tomcat_10 --jvm-options="-XX:+UseG1GC -XX:+UseStringDeduplication" --env foo=bar

Distribuire il codice sorgente in una distribuzione specifica di un'app.

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

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

az spring app deploy -n 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 deploy -n MyApp -s MyCluster -g MyResourceGroup --container-image contoso/your-app:v1 --container-registry myacr.azurecr.io --registry-username <username> --registry-password <password>

Eseguire la distribuzione con i modelli di file di configurazione del servizio di configurazione dell'applicazione in un'app.

az spring app deploy -n MyApp -s MyCluster -g MyResourceGroup --config-file-patterns MyPatterns --artifact-path app.jar

Distribuire un file JAR predefinito in un'app con build env (solo per il livello Enterprise).

az spring app deploy -n MyApp -s MyCluster -g MyResourceGroup --artifact-path app.jar --build-env BP_JVM_VERSION=11.*

Parametri necessari

--name -n

Nome dell'app in esecuzione nell'istanza di Azure Spring Apps specificata.

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

Quantità di risorse CPU. Deve essere 500m o il numero di core CPU.

valore predefinito: 1
--build-env

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

--build-memory

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

valore predefinito: 2Gi
--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
--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.

--deployment -d

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

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

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

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

--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 disable-remote-debugging

Disabilitare il debug remoto per una distribuzione.

az spring app disable-remote-debugging --name
                                       --resource-group
                                       --service
                                       [--deployment]
                                       [--no-wait]

Parametri necessari

--name -n

Nome dell'app in esecuzione nell'istanza di Azure Spring Apps specificata.

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

--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 enable-remote-debugging

Abilitare il debug remoto per una distribuzione.

az spring app enable-remote-debugging --name
                                      --resource-group
                                      --service
                                      [--deployment]
                                      [--no-wait]
                                      [--port]

Parametri necessari

--name -n

Nome dell'app in esecuzione nell'istanza di Azure Spring Apps specificata.

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

--no-wait

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

valore predefinito: False
--port -p

Porta di debug remoto, il valore deve essere compreso tra 1024 e 65536, il valore predefinito è 5005.

valore predefinito: 5005
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 get-remote-debugging-config

Ottenere la configurazione di debug remoto di una distribuzione.

az spring app get-remote-debugging-config --name
                                          --resource-group
                                          --service
                                          [--deployment]

Parametri necessari

--name -n

Nome dell'app in esecuzione nell'istanza di Azure Spring Apps specificata.

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

Elencare tutte le app in Azure Spring Apps.

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

Esempio

Stato della query dell'archiviazione permanente di tutte le app

az spring app list -s MyCluster -g MyResourceGroup -o json --query '[].{Name:name, PersistentStorage:properties.persistentDisk}'

Parametri necessari

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

Mostra i log di un'istanza dell'app, i log verranno trasmessi durante l'impostazione di '-f/--follow'.

az spring app logs --name
                   --resource-group
                   --service
                   [--deployment]
                   [--follow]
                   [--format-json]
                   [--instance]
                   [--limit]
                   [--lines]
                   [--since]

Parametri necessari

--name -n

Nome dell'app in esecuzione nell'istanza di Azure Spring Apps specificata.

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

--follow -f

Specificare se i log devono essere trasmessi.

valore predefinito: False
--format-json

Formattare i log JSON se il log strutturato è abilitato.

--instance -i

Nome di un'istanza esistente della distribuzione.

--limit

Numero massimo di kilobyte di log da restituire. Il numero massimo è 2048.

valore predefinito: 2048
--lines

Numero di righe da visualizzare. Il valore massimo è 10000.

valore predefinito: 50
--since

Restituisce solo i log più recenti di una durata relativa, ad esempio 5s, 2m o 1h. Il valore massimo è 1h.

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 restart

Riavviare le istanze dell'app, per impostazione predefinita per la distribuzione di produzione.

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

Parametri necessari

--name -n

Nome dell'app in esecuzione nell'istanza di Azure Spring Apps specificata.

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

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

Ridimensionare manualmente un'app o le relative distribuzioni.

az spring app scale --name
                    --resource-group
                    --service
                    [--cpu]
                    [--deployment]
                    [--instance-count]
                    [--max-replicas]
                    [--memory]
                    [--min-replicas]
                    [--no-wait]
                    [--scale-rule-auth]
                    [--scale-rule-http-concurrency]
                    [--scale-rule-metadata]
                    [--scale-rule-name]
                    [--scale-rule-type]

Esempio

Aumentare le prestazioni di un'app a 4 core CPU e 8 GB di memoria per ogni istanza.

az spring app scale -n MyApp -s MyCluster -g MyResourceGroup --cpu 3 --memory 8

Aumentare il numero di istanze di una distribuzione dell'app in 5 istanze.

az spring app scale -n MyApp -s MyCluster -g MyResourceGroup -d green-deployment --instance-count 5

Parametri necessari

--name -n

Nome dell'app in esecuzione nell'istanza di Azure Spring Apps specificata.

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

--cpu

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

--deployment -d

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

--instance-count

Numero di istanza.

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

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 set-deployment

Impostare la distribuzione di produzione di un'app.

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

Esempio

Scambiare una distribuzione di staging di un'app nell'ambiente di produzione.

az spring app set-deployment -d green-deployment -n MyApp -s MyCluster -g MyResourceGroup

Parametri necessari

--deployment -d

Nome di una distribuzione esistente dell'app.

--name -n

Nome dell'app in esecuzione nell'istanza di Azure Spring Apps specificata.

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

Visualizzare i dettagli di un'app in Azure Spring Apps.

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

Parametri necessari

--name -n

Nome dell'app in esecuzione nell'istanza di Azure Spring Apps specificata.

--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 show-deploy-log

Mostra il log di compilazione dell'ultima distribuzione, applicabile solo alla distribuzione del codice sorgente, per impostazione predefinita alla distribuzione di produzione.

az spring app show-deploy-log --name
                              --resource-group
                              --service
                              [--deployment]

Parametri necessari

--name -n

Nome dell'app in esecuzione nell'istanza di Azure Spring Apps specificata.

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

Avviare le istanze dell'app, per impostazione predefinita per la distribuzione di produzione.

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

Parametri necessari

--name -n

Nome dell'app in esecuzione nell'istanza di Azure Spring Apps specificata.

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

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

Arrestare le istanze dell'app, per impostazione predefinita per la distribuzione di produzione.

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

Parametri necessari

--name -n

Nome dell'app in esecuzione nell'istanza di Azure Spring Apps specificata.

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

--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 unset-deployment

Distribuzione di produzione unset di un'app.

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

Esempio

Scambiare la distribuzione di produzione di un'app in staging se l'app ha la distribuzione di produzione.

az spring app unset-deployment -n MyApp -s MyCluster -g MyResourceGroup

Parametri necessari

--name -n

Nome dell'app in esecuzione nell'istanza di Azure Spring Apps specificata.

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

Aggiornare le configurazioni di un'app.

az spring app update --name
                     --resource-group
                     --service
                     [--assign-endpoint {false, true}]
                     [--assign-public-endpoint {false, true}]
                     [--backend-protocol {Default, GRPC}]
                     [--client-auth-certs]
                     [--config-file-patterns]
                     [--custom-actuator-path]
                     [--custom-actuator-port]
                     [--deployment]
                     [--disable-probe {false, true}]
                     [--enable-ingress-to-app-tls {false, true}]
                     [--enable-liveness-probe {false, true}]
                     [--enable-persistent-storage {false, true}]
                     [--enable-readiness-probe {false, true}]
                     [--enable-startup-probe {false, true}]
                     [--env]
                     [--grace-period]
                     [--https-only {false, true}]
                     [--ingress-read-timeout]
                     [--ingress-send-timeout]
                     [--jvm-options]
                     [--liveness-probe-config]
                     [--loaded-public-certificate-file]
                     [--main-entry]
                     [--no-wait]
                     [--persistent-storage]
                     [--readiness-probe-config]
                     [--runtime-version {Java_11, Java_17, Java_21, Java_8, NetCore_31}]
                     [--secrets]
                     [--session-affinity {Cookie, None}]
                     [--session-max-age]
                     [--startup-probe-config]
                     [--workload-profile]

Esempio

Aggiungere una variabile di ambiente per l'app.

az spring app update -n MyApp -s MyCluster -g MyResourceGroup --env foo=bar

Parametri necessari

--name -n

Nome dell'app in esecuzione nell'istanza di Azure Spring Apps specificata.

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

--assign-endpoint

Se true, assegnare l'URL dell'endpoint per l'accesso diretto.

valori accettati: false, true
--assign-public-endpoint

Se true, assegnare l'URL dell'endpoint a cui è possibile accedere dalla rete virtuale per l'app dell'istanza di inserimento della rete virtuale.

valori accettati: false, true
--backend-protocol

Protocollo back-end in ingresso dell'app. Il valore predefinito indica HTTP/HTTPS/WebSocket.

valori accettati: Default, GRPC
--client-auth-certs

Stringa separata da spazi contenente GLI ID risorsa dei certificati per l'autenticazione client. ad esempio: --client_auth_certs='id0 id1'. Usare '' per cancellare i certificati esistenti.

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

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

--deployment -d

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

--disable-probe

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

valori accettati: false, true
--enable-ingress-to-app-tls

Se true, abilitare il traffico in ingresso per l'app tls.

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

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

valori accettati: false, true
--enable-persistent-storage --enable-ps

Se true, montare un disco 50G (piano tariffario Standard) o 1G (piano tariffario Basic) con il percorso predefinito.

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.

--https-only

Se true, accedere all'app tramite https.

valori accettati: false, true
--ingress-read-timeout

Valore di timeout di lettura in ingresso in secondi. Il valore predefinito 300, minimo è 1, massimo è 1800.

--ingress-send-timeout

Valore di timeout dell'invio in ingresso in secondi. Il valore predefinito 60, minimo è 1, massimo è 1800.

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

--liveness-probe-config
Anteprima

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

--loaded-public-certificate-file -f

Un percorso di file JSON indica i certificati che verrebbero caricati nell'app.

--main-entry -m

Percorso dell'eseguibile .NET relativo alla radice zip.

--no-wait

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

valore predefinito: False
--persistent-storage

Percorso di file JSON per le risorse di archiviazione persistenti da montare nell'app.

--readiness-probe-config
Anteprima

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

--runtime-version

Versione di runtime del linguaggio usato.

valori accettati: Java_11, Java_17, Java_21, Java_8, NetCore_31
--secrets

Elenco di segreti per l'app. Formattare "key[=value]" e separati da spazio.

--session-affinity

Affinità di sessione in ingresso dell'app.

valori accettati: Cookie, None
--session-max-age

Tempo fino alla scadenza del cookie. Il valore minimo è 1 secondo, massimo è 7 giorni. Se impostato su 0, il periodo di scadenza è uguale al periodo di sessione del browser.

--startup-probe-config
Anteprima

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

--workload-profile

Profilo del carico di lavoro usato nell'ambiente gestito. Il valore predefinito è "Consumo".

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.