Instalar a CLI do Azure no macOS

A CLI (Interface de Command-Line do Azure) é uma ferramenta de linha de comando multiplataforma que pode ser instalada localmente em computadores macOS. Você pode usar a CLI do Azure para se conectar ao Azure e executar comandos administrativos em recursos do Azure usando prompts de linha de comando interativos ou um script.

Para a plataforma macOS, instale a CLI do Azure com gerenciador de pacotes homebrew. O Homebrew facilita manter sua instalação da CLI do Azure atualizada. O pacote da CLI do Azure requer macOS 13 ou superior.

A versão atual do Azure CLI é a 2.81.0. Para obter informações sobre a versão mais recente, consulte as notas de versão. Para encontrar sua versão instalada e ver se você precisa atualizar, execute az version.

Instale com Homebrew

O Homebrew é a maneira mais fácil de gerenciar sua instalação da CLI do Azure. Fornece formas convenientes para instalar, atualizar e desinstalar. Se não tiver o homebrew disponível no seu sistema, instale-o antes de continuar.

Você pode instalar a CLI do Azure no macOS atualizando as informações do repositório brew e executando o install comando:

brew update && brew install azure-cli

Solução de problemas

Se você encontrar um problema ao instalar a CLI do Azure por meio do Homebrew, aqui estão alguns erros comuns. Se você tiver um problema não abordado aqui, registre um problema no GitHub.

O preenchimento automático não está a funcionar

A fórmula Homebrew da CLI do Azure instala um arquivo de conclusão nomeado az no diretório de conclusão gerenciado pelo Homebrew (o local padrão é /usr/local/etc/bash_completion.d/). Para habilitar a conclusão, siga as instruções do Homebrew aqui.

Para Zsh, adicione as duas linhas a seguir na parte inferior do arquivo .zshrc e, em seguida, salve e recarregue seu perfil Zsh.

autoload bashcompinit && bashcompinit
source $(brew --prefix)/etc/bash_completion.d/az

Não é possível localizar o Python ou os pacotes instalados

Pode haver uma incompatibilidade de versão secundária ou outro problema durante a instalação do homebrew. A CLI do Azure não usa um ambiente virtual Python, portanto, depende de encontrar a versão do Python instalada. Uma solução possível passa por instalar e voltar a ligar a dependência python@3.10 do Homebrew.

brew update && brew install python@3.10 && brew upgrade python@3.10
brew link --overwrite python@3.10

A CLI do Azure versão 1.x está instalada

Se tiver sido instalada uma versão desatualizada, pode ser devido a uma cache do Homebrew obsoleta. Siga as instruções de atualização.

O proxy bloqueia a ligação

Talvez você não consiga obter recursos do Homebrew, a menos que o configure para usar seu proxy. Siga as instruções de configuração do proxy Homebrew.

Importante

Se estiver atrás de um proxy, HTTP_PROXY e HTTPS_PROXY devem ser configurados para se conectar aos serviços da Azure com a CLI do Azure. Se você não usa autenticação básica, você deve exportar essas variáveis em seu .bashrc arquivo. Siga sempre as políticas de segurança da sua empresa e os requisitos do administrador do sistema.

Para obter os recursos de garrafa do Homebrew, seu proxy precisa permitir conexões HTTPS para os seguintes endereços:

• https://formulae.brew.sh
• https://homebrew.bintray.com

Atualização

A CLI do Azure é atualizada regularmente com correções de bugs, melhorias, novos recursos e funcionalidade de visualização. Uma nova versão está disponível cerca de uma vez por mês.

A partir da versão 2.11.0, a CLI do Azure fornece um comando na ferramenta para atualizar para a versão mais recente.

az upgrade

Este comando também atualiza todas as extensões instaladas por predefinição. Para obter mais az upgrade opções, consulte a página de referência do comando. Para versões da CLI do Azure anteriores à 2.11.0, atualize reinstalando conforme descrito em Instalar a CLI do Azure.

Você também pode atualizar as informações do repositório Homebrew local e, em seguida, atualizar o azure-cli pacote.

brew update && brew upgrade azure-cli

Desinstale

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.

Utilize o Homebrew para desinstalar o pacote azure-cli.

brew uninstall azure-cli

Remover os dados

Se você não planeja reinstalar a CLI do Azure, remova seus dados.

rm -rf ~/.azure

Outros métodos de instalação

Se você não puder usar o homebrew para instalar a CLI do Azure em seu ambiente, é possível usar as instruções manuais para Linux. Este processo não é oficialmente mantido para ser compatível com macOS. Recomenda-se o uso de um gerenciador de pacotes como o Homebrew. Use o método de instalação manual apenas se não tiver outra opção disponível.

Para obter instruções de instalação manual, consulte Instalar a CLI do Azure no Linux manualmente.

Próximas Etapas

Agora que você instalou a CLI do Azure no macOS, faça um breve tour por seus recursos e comandos comuns.

Introdução à CLI do Azure