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.

Advertência

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 esta imagem. Para garantir o suporte contínuo, migre para a imagem baseada no Azure Linux (Azure Linux 3.0), que é totalmente mantida. Consulte 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 opções de configuração, consulte Valores de configuração da CLI do Azure e variáveis de ambiente.

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 tag determinística (como azurelinux3.0) para garantir um comportamento consistente.

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

Observação

Para usar suas chaves SSH locais dentro do contêiner, monte seu 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 a partir do ambiente do 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/local/bin/az.

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

Você pode encontrar as 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 extrair a 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 a imagem do Docker

Se optar por desinstalar a CLI do Azure, é com muita pena que o vemos ir embora. Antes de desinstalar, utilize o comando az feedback para nos indicar o que é possível melhorar ou corrigir. O nosso objetivo é tornar a CLI do Azure livre de erros e amigável para o utilizador. Se encontrou um erro, pedimos que registe um problema no GitHub.

Para remover a imagem do Docker, primeiro pare todos os contêineres em execução e, em seguida, 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 rápido tour por seus principais recursos e comandos comumente usados para começar.

Introdução à CLI do Azure