az container

Gerenciar Instâncias de Contêiner do Azure.

Comandos

az container app

Comandos para gerenciar Instâncias de Contêiner do Azure aplicativo.

az container app up

Implante em Instâncias de Contêiner do Azure usando GitHub Actions.

az container attach

Anexe fluxos de erro e saída padrão locais 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 create

Criar um grupo de contêineres.

az container delete

Excluir um grupo de contêineres.

az container exec

Execute um comando de dentro de um contêiner em execução de um grupo de contêineres.

az container export

Exportar um grupo de contêineres no formato yaml.

az container list

Listar grupos de contêineres.

az container logs

Examine os logs de um contêiner em um grupo de contêineres.

az container restart

Reinicia todos os contêineres em um grupo de contêineres.

az container show

Obtenha os detalhes de um grupo de contêineres.

az container start

Inicia todos os contêineres em um grupo de contêineres.

az container stop

Interrompe todos os contêineres em um grupo de contêineres.

az container attach

Anexe fluxos de erro e saída padrão locais 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 erro e saída padrão locais a um contêiner em um grupo de contêineres. (gerado automaticamente)

az container attach --name MyContainerGroup --resource-group MyResourceGroup

Parâmetros Opcionais

--container-name

O contêiner ao qual anexar. Se omitido, o primeiro contêiner no grupo de contêineres será escolhido.

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'ID do recurso'.

--name -n

O nome do grupo de contêineres.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

az container create

Crie um grupo de contêineres.

az container create --resource-group
                    [--acr-identity]
                    [--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]
                    [--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]
                    [--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 no início.

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 executa um comando e interrompa o contêiner posteriormente.

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 de um nome de workspace.

az container create -g MyResourceGroup --name myapp --log-analytics-workspace myworkspace

Crie um grupo de contêineres com uma identidade atribuída pelo sistema.

az container create -g MyResourceGroup --name myapp --image myimage:latest --assign-identity

Crie um grupo de contêineres com uma identidade atribuída pelo 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/storage1

Crie 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/myID

Crie um grupo de contêineres com identidade atribuída pelo sistema e pelo 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 Exigidos

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

--acr-identity

A identidade com acesso ao registro de contêiner.

--assign-identity

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]'). Confira exemplos para obter mais informações.

--azure-file-volume-account-key

A chave de acesso da conta de armazenamento usada para acessar o compartilhamento de arquivo do Azure.

--azure-file-volume-account-name

O nome da conta de armazenamento que contém o compartilhamento de arquivo do Azure.

--azure-file-volume-mount-path

O caminho dentro do contêiner em que o volume de arquivos do azure deve ser montado. Não deve conter dois-pontos ':'.

--azure-file-volume-share-name

O nome do compartilhamento de arquivo do Azure a ser montado como volume.

--command-line

A linha de comando a ser executada quando o contêiner for iniciado, por exemplo, '/bin/bash -c myscript.sh'.

--cpu

O número necessário de núcleos de CPU dos contêineres, preciso para uma casa decimal.

valor padrão: 1
--dns-name-label

O rótulo de nome dns para o grupo de contêineres com IP público.

--environment-variables -e

Uma lista de variáveis de ambiente para o contêiner. Valores separados por espaço no formato 'key=value'.

--file -f

O caminho para o arquivo de entrada.

--gitrepo-dir

O caminho do diretório de destino no repositório git. Não deve conter '..'.

valor padrão: .
--gitrepo-mount-path

O caminho dentro do contêiner em que o volume do repositório Git deve ser montado. Não deve conter dois-pontos ':'.

--gitrepo-revision

O hash de confirmação para a revisão especificada.

--gitrepo-url

A URL de um repositório git a ser montado como um volume.

--image

O nome da imagem do contêiner.

--ip-address

O tipo de endereço IP do grupo de contêineres.

valores aceitos: Private, Public
--location -l

Local. Valores de: az account list-locations. Você pode configurar o local padrão usando az configure --defaults location=<location>.

--log-analytics-workspace

O nome ou a ID do workspace do Log Analytics. Use a assinatura atual ou use o sinalizador --subscription para definir a assinatura desejada.

--log-analytics-workspace-key

A chave do workspace do Log Analytics.

--memory

A memória necessária dos contêineres em GB, precisa de um local decimal.

