Partager via

az containerapp sessionpool

  • Préversion
  • Référence

Remarque

Cette référence fait partie de l’extension containerapp pour Azure CLI (version 2.62.0 ou ultérieure). L’extension installe automatiquement la première fois que vous exécutez une commande az containerapp sessionpool . Apprenez-en davantage sur les extensions.

Ce groupe de commandes est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Commandes pour gérer les pools de sessions.

Commandes

Nom Description Type État
az containerapp sessionpool create

Créez ou mettez à jour un pool de sessions.

 Extension Aperçu
az containerapp sessionpool delete

Supprimez un pool de sessions.

 Extension Aperçu
az containerapp sessionpool list

Répertorier les pools de sessions par abonnement ou groupe de ressources.

 Extension Aperçu
az containerapp sessionpool show

Afficher les détails d’un pool de sessions.

 Extension Aperçu
az containerapp sessionpool update

Mettez à jour un pool de sessions.

 Extension Aperçu

az containerapp sessionpool create

Préversion

Le groupe de commandes « containerapp sessionpool » est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Créez ou mettez à jour un pool de sessions.

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]

Exemples

Créez ou mettez à jour un pool de sessions avec les paramètres par défaut pythonLTS de type conteneur.

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

Créer ou mettre à jour un pool de sessions avec le type de conteneur PythonLTS, avec une durée maximale de 30 sessions simultanées est de 30 instances de session prêtes 20.

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

Créez ou mettez à jour un pool de sessions avec le type de conteneur CustomContainer avec l’image de démarrage rapide par défaut.

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

Créez ou mettez à jour un pool de sessions avec le type de conteneur CustomContainer qui a des secrets et des variables d’environnement.

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

Créer ou mettre à jour un pool de sessions avec le type de conteneur CustomContainer à partir du registre privé

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

Créer ou mettre à jour un pool de sessions avec le type de conteneur CustomContainer et l’identité managée pour authentifier Azure Container Registry

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

Créez ou mettez à jour un pool de sessions avec le type de conteneur CustomContainer avec l’identité affectée par le système et l’identité affectée par l’utilisateur.

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

Créer ou mettre à jour un pool de sessions avec le type de conteneur CustomContainer avec la période de refroidissement 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

Paramètres obligatoires

--name -n

Nom du pool de sessions.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres facultatifs

--args

Liste des arguments de commande de démarrage du conteneur. Valeurs séparées par l’espace, par exemple « -c » « mycommand ». Chaîne vide pour effacer les valeurs existantes.

--command

Liste des commandes prises en charge sur le conteneur qui seront exécutées au démarrage. Valeurs séparées par l’espace, par exemple « /bin/queue » « mycommand ». Chaîne vide pour effacer les valeurs existantes.

--container-name

Nom du conteneur. Lors de la création si aucun nom de conteneur n’est fourni, le nom du conteneur est défini par défaut sur le nom du pool de sessions couvert en minuscules.

--container-type

Type de pool du pool de sessions, default='PythonLTS'.

Valeurs acceptées: CustomContainer, NodeLTS, PythonLTS
--cooldown-period

Période (en secondes), après laquelle la session sera supprimée, par défaut= 300.

--cpu

Processeur requis dans les cœurs de 0,25 à 2,0, par exemple 0,5.

--env-vars

Liste des variables d’environnement pour le conteneur. Valeurs séparées par l’espace au format « key=value ». Chaîne vide pour effacer les valeurs existantes. Valeur de préfixe avec ' secretref :' pour référencer un secret.

--environment

Nom ou ID de ressource de l’environnement de l’application conteneur.

--image -i

Image conteneur, par exemple publisher/image-name :tag.

--location -l

Emplacement. Valeurs provenant de : az account list-locations. Vous pouvez configurer le lieu par défaut en utilisant az configure --defaults location=<location>.

--max-sessions

Le nombre maximal de sessions peut être exécuté en même temps.

--memory

Mémoire requise comprise entre 0,5 et 4,0 se terminant par « Gi », par exemple 1,0Gi.

--mi-system-assigned

Boolean indiquant s’il faut attribuer une identité affectée par le système.

Valeur par défaut: False
--mi-user-assigned

Identités utilisateur séparées par l’espace à attribuer.

--network-status

La sortie est activée pour les sessions ou non.

Valeurs acceptées: EgressDisabled, EgressEnabled
--no-wait

Ne pas attendre la fin de l’opération de longue durée.

Valeur par défaut: False
--ready-sessions

Nombre de sessions prêtes dans le pool de sessions à tout moment.

--registry-identity

Identité managée avec laquelle s’authentifier auprès d’Azure Container Registry (au lieu du nom d’utilisateur/mot de passe). Utilisez « système » pour une identité affectée par le système, utilisez un ID de ressource pour une identité affectée par l’utilisateur. L’identité managée doit avoir été affectée aux autorisations acrpull sur l’ACR avant le déploiement (utilisez « az role assignment create --role acrpull ... »).

--registry-password

Mot de passe à connecter au registre de conteneurs. Si elle est stockée en tant que secret, la valeur doit commencer par « secretref : » suivie du nom du secret.

--registry-server

Nom d’hôte du serveur de registre de conteneurs, par exemple myregistry.azurecr.io.

