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. O Docker permite-lhe começar rapidamente com um ambiente isolado para a execução da CLI. A imagem também pode ser utilizada como ponto de partida para as suas próprias implementações.

Aviso

A CLI do Azure 2.63.0 (lançada em agosto de 2024) é a última versão suportada na imagem do docker alpino. A Microsoft não fornecerá atualizações adicionais ou correções de bugs para esta imagem. Considere migrar para a imagem baseada no Linux do Azure para a CLI do Azure, que é totalmente suportada.

Para desativar as mensagens de aviso, execute az config set core.only_show_errors=yes. Para obter mais informações sobre as definições de configuração da CLI do Azure, consulte Valores de configuração da CLI 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 o contêiner do Docker com a CLI do Azure pré-instalada usando o comando a seguir. Quando usado em um pipeline, recomenda-se usar um nome de tag determinístico (por exemplo cbl-mariner2.0)

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

Nota

Se quiser escolher as chaves SSH do seu ambiente de utilizador, utilize -v ${HOME}/.ssh:/root/.ssh para montar as suas chaves SSH no ambiente.

docker run -it -v ${HOME}/.ssh:/root/.ssh mcr.microsoft.com/azure-cli:cbl-mariner2.0

A CLI é instalada na imagem como o comando az em /usr/local/bin.

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

As versões disponíveis podem ser encontradas nas notas de versão da CLI do Azure.

Para executar uma versão específica da CLI do Azure no contêiner do Docker, use este comando. Mude 2.62.0 com a versão desejada.

docker run -it mcr.microsoft.com/azure-cli:2.62.0-cbl-mariner2.0

Atualizar imagem do Docker

A atualização com o Docker requer extrair a nova imagem e recriar quaisquer contentores existentes. Por este motivo, deve tentar evitar a utilização de um contentor que aloje a CLI como um arquivo de dados.

Atualize a imagem local com docker pull.

docker pull mcr.microsoft.com/azure-cli:cbl-mariner2.0

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 liver de erros e intuitiva para o utilizador. Se encontrou um erro, pedimos que registe um problema no GitHub.

Após parar quaisquer contentores a executar a imagem da CLI, remova-a.

docker rmi mcr.microsoft.com/azure-cli

Passos Seguintes

Agora que você está pronto para usar a CLI do Azure em um contêiner do Docker, faça um breve tour por seus recursos e comandos comuns.