Condividi tramite

az containerapp sessionpool

  • Anteprima
  • Riferimento

Nota

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

Questo gruppo di comandi è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Comandi per gestire i pool di sessioni.

Comandi

Nome Descrizione Tipo Status
az containerapp sessionpool create

Creare o aggiornare un pool di sessioni.

 Estensione Anteprima
az containerapp sessionpool delete

Eliminare un pool di sessioni.

 Estensione Anteprima
az containerapp sessionpool list

Elencare i pool di sessioni per sottoscrizione o gruppo di risorse.

 Estensione Anteprima
az containerapp sessionpool show

Mostra i dettagli di un pool di sessioni.

 Estensione Anteprima
az containerapp sessionpool update

Aggiornare un pool di sessioni.

 Estensione Anteprima

az containerapp sessionpool create

Anteprima

Il gruppo di comandi 'containerapp sessionpool' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Creare o aggiornare un pool di sessioni.

az containerapp sessionpool create --name
                                   --resource-group
                                   [--args]
                                   [--command]
                                   [--container-name]
                                   [--container-type {CustomContainer, NodeLTS, PythonLTS}]
                                   [--cooldown-period]
                                   [--cpu]
                                   [--env-vars]
                                   [--environment]
                                   [--image]
                                   [--location]
                                   [--max-sessions]
                                   [--memory]
                                   [--network-status {EgressDisabled, EgressEnabled}]
                                   [--no-wait]
                                   [--ready-sessions]
                                   [--registry-password]
                                   [--registry-server]
                                   [--registry-username]
                                   [--secrets]
                                   [--target-port]

Esempio

Creare o aggiornare un pool di sessioni con il tipo di contenitore Impostazioni predefinite PythonLTS.

az containerapp sessionpool create -n mysessionpool -g MyResourceGroup \
    --location eastasia

Creare o aggiornare un pool di sessioni con tipo di contenitore PythonLTS, con un numero massimo di sessioni simultanee pari a 30 istanze di sessione pronte 20.

az containerapp sessionpool create -n mysessionpool -g MyResourceGroup \
    --container-type PythonLTS --max-sessions 30 --ready-sessions 20 \
    --location eastasia

Creare o aggiornare un pool di sessioni con tipo di contenitore CustomContainer con l'immagine di avvio rapido predefinita.

az containerapp sessionpool create -n mysessionpool -g MyResourceGroup \
    --container-type CustomContainer --environment MyEnvironment \
    --cpu 0.5 --memory 1Gi --target-port 80 --location eastasia --image mcr.microsoft.com/k8se/quickstart:latest

Creare o aggiornare un pool di sessioni con tipo di contenitore CustomContainer con segreti e variabili di ambiente.

az containerapp sessionpool create -n mysessionpool -g MyResourceGroup \
    --container-type CustomContainer --environment MyEnvironment \
    --cpu 0.5 --memory 1Gi --target-port 80 --image MyImage \
    --env-vars GREETING="Hello, world" SECRETENV=secretref:anothersecret \
    --secrets mysecret=secretvalue1 anothersecret="secret value 2" --location eastasia

Creare o aggiornare un pool di sessioni con il tipo di contenitore CustomContainer da registro privato

az containerapp sessionpool create -n mysessionpool -g MyResourceGroup \
    --container-type CustomContainer --environment MyEnvironment --image MyImage \
    --cpu 0.5 --memory 1Gi --target-port 80 --registry-server myregistry.azurecr.io \
    --registry-username myregistry --registry-password $REGISTRY_PASSWORD \
    --location eastasia

Creare o aggiornare un pool di sessioni con tipo di contenitore CustomContainer con periodo di raffreddamento 360s

az containerapp sessionpool create -n mysessionpool -g MyResourceGroup \
    --environment MyEnvironment --cpu 0.5 --memory 1Gi --target-port 80 --container-type CustomContainer \
    --cooldown-period 360 --location eastasia

Parametri necessari

--name -n

Nome del pool di sessioni.

--resource-group -g

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

Parametri facoltativi

--args

