Compartilhar via


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

Você pode usar o Docker para executar um contêiner do Linux autônomo com a CLI do Azure pré-instalada. O Docker ajuda você a começar rapidamente com um ambiente isolado para executar a CLI. A imagem também pode ser usada como base para suas próprias implantações.

Aviso

A CLI do Azure 2.63.0 (lançada em agosto de 2024) é a última versão com suporte na imagem do docker Alpine. 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 para a CLI do Azure, que tem suporte total.

Para desativar as mensagens de aviso, execute az config set core.only_show_errors=yeso . 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, é recomendável usar um nome de marca determinístico (por exemplo cbl-mariner2.0, )

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

Observação

Se você quiser acompanhar as chaves SSH do seu ambiente de usuário, use -v ${HOME}/.ssh:/root/.ssh para montar suas chaves SSH no ambiente.

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

A CLI está instalada na imagem como o comando az no /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 sobre a 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

Atualizar com o Docker requer obter a nova imagem e recriar qualquer contêiner existente. Por esse motivo, você deve evitar o uso de um contêiner que hospede a CLI como um armazenamento de dados.

Atualizar sua imagem local com docker pull.

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

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.

Depois de parar qualquer contêiner executando a imagem da CLI, remova-o.

docker rmi mcr.microsoft.com/azure-cli

Próximas etapas

Agora que você pronto para usar a CLI do Azure em um contêiner do Docker, faça um breve tour pelos recursos e comandos mais comuns dela.