Compartilhar via

Como executar a CLI do Azure em um contêiner do Docker

Você pode usar o Docker para executar um contêiner linux autônomo com a CLI do Azure pré-instalada, fornecendo um ambiente rápido e isolado para usar a CLI do Azure. Essa imagem de contêiner também pode servir como base para suas próprias implantações personalizadas.

Aviso

A CLI do Azure 2.63.0 (lançada em agosto de 2024) é a versão final com suporte na imagem do Docker baseada em Alpine. A Microsoft não fornece mais atualizações ou correções de bugs para essa imagem. Para garantir o suporte contínuo, migre para a imagem baseada em Linux do Azure (Azure Linux 3.0), que é totalmente mantida. Veja os exemplos a seguir para usar o Azure Linux 3.0.

Para suprimir mensagens de aviso, execute: az config set core.only_show_errors=yes. Para obter detalhes sobre as opções de configuração, consulte valores de configuração da CLI do Azure e variáveis de ambiente.

Localizando imagens disponíveis

Siga as instruções oficiais do Docker para instalar o Docker. Os contêineres de versão derivam da imagem de distribuição oficial, instalam dependências e instalam a CLI do Azure.

Você pode encontrar uma lista completa de imagens de Docker da Azure CLI em nossa página de imagem de Docker.

Importante

Essas imagens são criadas a partir de imagens oficiais do sistema operacional (SO) fornecidas pelo distribuidor do sistema operacional. Essas imagens podem não ter as atualizações de segurança mais recentes. A Microsoft recomenda que você atualize os pacotes do sistema operacional para a versão mais recente para garantir que as atualizações de segurança mais recentes sejam aplicadas.

Iniciar o contêiner do Docker com a CLI do Azure pré-instalada

Abra um prompt de comando e inicie um contêiner do Docker com a CLI do Azure pré-instalada usando o comando a seguir. Ao usar esse comando em um pipeline, use uma marca determinística (como azurelinux3.0) para garantir um comportamento consistente.

docker run -it mcr.microsoft.com/azure-cli:azurelinux3.0

Observação

Para usar as chaves SSH locais dentro do contêiner, monte o diretório .ssh incluindo a seguinte opção: --mount type=bind,src="$HOME"/.ssh,dst=/root/.ssh. Essa opção permite que o contêiner acesse suas chaves SSH do seu ambiente de usuário.

docker run -it --mount type=bind,src="$HOME"/.ssh,dst=/root/.ssh mcr.microsoft.com/azure-cli:azurelinux3.0

A CLI do Azure está disponível na imagem como o az comando, localizado em /usr/bin/az.

Executar o contêiner do Docker com uma versão específica da CLI do Azure

Você pode encontrar versões disponíveis nas notas de versão da CLI do Azure.

Para executar uma versão específica da CLI do Azure em um contêiner do Docker, use o comando a seguir, substituindo 2.74.0 pela versão desejada.

docker run -it mcr.microsoft.com/azure-cli:2.74.0-azurelinux3.0

Atualizar imagem do Docker

Para atualizar a CLI do Azure ao usar o Docker, você deve efetuar pull da imagem mais recente e recriar todos os contêineres existentes. Devido a esse processo de atualização, evite usar contêineres da CLI do Azure como armazenamentos de dados persistentes.

Atualize sua imagem local usando o seguinte comando:

docker pull mcr.microsoft.com/azure-cli:latest

Desinstalar imagem do Docker

Se você decidir desinstalar a CLI do Azure, lamentamos sua saída. Antes de desinstalar, use o comando az feedback para nos informar sobre o que poderia ser melhorado ou corrigido. Nosso objetivo é deixar a CLI do Azure livre de bugs e amigável ao usuário. Se você encontrou um erro, agradeceríamos se registrasse um problema do GitHub.

Para remover a imagem do Docker, primeiro interrompa todos os contêineres em execução e execute:

docker rmi mcr.microsoft.com/azure-cli

Próximas etapas

Agora que você está pronto para usar a CLI do Azure em um contêiner do Docker, faça um tour rápido pelos principais recursos e comandos comumente usados para começar.

Introdução à CLI do Azure

  • Last updated on