Elenco di argomenti del comando di avvio del contenitore. Valori separati da spazi, ad esempio "-c" "mycommand". Stringa vuota per cancellare i valori esistenti.

--command

Elenco di comandi supportati nel contenitore che verrà eseguito durante l'avvio. Valori separati da spazi, ad esempio "/bin/queue" "mycommand". Stringa vuota per cancellare i valori esistenti.

--container-name

Nome del contenitore. Se non viene specificato alcun nome contenitore, il nome del contenitore verrà impostato per impostazione predefinita sul nome del pool di sessioni coperto in lettere minuscole.

--container-type

Tipo di pool del pool di sessioni, default='PythonLTS'.

Valori accettati: CustomContainer, NodeLTS, PythonLTS
--cooldown-period

Periodo (in secondi), dopo il quale la sessione verrà eliminata, valore predefinito=300.

--cpu

CPU necessaria in core da 0,25 a 2,0, ad esempio 0,5.

--env-vars

Elenco di variabili di ambiente per il contenitore. Valori separati da spazi nel formato 'key=value'. Stringa vuota per cancellare i valori esistenti. Prefisso con 'secretref:' per fare riferimento a un segreto.

--environment

Nome o ID risorsa dell'ambiente dell'app contenitore.

--image -i

Immagine del contenitore, ad esempio publisher/image-name:tag.

--location -l

Posizione. Usare i valori ottenuti con az account list-locations. È possibile configurare la posizione predefinito con az configure --defaults location=<location>.

--max-sessions

Il numero massimo di sessioni può essere eseguito contemporaneamente.

--memory

Memoria necessaria da 0,5 a 4,0 che termina con "Gi", ad esempio 1,0Gi.

--network-status

L'uscita è abilitata per le sessioni o meno.

Valori accettati: EgressDisabled, EgressEnabled
--no-wait

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

Valore predefinito: False
--ready-sessions

Numero di sessioni che saranno pronte nel pool di sessioni per tutto il tempo.

--registry-password

Password per accedere al registro contenitori. Se archiviato come segreto, il valore deve iniziare con 'secretref:' seguito dal nome del segreto.

--registry-server

Nome host del server del registro contenitori, ad esempio myregistry.azurecr.io.

--registry-username

Nome utente in cui accedere al registro contenitori.

--secrets -s

Elenco di segreti per il pool di sessioni. Valori separati da spazi nel formato 'key=value'. Stringa vuota per cancellare i valori esistenti.

--target-port

La porta di sessione usata per il traffico in ingresso.

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 posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

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

az containerapp sessionpool delete

Anteprima

Il gruppo di comandi 'containerapp sessionpool' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Eliminare un pool di sessioni.

az containerapp sessionpool delete --resource-group
                                   [--ids]
                                   [--name]
                                   [--no-wait]
                                   [--subscription]
                                   [--yes]

Esempio

Eliminare un pool di sessioni.

az containerapp sessionpool delete -n mysessionpool -g MyResourceGroup

Parametri necessari

--resource-group -g

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

Parametri facoltativi

--ids

Uno o più ID della risorsa (delimitato da spazio). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti 'ID risorsa'. È necessario specificare --ids o altri argomenti 'ID risorsa'.

--name -n

Nome del pool di sessioni.

--no-wait

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

Valore predefinito: False
--subscription

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

--yes -y

Indica che non è richiesta la conferma.

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 posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

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

az containerapp sessionpool list

Anteprima

Il gruppo di comandi 'containerapp sessionpool' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Elencare i pool di sessioni per sottoscrizione o gruppo di risorse.

az containerapp sessionpool list [--resource-group]

Esempio

Elencare i pool di sessioni nella sottoscrizione corrente.

az containerapp sessionpool list

Elencare i pool di sessioni per gruppo di risorse.

az containerapp sessionpool list -g MyResourceGroup

Parametri facoltativi

--resource-group -g

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

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 posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

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

az containerapp sessionpool show

Anteprima

Il gruppo di comandi 'containerapp sessionpool' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Mostra i dettagli di un pool di sessioni.

az containerapp sessionpool show --resource-group
                                 [--ids]
                                 [--name]
                                 [--subscription]

