az containerapp sessionpool

Nota:

Esta referencia forma parte de la extensión containerapp para la CLI de Azure (versión 2.62.0 o posterior). La extensión instalará automáticamente la primera vez que ejecute un comando az containerapp sessionpool . Obtenga más información sobre las extensiones.

Este grupo de comandos está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Comandos para administrar grupos de sesiones.

Comandos

Nombre Description Tipo Estado
az containerapp sessionpool create

Cree o actualice un grupo de sesiones.

Extensión Vista previa
az containerapp sessionpool delete

Elimine un grupo de sesiones.

Extensión Vista previa
az containerapp sessionpool list

Enumera los grupos de sesiones por suscripción o grupo de recursos.

Extensión Vista previa
az containerapp sessionpool show

Mostrar detalles de un grupo de sesiones.

Extensión Vista previa
az containerapp sessionpool update

Actualizar un grupo de sesiones.

Extensión Vista previa

az containerapp sessionpool create

Vista previa

El grupo de comandos "containerapp sessionpool" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Cree o actualice un grupo de sesiones.

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]

Ejemplos

Cree o actualice un grupo de sesiones con la configuración predeterminada de PythonLTS de tipo contenedor.

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

Cree o actualice un grupo de sesiones con el tipo de contenedor PythonLTS, con sesiones simultáneas máximas es de 30 instancias de sesión listas para 20.

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

Cree o actualice un grupo de sesiones con el tipo de contenedor CustomContainer con la imagen de inicio rápido predeterminada.

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

Cree o actualice un grupo de sesiones con el tipo de contenedor CustomContainer que tenga secretos y variables de entorno.

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

Creación o actualización de un grupo de sesiones con el tipo de contenedor CustomContainer que procede del registro privado

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

Crear o actualizar un grupo de sesiones con el tipo de contenedor CustomContainer con período de tiempo de recuperación 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

Parámetros requeridos

--name -n

Nombre del grupo de sesiones.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

--args

Lista de argumentos de comando de inicio de contenedor. Valores separados por espacios, por ejemplo, "-c" "mycommand". Cadena vacía para borrar los valores existentes.

--command

Lista de comandos admitidos en el contenedor que se ejecutará durante el inicio. Valores separados por espacios, por ejemplo, "/bin/queue" "mycommand". Cadena vacía para borrar los valores existentes.

--container-name

Nombre del contenedor. Al crear si no se proporciona ningún nombre de contenedor, el nombre del contenedor tendrá como valor predeterminado el nombre del grupo de sesiones cubierto en minúsculas.

--container-type

Tipo de grupo del grupo de sesiones, default='PythonLTS'.

Valores aceptados: CustomContainer, NodeLTS, PythonLTS
--cooldown-period

Período (en segundos), después del cual se eliminará la sesión, default=300.

--cpu

CPU necesaria en núcleos de 0,25 a 2,0, por ejemplo, 0,5.

--env-vars

Lista de variables de entorno para el contenedor. Valores separados por espacios en formato 'key=value'. Cadena vacía para borrar los valores existentes. Valor de prefijo con "secretref:" para hacer referencia a un secreto.

--environment

Nombre o identificador de recurso del entorno de la aplicación contenedora.

--image -i

Imagen de contenedor, por ejemplo, publisher/image-name:tag.

--location -l

Ubicación. Los valores de: az account list-locations. Puede configurar la ubicación predeterminada mediante az configure --defaults location=<location>.

--max-sessions

El recuento máximo de sesiones se puede ejecutar al mismo tiempo.

--memory

Memoria necesaria de 0,5 a 4,0 que termina con "Gi", por ejemplo, 1,0Gi.

--network-status

La salida está habilitada para las sesiones o no.

Valores aceptados: EgressDisabled, EgressEnabled
--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

Valor predeterminado: False
--ready-sessions

Número de sesiones que estarán listas en el grupo de sesiones todo el tiempo.

--registry-password

Contraseña para iniciar sesión en el registro de contenedor. Si se almacena como secreto, el valor debe comenzar con "secretref:" seguido del nombre del secreto.

--registry-server

Nombre de host del servidor del registro de contenedor, por ejemplo, myregistry.azurecr.io.

--registry-username

