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]
                                   [--mi-system-assigned]
                                   [--mi-user-assigned]
                                   [--network-status {EgressDisabled, EgressEnabled}]
                                   [--no-wait]
                                   [--ready-sessions]
                                   [--registry-identity]
                                   [--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 il tipo di contenitore CustomContainer e l'identità gestita per autenticare il Registro Azure Container

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-identity  MyUserIdentityResourceId \
    --location eastasia

Creare o aggiornare un pool di sessioni con tipo di contenitore CustomContainer con identità assegnata dal sistema e assegnata dall'utente.

az containerapp sessionpool create -n mysessionpool -g MyResourceGroup \
    --container-type CustomContainer --environment MyEnvironment --image MyImage \
    --cpu 0.5 --memory 1Gi --target-port 80 \
    --mi-system-assigned --mi-user-assigned MyUserIdentityResourceId \
    --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.

--mi-system-assigned

Valore booleano che indica se assegnare un'identità assegnata dal sistema.

Valore predefinito: False
--mi-user-assigned

Identità utente separate da spazi da assegnare.

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

Identità gestita con cui eseguire l'autenticazione al Registro Azure Container (anziché nome utente/password). Usare "system" per un'identità assegnata dal sistema, usare un ID risorsa per un'identità assegnata dall'utente. L'identità gestita deve essere stata assegnata alle autorizzazioni acrpull nel Registro Azure Container prima della distribuzione (usare 'az role assignment create --role acrpull ...').

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