Esempio

Visualizzare i dettagli di un pool di sessioni.

az containerapp sessionpool show -n mysessionpool -g MyResourceGroup

Parametri necessari

--resource-group -g

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

Parametri facoltativi

--ids

Uno o più ID della risorsa (delimitato da spazio). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti 'ID risorsa'. È necessario specificare --ids o altri argomenti 'ID risorsa'.

--name -n

Nome del pool di sessioni.

--subscription

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

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 posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

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

az containerapp sessionpool update

Anteprima

Il gruppo di comandi 'containerapp sessionpool' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Aggiornare un pool di sessioni.

az containerapp sessionpool update --resource-group
                                   [--args]
                                   [--command]
                                   [--container-name]
                                   [--cooldown-period]
                                   [--cpu]
                                   [--env-vars]
                                   [--ids]
                                   [--image]
                                   [--location]
                                   [--max-sessions]
                                   [--memory]
                                   [--name]
                                   [--network-status {EgressDisabled, EgressEnabled}]
                                   [--no-wait]
                                   [--ready-sessions]
                                   [--registry-password]
                                   [--registry-server]
                                   [--registry-username]
                                   [--secrets]
                                   [--subscription]
                                   [--target-port]

Esempio

Aggiornare la configurazione e l'immagine delle sessioni simultanee massime di un pool di sessioni.

az containerapp sessionpool update -n mysessionpool -g MyResourceGroup --max-sessions 20 --image MyNewImage

Parametri necessari

--resource-group -g

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

Parametri facoltativi

--args

Elenco di argomenti del comando di avvio del contenitore. Valori separati da spazi, ad esempio "-c" "mycommand". Stringa vuota per cancellare i valori esistenti.

--command

Elenco di comandi supportati nel contenitore che verrà eseguito durante l'avvio. Valori separati da spazi, ad esempio "/bin/queue" "mycommand". Stringa vuota per cancellare i valori esistenti.

--container-name

Nome del contenitore. Se non viene specificato alcun nome contenitore, il nome del contenitore verrà impostato per impostazione predefinita sul nome del pool di sessioni coperto in lettere minuscole.

--cooldown-period

Periodo (in secondi), dopo il quale la sessione verrà eliminata, valore predefinito=300.

--cpu

CPU necessaria in core da 0,25 a 2,0, ad esempio 0,5.

--env-vars

Elenco di variabili di ambiente per il contenitore. Valori separati da spazi nel formato 'key=value'. Stringa vuota per cancellare i valori esistenti. Prefisso con 'secretref:' per fare riferimento a un segreto.

--ids

Uno o più ID della risorsa (delimitato da spazio). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti 'ID risorsa'. È necessario specificare --ids o altri argomenti 'ID risorsa'.

--image -i

Immagine del contenitore, ad esempio publisher/image-name:tag.

--location -l

Posizione. Usare i valori ottenuti con az account list-locations. È possibile configurare la posizione predefinito con az configure --defaults location=<location>.

--max-sessions

Il numero massimo di sessioni può essere eseguito contemporaneamente.

--memory

Memoria necessaria da 0,5 a 4,0 che termina con "Gi", ad esempio 1,0Gi.

--name -n

Nome del pool di sessioni.

--network-status

L'uscita è abilitata per le sessioni o meno.

Valori accettati: EgressDisabled, EgressEnabled
--no-wait

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

Valore predefinito: False
--ready-sessions

Numero di sessioni che saranno pronte nel pool di sessioni per tutto il tempo.

--registry-password

Password per accedere al registro contenitori. Se archiviato come segreto, il valore deve iniziare con 'secretref:' seguito dal nome del segreto.

--registry-server

Nome host del server del registro contenitori, ad esempio myregistry.azurecr.io.

--registry-username

Nome utente in cui accedere al registro contenitori.

--secrets -s

Elenco di segreti per il pool di sessioni. Valori separati da spazi nel formato 'key=value'. Stringa vuota per cancellare i valori esistenti.

--subscription

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

--target-port

La porta di sessione usata per il traffico in ingresso.

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 posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

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