--registry-username

Nom d’utilisateur à connecter au registre de conteneurs.

--secrets -s

Liste des secrets du pool de sessions. Valeurs séparées par l’espace au format « key=value ». Chaîne vide pour effacer les valeurs existantes.

--target-port

Port de session utilisé pour le trafic d’entrée.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
Valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az containerapp sessionpool delete

Préversion

Le groupe de commandes « containerapp sessionpool » est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Supprimez un pool de sessions.

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

Exemples

Supprimez un pool de sessions.

az containerapp sessionpool delete -n mysessionpool -g MyResourceGroup

Paramètres obligatoires

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres facultatifs

--ids

Un ou plusieurs ID de ressource (délimités par des espaces). Il doit s’agir d’un ID de ressource complet contenant toutes les informations des arguments « ID de ressource ». Vous devez fournir des arguments --id ou d’autres arguments « ID de ressource ».

--name -n

Nom du pool de sessions.

--no-wait

Ne pas attendre la fin de l’opération de longue durée.

Valeur par défaut: False
--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--yes -y

Ne pas demander de confirmation.

Valeur par défaut: False
Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
Valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az containerapp sessionpool list

Préversion

Le groupe de commandes « containerapp sessionpool » est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Répertorier les pools de sessions par abonnement ou groupe de ressources.

az containerapp sessionpool list [--resource-group]

Exemples

Répertorier les pools de sessions dans l’abonnement actuel.

az containerapp sessionpool list

Répertorier les pools de sessions par groupe de ressources.

az containerapp sessionpool list -g MyResourceGroup

Paramètres facultatifs

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
Valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az containerapp sessionpool show

Préversion

Le groupe de commandes « containerapp sessionpool » est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Afficher les détails d’un pool de sessions.

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

Exemples

Affichez les détails d’un pool de sessions.

az containerapp sessionpool show -n mysessionpool -g MyResourceGroup

Paramètres obligatoires

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres facultatifs

--ids

Un ou plusieurs ID de ressource (délimités par des espaces). Il doit s’agir d’un ID de ressource complet contenant toutes les informations des arguments « ID de ressource ». Vous devez fournir des arguments --id ou d’autres arguments « ID de ressource ».

--name -n

Nom du pool de sessions.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
Valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az containerapp sessionpool update

Préversion

Le groupe de commandes « containerapp sessionpool » est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Mettez à jour un pool de sessions.

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]

Exemples

Mettez à jour la configuration et l’image maximales d’un pool de sessions simultanées.

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

Paramètres obligatoires

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres facultatifs

--args

Liste des arguments de commande de démarrage du conteneur. Valeurs séparées par l’espace, par exemple « -c » « mycommand ». Chaîne vide pour effacer les valeurs existantes.

--command

Liste des commandes prises en charge sur le conteneur qui seront exécutées au démarrage. Valeurs séparées par l’espace, par exemple « /bin/queue » « mycommand ». Chaîne vide pour effacer les valeurs existantes.

--container-name

Nom du conteneur. Lors de la création si aucun nom de conteneur n’est fourni, le nom du conteneur est défini par défaut sur le nom du pool de sessions couvert en minuscules.

--cooldown-period

Période (en secondes), après laquelle la session sera supprimée, par défaut= 300.

--cpu

Processeur requis dans les cœurs de 0,25 à 2,0, par exemple 0,5.

--env-vars

Liste des variables d’environnement pour le conteneur. Valeurs séparées par l’espace au format « key=value ». Chaîne vide pour effacer les valeurs existantes. Valeur de préfixe avec ' secretref :' pour référencer un secret.

--ids

Un ou plusieurs ID de ressource (délimités par des espaces). Il doit s’agir d’un ID de ressource complet contenant toutes les informations des arguments « ID de ressource ». Vous devez fournir des arguments --id ou d’autres arguments « ID de ressource ».

--image -i

Image conteneur, par exemple publisher/image-name :tag.

--location -l

Emplacement. Valeurs provenant de : az account list-locations. Vous pouvez configurer le lieu par défaut en utilisant az configure --defaults location=<location>.

--max-sessions

Le nombre maximal de sessions peut être exécuté en même temps.

--memory

Mémoire requise comprise entre 0,5 et 4,0 se terminant par « Gi », par exemple 1,0Gi.

--name -n

Nom du pool de sessions.

--network-status

La sortie est activée pour les sessions ou non.

Valeurs acceptées: EgressDisabled, EgressEnabled
--no-wait

Ne pas attendre la fin de l’opération de longue durée.

Valeur par défaut: False
--ready-sessions

Nombre de sessions prêtes dans le pool de sessions à tout moment.

--registry-password

Mot de passe à connecter au registre de conteneurs. Si elle est stockée en tant que secret, la valeur doit commencer par « secretref : » suivie du nom du secret.

--registry-server

Nom d’hôte du serveur de registre de conteneurs, par exemple myregistry.azurecr.io.

--registry-username

Nom d’utilisateur à connecter au registre de conteneurs.

--secrets -s

Liste des secrets du pool de sessions. Valeurs séparées par l’espace au format « key=value ». Chaîne vide pour effacer les valeurs existantes.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--target-port

Port de session utilisé pour le trafic d’entrée.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
Valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.