az container

  • Referencia

Administrar Azure Container Instances.

Comandos

az container app

Comandos para administrar Azure Container Instances aplicación.
az container app up

Implemente en Azure Container Instances mediante GitHub acciones.
az container attach

Adjunte flujos de error y salida estándar locales a un contenedor de un grupo de contenedores.
az container create

Cree un grupo de contenedores.
az container delete

Elimine un grupo de contenedores.
az container exec

Ejecute un comando desde dentro de un contenedor en ejecución de un grupo de contenedores.
az container export

Exportar un grupo de contenedores en formato yaml.
az container list

Enumerar grupos de contenedores.
az container logs

Examine los registros de un contenedor en un grupo de contenedores.
az container restart

Reinicia todos los contenedores de un grupo de contenedores.
az container show

Obtenga los detalles de un grupo de contenedores.
az container start

Inicia todos los contenedores de un grupo de contenedores.
az container stop

Detiene todos los contenedores de un grupo de contenedores.

az container attach

Editar

Adjunte flujos de error y salida estándar locales a un contenedor de un grupo de contenedores.

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

--container-name

Contenedor al que se asocia. Si se omite, se elegirá el primer contenedor del grupo de contenedores.

--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 de "Id. de recurso". Debe proporcionar --ids u otros argumentos de "Id. de recurso".

--name -n

Nombre del grupo de contenedores.

--resource-group -g

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

--subscription

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

az container create

Editar

Cree un grupo de contenedores.

az container create --resource-group
                    [--assign-identity]
                    [--azure-file-volume-account-key]
                    [--azure-file-volume-account-name]
                    [--azure-file-volume-mount-path]
                    [--azure-file-volume-share-name]
                    [--command-line]
                    [--cpu]
                    [--dns-name-label]
                    [--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]
                    [--network-profile]
                    [--no-wait]
                    [--os-type {Linux, Windows}]
                    [--ports]
                    [--protocol {TCP, UDP}]
                    [--registry-login-server]
                    [--registry-password]
                    [--registry-username]
                    [--restart-policy {Always, Never, OnFailure}]
                    [--role]
                    [--scope]
                    [--secrets]
                    [--secrets-mount-path]
                    [--secure-environment-variables]
                    [--subnet]
                    [--subnet-address-prefix]
                    [--subscription]
                    [--vnet]
                    [--vnet-address-prefix]
                    [--vnet-name]

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 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 la dirección IP pública, los puertos y la 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 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 del nombre de un á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á el 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 por 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

--resource-group -g

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

Parámetros opcionales

--assign-identity

Lista separada por espacios de identidades asignadas. Las identidades asignadas son identidades asignadas por el usuario (identificadores de recursos) y/o la identidad asignada por el sistema ('[system]'). Vea ejemplos para obtener más información.

--azure-file-volume-account-key

Clave de acceso de la cuenta de almacenamiento utilizada para acceder al recurso compartido de archivos de Azure.

--azure-file-volume-account-name

Nombre de la cuenta de almacenamiento que contiene el recurso compartido de archivos de Azure.

--azure-file-volume-mount-path

Ruta de acceso dentro del contenedor donde se debe montar el volumen de archivos de Azure. No debe contener dos puntos ':'.

--azure-file-volume-share-name

Nombre del recurso compartido de archivos de Azure que se va a montar como un volumen.

--command-line

Línea de comandos que se va a ejecutar cuando se inicia el contenedor, por ejemplo, "/bin/bash -c myscript.sh".

--cpu

Número necesario de núcleos de CPU de los contenedores, con precisión en una posición decimal.

valor predeterminado: 1
--dns-name-label

Etiqueta de nombre DNS para el grupo de contenedores con dirección IP pública.

--environment-variables -e

Lista de variables de entorno para el contenedor. Valores separados por espacios en formato "key=value".

--file -f

Ruta de acceso al archivo de entrada.

--gitrepo-dir

Ruta de acceso del directorio de destino en el repositorio git. No debe contener "..".

valor predeterminado: .
--gitrepo-mount-path

Ruta de acceso dentro del contenedor donde se debe montar el volumen del repositorio git. No debe contener dos puntos ':'.

--gitrepo-revision

Hash de confirmación para la revisión especificada.

--gitrepo-url

Dirección URL de un repositorio git que se va a montar como volumen.

--image

Nombre de la imagen del contenedor.

--ip-address

Tipo de dirección IP del grupo de contenedores.

valores aceptados: Private, Public
--location -l

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

--log-analytics-workspace

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.

--log-analytics-workspace-key

Clave del área de trabajo de Log Analytics.

--memory

Memoria necesaria de los contenedores en GB, precisa de una posición decimal.

valor predeterminado: 1.5
--name -n

Nombre del grupo de contenedores.

--network-profile

Nombre o identificador del perfil de red.

--no-wait

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

--os-type

Tipo de sistema operativo de los contenedores.

valores aceptados: Linux, Windows
valor predeterminado: Linux
--ports

Lista de puertos que se abrirán. Lista de puertos separados por espacios.

valor predeterminado: [80]
--protocol

Protocolo de red que se usará.

valores aceptados: TCP, UDP
--registry-login-server

El servidor de inicio de sesión del registro de imágenes de contenedor.

--registry-password

Contraseña para iniciar sesión en el servidor del registro de imágenes de contenedor.

--registry-username

