az container
Nota:
Este grupo de comandos tiene comandos definidos en la CLI de Azure y al menos una extensión. Instale cada extensión para beneficiarse de sus funcionalidades extendidas. Obtenga más información sobre las extensiones.
Administración de Azure Container Instances.
Comandos
Nombre | Description | Tipo | Estado |
---|---|---|---|
az container app |
Comandos para administrar la aplicación Azure Container Instances. |
Extensión | Versión preliminar |
az container app up |
Implemente en Azure Container Instances mediante Acciones de GitHub. |
Extensión | Versión preliminar |
az container attach |
Adjunte flujos de error y salida estándar locales a un contenedor de un grupo de contenedores. Este comando proporciona información de diagnóstico durante el inicio del contenedor. Una vez que el contenedor se ha iniciado, transmite STDOUT y STDERR a la consola local. |
Core | GA |
az container create |
Cree un grupo de contenedores. |
Core | GA |
az container delete |
Elimine un grupo de contenedores. |
Core | GA |
az container exec |
Ejecute un comando desde dentro de un contenedor en ejecución de un grupo de contenedores. |
Core | GA |
az container export |
Exporte un grupo de contenedores en formato yaml. |
Core | GA |
az container list |
Enumerar grupos de contenedores. |
Core | GA |
az container logs |
Examine los registros de un contenedor en un grupo de contenedores. |
Core | GA |
az container restart |
Reinicia todos los contenedores de un grupo de contenedores. |
Core | GA |
az container show |
Obtenga los detalles de un grupo de contenedores. |
Core | GA |
az container start |
Inicia todos los contenedores de un grupo de contenedores. |
Core | GA |
az container stop |
Detiene todos los contenedores de un grupo de contenedores. |
Core | GA |
az container attach
Adjunte flujos de error y salida estándar locales a un contenedor de un grupo de contenedores. Este comando proporciona información de diagnóstico durante el inicio del contenedor. Una vez que el contenedor se ha iniciado, transmite STDOUT y STDERR a la consola local.
az container attach [--container-name]
[--ids]
[--name]
[--resource-group]
[--subscription]
Ejemplos
Adjunte flujos de error y salida estándar locales a un contenedor de un grupo de contenedores. (generado automáticamente)
az container attach --name MyContainerGroup --resource-group MyResourceGroup
Parámetros opcionales
Contenedor al que se va a asociar. Si se omite, se elegirá el primer contenedor del grupo de contenedores.
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".
Nombre del grupo de contenedores.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>
.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.
az container create
Cree un grupo de contenedores.
az container create --resource-group
[--acr-identity]
[--add-capabilities]
[--allow-escalation]
[--assign-identity]
[--azure-file-volume-account-key]
[--azure-file-volume-account-name]
[--azure-file-volume-mount-path]
[--azure-file-volume-share-name]
[--cce-policy]
[--command-line]
[--cpu]
[--dns-name-label]
[--drop-capabilities]
[--environment-variables]
[--file]
[--gitrepo-dir]
[--gitrepo-mount-path]
[--gitrepo-revision]
[--gitrepo-url]
[--image]
[--ip-address {Private, Public}]
[--location]
[--log-analytics-workspace]
[--log-analytics-workspace-key]
[--memory]
[--name]
[--no-wait]
[--os-type {Linux, Windows}]
[--ports]
[--priority]
[--privileged]
[--protocol {TCP, UDP}]
[--registry-login-server]
[--registry-password]
[--registry-username]
[--restart-policy {Always, Never, OnFailure}]
[--role]
[--run-as-group]
[--run-as-user]
[--scope]
[--seccomp-profile]
[--secrets]
[--secrets-mount-path]
[--secure-environment-variables]
[--sku]
[--subnet]
[--subnet-address-prefix]
[--vnet]
[--vnet-address-prefix]
[--vnet-name]
[--zone]
Ejemplos
Cree un contenedor en un grupo de contenedores con 1 núcleo y 1 Gb de memoria.
az container create -g MyResourceGroup --name myapp --image myimage:latest --cpu 1 --memory 1
Cree un contenedor en un grupo de contenedores que ejecute Windows, con 2 núcleos y 3,5 Gb de memoria.
az container create -g MyResourceGroup --name mywinapp --image winappimage:latest --os-type Windows --cpu 2 --memory 3.5
Cree un contenedor en un grupo de contenedores con dirección IP pública, puertos y etiqueta de nombre DNS.
az container create -g MyResourceGroup --name myapp --image myimage:latest --ports 80 443 --dns-name-label contoso
Cree un contenedor en un grupo de contenedores que invoque un script al iniciarse.
az container create -g MyResourceGroup --name myapp --image myimage:latest --command-line "/bin/sh -c '/path to/myscript.sh'"
Cree un contenedor en un grupo de contenedores que ejecute un comando y detenga el contenedor después.
az container create -g MyResourceGroup --name myapp --image myimage:latest --command-line "echo hello" --restart-policy Never
Cree un contenedor en un grupo de contenedores con variables de entorno.
az container create -g MyResourceGroup --name myapp --image myimage:latest --environment-variables key1=value1 key2=value2
Cree un contenedor en un grupo de contenedores mediante la imagen de contenedor de Azure Container Registry.
az container create -g MyResourceGroup --name myapp --image myAcrRegistry.azurecr.io/myimage:latest --registry-password password
Cree un contenedor en un grupo de contenedores que monte un recurso compartido de archivos de Azure como volumen.
az container create -g MyResourceGroup --name myapp --image myimage:latest --command-line "cat /mnt/azfile/myfile" --azure-file-volume-share-name myshare --azure-file-volume-account-name mystorageaccount --azure-file-volume-account-key mystoragekey --azure-file-volume-mount-path /mnt/azfile
Cree un contenedor en un grupo de contenedores que monte un repositorio de Git como volumen.
az container create -g MyResourceGroup --name myapp --image myimage:latest --command-line "cat /mnt/gitrepo" --gitrepo-url https://github.com/user/myrepo.git --gitrepo-dir ./dir1 --gitrepo-mount-path /mnt/gitrepo
Cree un contenedor en un grupo de contenedores mediante un archivo yaml.
az container create -g MyResourceGroup -f containerGroup.yaml
Cree un grupo de contenedores mediante Log Analytics a partir de un nombre de área de trabajo.
az container create -g MyResourceGroup --name myapp --log-analytics-workspace myworkspace
Cree un grupo de contenedores con una identidad asignada por el sistema.
az container create -g MyResourceGroup --name myapp --image myimage:latest --assign-identity
Cree un grupo de contenedores con una identidad asignada por el sistema. El grupo tendrá un rol "Colaborador" con acceso a una cuenta de almacenamiento.
az container create -g MyResourceGroup --name myapp --image myimage:latest --assign-identity --scope /subscriptions/99999999-1bf0-4dda-aec3-cb9272f09590/MyResourceGroup/myRG/providers/Microsoft.Storage/storageAccounts/storage1
Cree un grupo de contenedores con una identidad asignada por el usuario.
az container create -g MyResourceGroup --name myapp --image myimage:latest --assign-identity /subscriptions/mySubscriptionId/resourcegroups/myRG/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myID
Cree un grupo de contenedores con la identidad asignada por el sistema y el usuario.
az container create -g MyResourceGroup --name myapp --image myimage:latest --assign-identity [system] /subscriptions/mySubscriptionId/resourcegroups/myRG/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myID
Parámetros requeridos
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>
.
Parámetros opcionales
Identidad con acceso al registro de contenedor.
Lista de funcionalidades de contexto de seguridad que se van a agregar.
Permitir si un proceso puede obtener más privilegios que su proceso primario.
Lista separada por espacios de identidades asignadas. Las identidades asignadas son identidades asignadas por el usuario (identificadores de recursos) o la identidad asignada por el sistema ("[sistema]"). Consulta ejemplos para obtener más información.
Clave de acceso de la cuenta de almacenamiento utilizada para acceder al recurso compartido de archivos de Azure.
Nombre de la cuenta de almacenamiento que contiene el recurso compartido de archivos de Azure.
Ruta de acceso dentro del contenedor donde se debe montar el volumen de archivos de Azure. No debe contener dos puntos ':'.
Nombre del recurso compartido de archivos de Azure que se va a montar como un volumen.
Directiva de CCE para el grupo de contenedores confidencial.
Línea de comandos que se va a ejecutar cuando se inicia el contenedor, por ejemplo, "/bin/bash -c myscript.sh".
Número necesario de núcleos de CPU de los contenedores, precisos en un decimal.
Etiqueta de nombre dns para el grupo de contenedores con dirección IP pública.
Lista de funcionalidades de contexto de seguridad que se van a quitar.
Lista de variables de entorno para el contenedor. Valores separados por espacios en formato 'key=value'.
Ruta de acceso al archivo de entrada.
Ruta de acceso del directorio de destino en el repositorio de Git. No debe contener '..'.
Ruta de acceso dentro del contenedor donde se debe montar el volumen del repositorio de Git. No debe contener dos puntos ':'.
Hash de confirmación para la revisión especificada.
Dirección URL de un repositorio git que se va a montar como un volumen.
Nombre de la imagen de contenedor.
Tipo de dirección IP del grupo de contenedores.
Ubicación. Los valores de: az account list-locations
. Puede configurar la ubicación predeterminada mediante az configure --defaults location=<location>
.
Nombre o identificador del área de trabajo de Log Analytics. Use la suscripción actual o use la marca --subscription para establecer la suscripción deseada.
Clave del área de trabajo de Log Analytics.
La memoria necesaria de los contenedores en GB, precisa de una posición decimal.
Nombre del grupo de contenedores.
No espere hasta que finalice la operación de ejecución prolongada.
El tipo de sistema operativo de los contenedores.
Lista de puertos que se van a abrir. Lista separada por espacios de puertos.
Prioridad del grupo de contenedores.
Marca para determinar si los permisos de contenedor se elevan a Privileged.
Protocolo de red que se va a usar.
Servidor de inicio de sesión del registro de imágenes de contenedor.
Contraseña para iniciar sesión en el servidor del registro de imágenes de contenedor.
Nombre de usuario que se va a iniciar sesión en el servidor del registro de imágenes de contenedor.
Directiva de reinicio para todos los contenedores del grupo de contenedores.
Nombre de rol o identificador que tendrá la identidad asignada por el sistema.
Establezca el UID de usuario del contenedor.
Establezca el GID de usuario para el contenedor.
Ámbito al que puede acceder la identidad asignada por el sistema.
Cadena codificada en base64 que contiene el contenido del json en el perfil de seccomp.
Secretos separados por espacios en formato "key=value".
Ruta de acceso dentro del contenedor donde se debe montar el volumen de secretos. No debe contener dos puntos ':'.
Lista de variables de entorno seguras para el contenedor. Valores separados por espacios en formato 'key=value'.
SKU del grupo de contenedores.
Nombre de la subred al crear una nueva red virtual o hacer referencia a una existente. También puede hacer referencia a una subred existente por identificador.
Prefijo de dirección IP de subred que se va a usar al crear una nueva red virtual en formato CIDR.
Nombre de la red virtual al crear uno o hacer referencia a uno existente. También puede hacer referencia a una red virtual existente por identificador. Esto permite usar redes virtuales de otros grupos de recursos.
Prefijo de dirección IP que se va a usar al crear una red virtual en formato CIDR.
El argumento "vnet_name" está en desuso y se quitará en una versión futura. Use "--vnet" en su lugar.
Nombre de la red virtual al crear uno o hacer referencia a uno existente.
Zona que se va a colocar el grupo de contenedores.
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.
az container delete
Elimine un grupo de contenedores.
az container delete [--ids]
[--name]
[--resource-group]
[--subscription]
[--yes]
Ejemplos
Elimine un grupo de contenedores. (generado automáticamente)
az container delete --name MyContainerGroup --resource-group MyResourceGroup
Parámetros opcionales
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".
Nombre del grupo de contenedores.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>
.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
No solicita confirmación.
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.
az container exec
Ejecute un comando desde dentro de un contenedor en ejecución de un grupo de contenedores.
El caso de uso más común es abrir un shell de Bash interactivo. Vea los ejemplos siguientes.
az container exec --exec-command
[--container-name]
[--ids]
[--name]
[--resource-group]
[--subscription]
Ejemplos
Transmita un shell desde un contenedor nginx.
az container exec -g MyResourceGroup --name mynginx --container-name nginx --exec-command "/bin/bash"
Parámetros requeridos
Comando que se va a ejecutar desde dentro del contenedor.
Parámetros opcionales
Nombre del contenedor donde se va a ejecutar el comando. Se puede omitir para los grupos de contenedores con solo un contenedor.
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".
Nombre del grupo de contenedores.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>
.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.
az container export
Exporte un grupo de contenedores en formato yaml.
az container export --file
[--ids]
[--name]
[--resource-group]
[--subscription]
Ejemplos
Exporte un grupo de contenedores en yaml.
az container export -g MyResourceGroup --name mynginx -f output.yaml
Parámetros requeridos
Ruta de acceso del archivo para exportar el grupo de contenedores.
Parámetros opcionales
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".
Nombre del grupo de contenedores.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>
.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.
az container list
Enumerar grupos de contenedores.
az container list [--resource-group]
Parámetros opcionales
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>
.
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.
az container logs
Examine los registros de un contenedor en un grupo de contenedores.
az container logs [--container-name]
[--follow]
[--ids]
[--name]
[--resource-group]
[--subscription]
Ejemplos
Examine los registros de un contenedor en un grupo de contenedores. (generado automáticamente)
az container logs --name MyContainerGroup --resource-group MyResourceGroup
Parámetros opcionales
Nombre del contenedor que se va a poner al final de los registros. Si se omite, se elegirá el primer contenedor del grupo de contenedores.
Indique que transmite los registros finales.
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".
Nombre del grupo de contenedores.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>
.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.
az container restart
Reinicia todos los contenedores de un grupo de contenedores.
Reinicia todos los contenedores de un grupo de contenedores en su lugar. Si la imagen de contenedor tiene actualizaciones, se descargará la nueva imagen.
az container restart --name
--resource-group
[--no-wait]
Parámetros requeridos
Nombre del grupo de contenedores.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>
.
Parámetros opcionales
No espere hasta que finalice la operación de ejecución prolongada.
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.
az container show
Obtenga los detalles de un grupo de contenedores.
az container show [--ids]
[--name]
[--resource-group]
[--subscription]
Ejemplos
Obtenga los detalles de un grupo de contenedores. (generado automáticamente)
az container show --name MyContainerGroup --resource-group MyResourceGroup
Parámetros opcionales
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".
Nombre del grupo de contenedores.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>
.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.
az container start
Inicia todos los contenedores de un grupo de contenedores.
Inicia todos los contenedores de un grupo de contenedores. Los recursos de proceso se asignarán y se iniciará la facturación.
az container start --name
--resource-group
[--no-wait]
Parámetros requeridos
Nombre del grupo de contenedores.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>
.
Parámetros opcionales
No espere hasta que finalice la operación de ejecución prolongada.
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.
az container stop
Detiene todos los contenedores de un grupo de contenedores.
Detiene todos los contenedores de un grupo de contenedores. Los recursos de proceso se desasignarán y la facturación se detendrá.
az container stop --name
--resource-group
Parámetros requeridos
Nombre del grupo de contenedores.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>
.
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.