Partilhar 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. 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

Azure CLI 2.63.0 (lançada em agosto de 2024) é a última versão suportada na imagem Alpine do Docker. A Microsoft não fornecerá atualizações adicionais ou correções de bugs para esta imagem. Considere migrar para a imagem baseada em Linux do Azure (cbl-mariner) para a CLI do Azure, que é totalmente suportada. Veja exemplos de cbl-mariner2.0 abaixo.

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 obter as chaves SSH do seu ambiente de utilizador, utilize --mount type=bind,src="$HOME"/.ssh,dst=/root/.ssh para montar as chaves SSH no ambiente.

docker run -it --mount type=bind,src="$HOME"/.ssh,dst=/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. Altere 2.62.0 para 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 livre de erros e fácil de usar. 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.