az container
Observação
Esse 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.
Gerenciar instâncias de contêiner do Azure.
Comandos
| Nome | Description | Tipo | Status |
|---|---|---|---|
| az container app |
Comandos para gerenciar o aplicativo Instâncias de Contêiner do Azure. |
Extensão | Visualizar |
| az container app up |
Implante em instâncias de contêiner do Azure usando ações do GitHub. |
Extensão | Visualizar |
| az container attach |
Anexe fluxos de erros e saída padrão local a um contêiner em um grupo de contêineres. Esse comando fornece informações de diagnóstico durante a inicialização do contêiner. Depois que o contêiner for iniciado, ele transmite STDOUT e STDERR para o console local. |
Núcleo | GA |
| az container create |
Crie um grupo de contêineres. |
Núcleo | GA |
| az container delete |
Excluir um grupo de contêineres. |
Núcleo | GA |
| az container exec |
Execute um comando de dentro de um contêiner em execução de um grupo de contêineres. |
Núcleo | GA |
| az container export |
Exporte um grupo de contêineres no formato yaml. |
Núcleo | GA |
| az container list |
Listar grupos de contêineres. |
Núcleo | GA |
| az container logs |
Examine os logs de um contêiner em um grupo de contêineres. |
Núcleo | GA |
| az container restart |
Reinicia todos os contêineres em um grupo de contêineres. |
Núcleo | GA |
| az container show |
Obtenha os detalhes de um grupo de contêineres. |
Núcleo | GA |
| az container start |
Inicia todos os contêineres em um grupo de contêineres. |
Núcleo | GA |
| az container stop |
Interrompe todos os contêineres em um grupo de contêineres. |
Núcleo | GA |
az container attach
Anexe fluxos de erros e saída padrão local a um contêiner em um grupo de contêineres. Esse comando fornece informações de diagnóstico durante a inicialização do contêiner. Depois que o contêiner for iniciado, ele transmite STDOUT e STDERR para o console local.
az container attach [--container-name]
[--ids]
[--name]
[--resource-group]
[--subscription]Exemplos
Anexe fluxos de erros e saída padrão local a um contêiner em um grupo de contêineres. (gerado automaticamente)
az container attach --name MyContainerGroup --resource-group MyResourceGroupParâmetros Opcionais
O recipiente ao qual se conectar. Se omitido, o primeiro contêiner no grupo de contêineres será escolhido.
Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'Resource Id'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.
O nome do grupo de contêineres.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Parâmetros Globais
Aumente o detalhamento 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.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumentar o detalhamento do log. 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 1Crie 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.5Crie 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 contosoCrie um contêiner em um grupo de contêineres que invoque um script na inicialização.
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 NeverCrie 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=value2Crie 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 passwordCrie um contêiner em um grupo de contêineres que monta 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/azfileCrie 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/gitrepoCrie um contêiner em um grupo de contêineres usando um arquivo yaml.
az container create -g MyResourceGroup -f containerGroup.yamlCrie um grupo de contêineres usando o Log Analytics a partir de um nome de espaço de trabalho.
az container create -g MyResourceGroup --name myapp --log-analytics-workspace myworkspaceCrie um grupo de contêineres com uma identidade atribuída ao sistema.
az container create -g MyResourceGroup --name myapp --image myimage:latest --assign-identityCrie um grupo de contêineres com uma identidade atribuída ao sistema. O grupo terá uma função '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/storage1Crie um grupo de contêineres com uma identidade atribuída pelo usuário.
az container create -g MyResourceGroup --name myapp --image myimage:latest --assign-identity /subscriptions/mySubscriptionId/resourcegroups/myRG/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myIDCrie um grupo de contêineres com 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/myIDParâmetros Exigidos
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 do contêiner.
Uma lista de recursos de contexto de segurança a serem adicionados.
Permitir se um processo pode obter mais privilégios do que seu processo pai.
Lista separada por espaço de identidades atribuídas. As identidades atribuídas são identidades atribuídas pelo usuário (IDs de recurso) e/ou a identidade atribuída pelo sistema ('[sistema]'). Consulte exemplos para obter mais informações.
A chave de acesso da conta de armazenamento usada para acessar o compartilhamento de arquivo do Azure.
O nome da conta de armazenamento que contém o compartilhamento de arquivo do Azure.
O caminho dentro do contêiner onde o volume de arquivo azure deve ser montado. Não deve conter dois pontos ':'.
O nome do compartilhamento de arquivo do Azure a ser montado como volume.
A política de 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 o 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 confirmaçã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.
Local. 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 de espaço de trabalho do Log Analytics.
A memória necessária dos contêineres em GB, com precisão de uma casa decimal.
O nome do grupo de contêineres.
Não aguarde a conclusão da operação de execução longa.
O tipo de sistema operacional dos contêineres.
Uma lista de portas a serem abertas. Lista de portas separada por espaço.
A prioridade do grupo de contêineres.
O sinalizador para determinar se as permissões de contêiner são elevadas a Privilegiado.
O protocolo de rede a ser usado.
O servidor de logon do registro de imagem de contêiner.
A senha para efetuar logon no servidor de registro de imagem de contêiner.
O nome de usuário para efetuar logon no servidor de registro de imagem de contêiner.
A política de reinicialização para todos os contêineres no grupo.
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 que contém 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áveis de ambiente seguro para o contêiner. Valores separados por espaço no formato 'key=value'.
A SKU do grupo de contêineres.
O nome da sub-rede ao criar uma nova rede virtual 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. Em vez disso, use '--vnet'.
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 Globais
Aumente o detalhamento 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.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumentar o detalhamento do log. Use --debug para logs de depuração completos.
az container delete
Excluir um grupo de contêineres.
az container delete [--ids]
[--name]
[--resource-group]
[--subscription]
[--yes]Exemplos
Excluir um grupo de contêineres. (gerado automaticamente)
az container delete --name MyContainerGroup --resource-group MyResourceGroupParâmetros Opcionais
Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'Resource Id'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.
O nome do grupo de contêineres.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Não solicite confirmação.
Parâmetros Globais
Aumente o detalhamento 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.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumentar o detalhamento do log. 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 Exigidos
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.
Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'Resource Id'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.
O nome do grupo de contêineres.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Parâmetros Globais
Aumente o detalhamento 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.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumentar o detalhamento do log. 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.yamlParâmetros Exigidos
O caminho do arquivo para exportar o grupo de contêineres.
Parâmetros Opcionais
Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'Resource Id'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.
O nome do grupo de contêineres.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Parâmetros Globais
Aumente o detalhamento 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.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumentar o detalhamento do log. Use --debug para logs de depuração completos.
az container list
Listar grupos de contêineres.
az container list [--resource-group]Parâmetros Opcionais
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
Parâmetros Globais
Aumente o detalhamento 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.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumentar o detalhamento do log. 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 MyResourceGroupParâmetros Opcionais
O nome do contêiner para encerrar os logs. Se omitido, o primeiro contêiner no grupo de contêineres será escolhido.
Indique para transmitir os logs de rejeitos.
Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'Resource Id'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.
O nome do grupo de contêineres.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Parâmetros Globais
Aumente o detalhamento 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.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumentar o detalhamento do log. 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, uma nova imagem será baixada.
az container restart --name
--resource-group
[--no-wait]Parâmetros Exigidos
O nome do grupo de contêineres.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
Parâmetros Opcionais
Não aguarde a conclusão da operação de execução longa.
Parâmetros Globais
Aumente o detalhamento 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.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumentar o detalhamento do log. 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 MyResourceGroupParâmetros Opcionais
Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'Resource Id'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.
O nome do grupo de contêineres.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Parâmetros Globais
Aumente o detalhamento 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.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumentar o detalhamento do log. 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 Exigidos
O nome do grupo de contêineres.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
Parâmetros Opcionais
Não aguarde a conclusão da operação de execução longa.
Parâmetros Globais
Aumente o detalhamento 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.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumentar o detalhamento do log. Use --debug para logs de depuração completos.
az container stop
Interrompe todos os contêineres em um grupo de contêineres.
Interrompe todos os contêineres em um grupo de contêineres. Os recursos de computação serão desalocados e a cobrança será interrompida.
az container stop --name
--resource-groupParâmetros Exigidos
O nome do grupo de contêineres.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
Parâmetros Globais
Aumente o detalhamento 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.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumentar o detalhamento do log. Use --debug para logs de depuração completos.
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de