Nombre de usuario que se va a iniciar sesión en el registro de contenedor.

--secrets -s

Lista de secretos para el grupo de sesiones. Valores separados por espacios en formato 'key=value'. Cadena vacía para borrar los valores existentes.

--target-port

Puerto de sesión usado para el tráfico de entrada.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az containerapp sessionpool delete

Vista previa

El grupo de comandos "containerapp sessionpool" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Elimine un grupo de sesiones.

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

Ejemplos

Elimine un grupo de sesiones.

az containerapp sessionpool delete -n mysessionpool -g MyResourceGroup

Parámetros requeridos

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--name -n

Nombre del grupo de sesiones.

--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

Valor predeterminado: False
--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--yes -y

No solicita confirmación.

Valor predeterminado: False
Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az containerapp sessionpool list

Vista previa

El grupo de comandos "containerapp sessionpool" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Enumera los grupos de sesiones por suscripción o grupo de recursos.

az containerapp sessionpool list [--resource-group]

Ejemplos

Enumera los grupos de sesiones de la suscripción actual.

az containerapp sessionpool list

Enumera los grupos de sesiones por grupo de recursos.

az containerapp sessionpool list -g MyResourceGroup

Parámetros opcionales

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az containerapp sessionpool show

Vista previa

El grupo de comandos "containerapp sessionpool" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Mostrar detalles de un grupo de sesiones.

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

Ejemplos

Muestra los detalles de un grupo de sesiones.

az containerapp sessionpool show -n mysessionpool -g MyResourceGroup

Parámetros requeridos

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--name -n

Nombre del grupo de sesiones.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az containerapp sessionpool update

Vista previa

El grupo de comandos "containerapp sessionpool" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Actualizar un grupo de sesiones.

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]

Ejemplos

Actualice la configuración y la imagen de las sesiones simultáneas máximas de un grupo de sesiones.

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

Parámetros requeridos

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

--args

Lista de argumentos de comando de inicio de contenedor. Valores separados por espacios, por ejemplo, "-c" "mycommand". Cadena vacía para borrar los valores existentes.

--command

Lista de comandos admitidos en el contenedor que se ejecutará durante el inicio. Valores separados por espacios, por ejemplo, "/bin/queue" "mycommand". Cadena vacía para borrar los valores existentes.

--container-name

Nombre del contenedor. Al crear si no se proporciona ningún nombre de contenedor, el nombre del contenedor tendrá como valor predeterminado el nombre del grupo de sesiones cubierto en minúsculas.

--cooldown-period

Período (en segundos), después del cual se eliminará la sesión, default=300.

--cpu

CPU necesaria en núcleos de 0,25 a 2,0, por ejemplo, 0,5.

--env-vars

Lista de variables de entorno para el contenedor. Valores separados por espacios en formato 'key=value'. Cadena vacía para borrar los valores existentes. Valor de prefijo con "secretref:" para hacer referencia a un secreto.

--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--image -i

Imagen de contenedor, por ejemplo, publisher/image-name:tag.

--location -l

Ubicación. Los valores de: az account list-locations. Puede configurar la ubicación predeterminada mediante az configure --defaults location=<location>.

--max-sessions

El recuento máximo de sesiones se puede ejecutar al mismo tiempo.

--memory

Memoria necesaria de 0,5 a 4,0 que termina con "Gi", por ejemplo, 1,0Gi.

--name -n

Nombre del grupo de sesiones.

--network-status

La salida está habilitada para las sesiones o no.

Valores aceptados: EgressDisabled, EgressEnabled
--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

Valor predeterminado: False
--ready-sessions

Número de sesiones que estarán listas en el grupo de sesiones todo el tiempo.

--registry-password

Contraseña para iniciar sesión en el registro de contenedor. Si se almacena como secreto, el valor debe comenzar con "secretref:" seguido del nombre del secreto.

--registry-server

Nombre de host del servidor del registro de contenedor, por ejemplo, myregistry.azurecr.io.

--registry-username

Nombre de usuario que se va a iniciar sesión en el registro de contenedor.

--secrets -s

Lista de secretos para el grupo de sesiones. Valores separados por espacios en formato 'key=value'. Cadena vacía para borrar los valores existentes.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--target-port

Puerto de sesión usado para el tráfico de entrada.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.