valor padrão: 1.5
--name -n

O nome do grupo de contêineres.

--no-wait

Não aguarde a conclusão da operação de execução longa.

valor padrão: False
--os-type

O tipo de sistema operacional dos contêineres.

valores aceitos: Linux, Windows
valor padrão: Linux
--ports

Uma lista de portas a serem abertas. Lista de portas separadas por espaço.

valor padrão: [80]
--protocol

O protocolo de rede a ser usado.

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

O servidor de logon do registro de imagem de contêiner.

--registry-password

A senha para fazer logon no servidor do registro de imagem de contêiner.

--registry-username

O nome de usuário para fazer logon no servidor de registro de imagem de contêiner.

--restart-policy

A política de reinicialização para todos os contêineres no grupo.

valores aceitos: Always, Never, OnFailure
valor padrão: Always
--role

Nome da função ou id que a identidade atribuída pelo sistema terá.

valor padrão: Contributor
--scope

Escopo que a identidade atribuída pelo sistema pode acessar.

--secrets

Segredos separados por espaço no formato 'key=value'.

--secrets-mount-path

O caminho dentro do contêiner em que o volume de segredos deve ser montado. Não deve conter dois-pontos ':'.

--secure-environment-variables

Uma lista de variáveis de ambiente seguras para o contêiner. Valores separados por espaço no formato 'key=value'.

--subnet

O nome da sub-rede ao criar uma nova VNET ou referenciar uma existente. Também é possível referenciar uma sub-rede existente por ID.

--subnet-address-prefix

O prefixo de endereço IP da sub-rede a ser usado ao criar uma nova VNET no formato CIDR.

valor padrão: 10.0.0.0/24
--vnet

O nome da VNET ao criar uma nova ou referenciar uma existente. Também é possível referenciar uma vnet existente por ID. Isso permite o uso de vnets de outros grupos de recursos.

--vnet-address-prefix

O prefixo de endereço IP a ser usado ao criar uma nova VNET no formato CIDR.

valor padrão: 10.0.0.0/16
--vnet-name

O nome da VNET ao criar uma nova ou referenciar uma existente.

--zone

A zona para colocar o grupo de contêineres.

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 MyResourceGroup

Parâmetros Opcionais

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa contendo todas as informações de argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'ID do recurso'.

--name -n

O nome do grupo de contêineres.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--yes -y

Não solicite confirmação.

valor padrão: False

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

Transmitir 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

--exec-command

O comando a ser executado de dentro do contêiner.

Parâmetros Opcionais

--container-name

O nome do contêiner em que executar o comando. Pode ser ommitido para grupos de contêineres com apenas um contêiner.

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa contendo todas as informações de argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'ID do recurso'.

--name -n

O nome do grupo de contêineres.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

az container export

Exportar um grupo de contêineres no formato yaml.

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

Exemplos

Exportar um grupo de contêineres no yaml.

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

Parâmetros Exigidos

--file -f

O caminho do arquivo para exportar o grupo de contêineres.

Parâmetros Opcionais

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa contendo todas as informações de argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'ID do recurso'.

--name -n

O nome do grupo de contêineres.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

az container list

Listar grupos de contêineres.

az container list [--resource-group]

Parâmetros Opcionais

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

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

--container-name

O nome do contêiner a ser seguido pelos logs. Se omitido, o primeiro contêiner no grupo de contêineres será escolhido.

--follow

Indique para transmitir os logs de cauda.

valor padrão: False
--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa contendo todas as informações de argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'ID do recurso'.

--name -n

O nome do grupo de contêineres.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

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 em vigor. Se a imagem do contêiner tiver atualizações, a nova imagem será baixada.

az container restart --name
                     --resource-group
                     [--no-wait]

Parâmetros Exigidos

--name -n

O nome do grupo de contêineres.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

--no-wait

Não aguarde a conclusão da operação de execução longa.

valor padrão: False

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

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa contendo todas as informações de argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'ID do recurso'.

--name -n

O nome do grupo de contêineres.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

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 a cobrança será iniciada.

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

Parâmetros Exigidos

--name -n

O nome do grupo de contêineres.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

--no-wait

Não aguarde a conclusão da operação de execução longa.

valor padrão: False

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

Parâmetros Exigidos

--name -n

O nome do grupo de contêineres.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.