Nombre de usuario para iniciar sesión en el servidor del registro de imágenes de contenedor.

--restart-policy

Directiva de reinicio para todos los contenedores del grupo de contenedores.

valores aceptados: Always, Never, OnFailure
valor predeterminado: Always
--role

Nombre de rol o identificador que tendrá la identidad asignada por el sistema.

valor predeterminado: Contributor
--scope

Ámbito al que puede tener acceso la identidad asignada por el sistema.

--secrets

Secretos separados por espacios en formato "clave=valor".

--secrets-mount-path

Ruta de acceso dentro del contenedor donde se debe montar el volumen de secretos. No debe contener dos puntos ':'.

--secure-environment-variables

Lista de variables de entorno seguras para el contenedor. Valores separados por espacios en formato "key=value".

--subnet

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.

--subnet-address-prefix

Prefijo de dirección IP de subred que se usará al crear una nueva red virtual en formato CIDR.

valor predeterminado: 10.0.0.0/24
--subscription

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

--vnet

Nombre de la red virtual al crear una nueva o hacer referencia a una existente. También puede hacer referencia a una red virtual existente por identificador. Esto permite el uso de redes virtuales de otros grupos de recursos.

--vnet-address-prefix

Prefijo de dirección IP que se usará al crear una nueva red virtual en formato CIDR.

valor predeterminado: 10.0.0.0/16
--vnet-name

Nombre de la red virtual al crear una nueva o hacer referencia a una existente.

az container delete

Editar

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

--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 de "Id. de recurso". Debe proporcionar --ids u otros argumentos de "Id. de recurso".

--name -n

Nombre del grupo de contenedores.

--resource-group -g

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

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

az container exec

Editar

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. Este comando no se admite actualmente para Windows equipos.

az container exec --exec-command
                  [--container-name]
                  [--ids]
                  [--name]
                  [--resource-group]
                  [--subscription]

Ejemplos

Transmitir un shell desde dentro de un contenedor nginx.

az container exec -g MyResourceGroup --name mynginx --container-name nginx --exec-command "/bin/bash"

Parámetros requeridos

--exec-command

Comando que se ejecutará desde dentro del contenedor.

Parámetros opcionales

--container-name

Nombre del contenedor donde se va a ejecutar el comando. Se puede omitir para grupos de contenedores con un solo contenedor.

--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 de "Id. de recurso". Debe proporcionar --ids u otros argumentos de "Id. de recurso".

--name -n

Nombre del grupo de contenedores.

--resource-group -g

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

--subscription

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

az container export

Editar

Exportar un grupo de contenedores en formato yaml.

az container export --file
                    [--ids]
                    [--name]
                    [--resource-group]
                    [--subscription]

Ejemplos

Exportar un grupo de contenedores en yaml.

az container export -g MyResourceGroup --name mynginx -f output.yaml

Parámetros requeridos

--file -f

Ruta de acceso del archivo para exportar el grupo de contenedores.

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 de "Id. de recurso". Debe proporcionar --ids u otros argumentos de "Id. de recurso".

--name -n

Nombre del grupo de contenedores.

--resource-group -g

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

--subscription

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

az container list

Editar

Enumerar grupos de contenedores.

az container list [--query-examples]
                  [--resource-group]
                  [--subscription]

Parámetros opcionales

--query-examples

Se recomienda la cadena JMESPath. Puede copiar una de las consultas y pegarla después del parámetro --query entre comillas dobles para ver los resultados. Puede agregar una o varias palabras clave posicionales para que podamos proporcionar sugerencias basadas en estas palabras clave.

--resource-group -g

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

--subscription

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

az container logs

Editar

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

--container-name

Nombre del contenedor que se debe seguir a los registros. Si se omite, se elegirá el primer contenedor del grupo de contenedores.

--follow

Indique que se transmita el final de los registros.

--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 de "Id. de recurso". Debe proporcionar --ids u otros argumentos de "Id. de recurso".

--name -n

Nombre del grupo de contenedores.

--resource-group -g

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

--subscription

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

az container restart

Editar

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]
                     [--subscription]

Parámetros requeridos

--name -n

Nombre del grupo de contenedores.

--resource-group -g

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

Parámetros opcionales

--no-wait

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

--subscription

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

az container show

Editar

Obtenga los detalles de un grupo de contenedores.

az container show [--ids]
                  [--name]
                  [--query-examples]
                  [--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

--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 de "Id. de recurso". Debe proporcionar --ids u otros argumentos de "Id. de recurso".

--name -n

Nombre del grupo de contenedores.

--query-examples

Se recomienda la cadena JMESPath. Puede copiar una de las consultas y pegarla después del parámetro --query entre comillas dobles para ver los resultados. Puede agregar una o varias palabras clave posicionales para que podamos proporcionar sugerencias basadas en estas palabras clave.

--resource-group -g

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

--subscription

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

az container start

Editar

Inicia todos los contenedores de un grupo de contenedores.

Inicia todos los contenedores de un grupo de contenedores.

az container start --name
                   --resource-group
                   [--no-wait]
                   [--subscription]

Parámetros requeridos

--name -n

Nombre del grupo de contenedores.

--resource-group -g

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

Parámetros opcionales

--no-wait

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

--subscription

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

az container stop

Editar

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
                  [--subscription]

Parámetros requeridos

--name -n

Nombre del grupo de contenedores.

--resource-group -g

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

Parámetros opcionales

--subscription

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