az container
Nota
Este grupo de comandos tem comandos definidos na CLI do Azure e em pelo menos uma extensão. Instale cada extensão para se beneficiar de seus recursos estendidos. Saiba mais sobre extensões.
Gerencie instâncias de contêiner do Azure.
Comandos
Name | Description | Tipo | Status |
---|---|---|---|
az container app |
Comandos para gerenciar o aplicativo de instâncias de contêiner do Azure. |
Extensão | Pré-visualizar |
az container app up |
Implante em instâncias de contêiner do Azure usando ações do GitHub. |
Extensão | Pré-visualizar |
az container attach |
Anexe fluxos de saída e erro padrão local a um contêiner em um grupo de contêineres. Este comando fornece informações de diagnóstico durante a inicialização do contêiner. Depois que o contêiner for iniciado, ele transmitirá STDOUT e STDERR para o console local. |
Principal | GA |
az container create |
Crie um grupo de contêineres. |
Principal | GA |
az container delete |
Exclua um grupo de contêineres. |
Principal | GA |
az container exec |
Execute um comando de dentro de um contêiner em execução de um grupo de contêineres. |
Principal | GA |
az container export |
Exporte um grupo de contêineres no formato yaml. |
Principal | GA |
az container list |
Listar grupos de contêineres. |
Principal | GA |
az container logs |
Examine os logs de um contêiner em um grupo de contêineres. |
Principal | GA |
az container restart |
Reinicia todos os contêineres em um grupo de contêineres. |
Principal | GA |
az container show |
Obtenha os detalhes de um grupo de contêineres. |
Principal | GA |
az container start |
Inicia todos os contêineres em um grupo de contêineres. |
Principal | GA |
az container stop |
Para todos os contêineres em um grupo de contêineres. |
Principal | GA |
az container attach
Anexe fluxos de saída e erro padrão local a um contêiner em um grupo de contêineres. Este comando fornece informações de diagnóstico durante a inicialização do contêiner. Depois que o contêiner for iniciado, ele transmitirá STDOUT e STDERR para o console local.
az container attach [--container-name]
[--ids]
[--name]
[--resource-group]
[--subscription]
Exemplos
Anexe fluxos de saída e erro padrão local a um contêiner em um grupo de contêineres. (gerado automaticamente)
az container attach --name MyContainerGroup --resource-group MyResourceGroup
Parâmetros Opcionais
O recipiente ao qual se deve ligar. Se omitido, o primeiro contêiner do grupo de contêineres será escolhido.
Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.
O nome do grupo de contêineres.
o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>
.
o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
o .
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
o .
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
az container create
Crie um grupo de contêineres.
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]
Exemplos
Crie um contêiner em um grupo de contêineres com 1 núcleo e 1 Gb de memória.
az container create -g MyResourceGroup --name myapp --image myimage:latest --cpu 1 --memory 1
Crie um contêiner em um grupo de contêineres que execute o Windows, com 2 núcleos e 3,5 Gb de memória.
az container create -g MyResourceGroup --name mywinapp --image winappimage:latest --os-type Windows --cpu 2 --memory 3.5
Crie um contêiner em um grupo de contêineres com endereço IP público, portas e rótulo de nome DNS.
az container create -g MyResourceGroup --name myapp --image myimage:latest --ports 80 443 --dns-name-label contoso
Crie um contêiner em um grupo de contêineres que invoque um script ao iniciar.
az container create -g MyResourceGroup --name myapp --image myimage:latest --command-line "/bin/sh -c '/path to/myscript.sh'"
Crie um contêiner em um grupo de contêineres que execute um comando e pare o contêiner depois.
az container create -g MyResourceGroup --name myapp --image myimage:latest --command-line "echo hello" --restart-policy Never
Crie um contêiner em um grupo de contêineres com variáveis de ambiente.
az container create -g MyResourceGroup --name myapp --image myimage:latest --environment-variables key1=value1 key2=value2
Crie um contêiner em um grupo de contêineres usando a imagem de contêiner do Registro de Contêiner do Azure.
az container create -g MyResourceGroup --name myapp --image myAcrRegistry.azurecr.io/myimage:latest --registry-password password
Crie um contêiner em um grupo de contêineres que monte um compartilhamento de arquivos do Azure como volume.
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
Crie um contêiner em um grupo de contêineres que monte um repositório git como volume.
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
Crie um contêiner em um grupo de contêineres usando um arquivo yaml.
az container create -g MyResourceGroup -f containerGroup.yaml
Crie um grupo de contêineres usando o Log Analytics a partir do nome de um espaço de trabalho.
az container create -g MyResourceGroup --name myapp --log-analytics-workspace myworkspace
Crie um grupo de contêineres com uma identidade atribuída ao sistema.
az container create -g MyResourceGroup --name myapp --image myimage:latest --assign-identity
Crie um grupo de contêineres com uma identidade atribuída ao sistema. O grupo terá uma função de "Colaborador" com acesso a uma conta de armazenamento.
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
Crie um grupo de contêineres com uma identidade atribuída ao usuário.
az container create -g MyResourceGroup --name myapp --image myimage:latest --assign-identity /subscriptions/mySubscriptionId/resourcegroups/myRG/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myID
Crie um grupo de contêineres com a identidade atribuída ao sistema e ao usuário.
az container create -g MyResourceGroup --name myapp --image myimage:latest --assign-identity [system] /subscriptions/mySubscriptionId/resourcegroups/myRG/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myID
Parâmetros Obrigatórios
o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>
.
Parâmetros Opcionais
A identidade com acesso ao registro de contêiner.
Uma lista de recursos de contexto de segurança a serem adicionados.
Permita se um processo pode obter mais privilégios do que seu processo pai.
Lista separada por espaços de identidades atribuídas. As identidades atribuídas são identidades atribuídas ao utilizador (IDs de recursos) e/ou a identidade atribuída ao sistema («[sistema]»). Veja exemplos para mais informações.
A chave de acesso da conta de armazenamento usada para acessar o compartilhamento de arquivos do Azure.
O nome da conta de armazenamento que contém o compartilhamento de arquivos do Azure.
O caminho dentro do contêiner onde o volume do arquivo azure deve ser montado. Não deve conter dois pontos ':'.
O nome do compartilhamento de arquivos do Azure a ser montado como um volume.
A política CCE para o grupo de contêineres confidenciais.
A linha de comando a ser executada quando o contêiner é iniciado, por exemplo, '/bin/bash -c myscript.sh'.
O número necessário de núcleos de CPU dos contêineres, com precisão de uma casa decimal.
O rótulo de nome dns para grupo de contêineres com IP público.
Uma lista de recursos de contexto de segurança a serem descartados.
Uma lista de variáveis de ambiente para o contêiner. Valores separados por espaço no formato 'key=value'.
O caminho para o arquivo de entrada.
O caminho do diretório de destino no repositório git. Não deve conter «..».
O caminho dentro do contêiner onde o volume de repositório git deve ser montado. Não deve conter dois pontos ':'.
O hash de consolidação para a revisão especificada.
A URL de um repositório git a ser montado como um volume.
O nome da imagem do contêiner.
O tipo de endereço IP do grupo de contêineres.
Localização. Valores de: az account list-locations
. Você pode configurar o local padrão usando az configure --defaults location=<location>
.
O nome ou id do espaço de trabalho do Log Analytics. Use a assinatura atual ou use o sinalizador --subscription para definir a assinatura desejada.
A chave do espaço de trabalho do Log Analytics.
A memória necessária dos recipientes em GB, com precisão de uma casa decimal.
O nome do grupo de contêineres.
Não espere que a operação de longa duração termine.
O tipo de SO dos contentores.
Uma lista de portas a abrir. Lista de portas separadas por espaço.
A prioridade do grupo de contêineres.
O sinalizador para determinar se as permissões de contêiner são elevadas para Privilegiado.
O protocolo de rede a ser usado.
O servidor de login do registro de imagem de contêiner.
A senha para fazer login no servidor de registro de imagem de contêiner.
O nome de usuário para fazer logon no servidor de registro de imagem de contêiner.
Política de reinicialização para todos os contêineres dentro do grupo de contêineres.
Nome da função ou id que a identidade atribuída ao sistema terá.
Defina o UID do usuário para o contêiner.
Defina o GID do usuário para o contêiner.
Escopo que a identidade atribuída ao sistema pode acessar.
Uma cadeia de caracteres codificada em base64 contendo o conteúdo do JSON no perfil seccomp.
Segredos separados por espaço no formato 'key=value'.
O caminho dentro do contêiner onde o volume de segredos deve ser montado. Não deve conter dois pontos ':'.
Uma lista de variável de ambiente seguro para o contêiner. Valores separados por espaço no formato 'key=value'.
O SKU do grupo de contêineres.
O nome da sub-rede ao criar uma nova VNET ou fazer referência a uma existente. Também pode fazer referência a uma sub-rede existente por ID.
O prefixo de endereço IP da sub-rede a ser usado ao criar uma nova VNET no formato CIDR.
O nome da VNET ao criar uma nova ou fazer referência a uma existente. Também pode fazer referência a uma vnet existente por ID. Isso permite o uso de vnets de outros grupos de recursos.
O prefixo de endereço IP a ser usado ao criar uma nova VNET no formato CIDR.
O argumento 'vnet_name' foi preterido e será removido em uma versão futura. Use '--vnet' em vez disso.
O nome da VNET ao criar uma nova ou fazer referência a uma existente.
A zona para colocar o grupo de contêineres.
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
o .
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
az container delete
Exclua um grupo de contêineres.
az container delete [--ids]
[--name]
[--resource-group]
[--subscription]
[--yes]
Exemplos
Exclua um grupo de contêineres. (gerado automaticamente)
az container delete --name MyContainerGroup --resource-group MyResourceGroup
Parâmetros Opcionais
Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.
O nome do grupo de contêineres.
o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>
.
o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
o .
Não solicite confirmação.
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
o .
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
az container exec
Execute um comando de dentro de um contêiner em execução de um grupo de contêineres.
O caso de uso mais comum é abrir um shell bash interativo. Veja exemplos abaixo.
az container exec --exec-command
[--container-name]
[--ids]
[--name]
[--resource-group]
[--subscription]
Exemplos
Transmita um shell de dentro de um contêiner nginx.
az container exec -g MyResourceGroup --name mynginx --container-name nginx --exec-command "/bin/bash"
Parâmetros Obrigatórios
O comando a ser executado de dentro do contêiner.
Parâmetros Opcionais
O nome do contêiner onde executar o comando. Pode ser omitido para grupos de contêineres com apenas um contêiner.
Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.
O nome do grupo de contêineres.
o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>
.
o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
o .
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
o .
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
az container export
Exporte um grupo de contêineres no formato yaml.
az container export --file
[--ids]
[--name]
[--resource-group]
[--subscription]
Exemplos
Exporte um grupo de contêineres no yaml.
az container export -g MyResourceGroup --name mynginx -f output.yaml
Parâmetros Obrigatórios
O caminho do arquivo para exportar o grupo de contêineres.
Parâmetros Opcionais
Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.
O nome do grupo de contêineres.
o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>
.
o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
o .
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
o .
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
az container list
Listar grupos de contêineres.
az container list [--resource-group]
Parâmetros Opcionais
o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>
.
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
o .
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
az container logs
Examine os logs de um contêiner em um grupo de contêineres.
az container logs [--container-name]
[--follow]
[--ids]
[--name]
[--resource-group]
[--subscription]
Exemplos
Examine os logs de um contêiner em um grupo de contêineres. (gerado automaticamente)
az container logs --name MyContainerGroup --resource-group MyResourceGroup
Parâmetros Opcionais
O nome do contêiner para finalizar os logs. Se omitido, o primeiro contêiner do grupo de contêineres será escolhido.
Indique para transmitir os registros de rejeitos.
Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.
O nome do grupo de contêineres.
o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>
.
o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
o .
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
o .
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
az container restart
Reinicia todos os contêineres em um grupo de contêineres.
Reinicia todos os contêineres em um grupo de contêineres no local. Se a imagem do contêiner tiver atualizações, a nova imagem será baixada.
az container restart --name
--resource-group
[--no-wait]
Parâmetros Obrigatórios
O nome do grupo de contêineres.
o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>
.
Parâmetros Opcionais
Não espere que a operação de longa duração termine.
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
o .
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
az container show
Obtenha os detalhes de um grupo de contêineres.
az container show [--ids]
[--name]
[--resource-group]
[--subscription]
Exemplos
Obtenha os detalhes de um grupo de contêineres. (gerado automaticamente)
az container show --name MyContainerGroup --resource-group MyResourceGroup
Parâmetros Opcionais
Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.
O nome do grupo de contêineres.
o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>
.
o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
o .
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
o .
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
az container start
Inicia todos os contêineres em um grupo de contêineres.
Inicia todos os contêineres em um grupo de contêineres. Os recursos de computação serão alocados e o faturamento será iniciado.
az container start --name
--resource-group
[--no-wait]
Parâmetros Obrigatórios
O nome do grupo de contêineres.
o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>
.
Parâmetros Opcionais
Não espere que a operação de longa duração termine.
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
o .
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
az container stop
Para todos os contêineres em um grupo de contêineres.
Para todos os contêineres em um grupo de contêineres. Os recursos de computação serão desalocados e o faturamento será interrompido.
az container stop --name
--resource-group
Parâmetros Obrigatórios
O nome do grupo de contêineres.
o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>
.
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
o .
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.