Instalar Azure CLI no macOS

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

Para a plataforma macOS, instale o Azure CLI com homebrew package manager. O Homebrew facilita manter sua instalação do Azure CLI sempre atualizada. O pacote Azure CLI requer macOS 13 ou superior.

A versão atual do Azure CLI é 2.84.0. Para saber mais sobre a versão mais recente, veja as notas de versão. Para localizar a versão instalada e ver se você precisa atualizá-la, execute az version.

Instalar com o Homebrew

Homebrew é a maneira mais fácil de gerenciar sua instalação de Azure CLI. Ele fornece maneiras convenientes de instalar, atualizar e desinstalar. Se você não tiver o homebrew disponível em seu sistema, instale-o antes de continuar.

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

brew update && brew install azure-cli

Resolução de problemas

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

A conclusão não está funcionando

A fórmula Homebrew de Azure CLI instala um arquivo de conclusão chamado az no diretório de conclusões gerenciadas por 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, salve e recarregue o perfil Zsh.

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

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

Pode haver uma incompatibilidade de versão menor ou outro problema durante a instalação do Homebrew. O Azure CLI não usa um ambiente virtual Python, portanto, depende de encontrar a versão Python instalada. Uma possível correção é instalar e relinkar 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

Azure CLI versão 1.x está instalada

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

Proxy bloqueia conexão

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

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

O Azure CLI é atualizado 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.

Começando com a versão 2.11.0, o Azure CLI fornece um comando na ferramenta para atualizar para a versão mais recente.

az upgrade

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

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

brew update && brew upgrade azure-cli

Desinstalar

Se você decidir desinstalar o Azure CLI, lamentamos vê-lo partir. Antes de desinstalar, use o comando az feedback para nos informar sobre o que poderia ser melhorado ou corrigido. Nosso objetivo é tornar o Azure CLI sem bugs e amigável. Se você encontrou um bug, gostaríamos que file um problema de GitHub.

Use o homebrew para desinstalar o pacote azure-cli.

brew uninstall azure-cli

Remova dados

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

rm -rf ~/.azure

Outros métodos de instalação

Se você não puder usar homebrew para instalar o Azure CLI em seu ambiente, é possível usar as instruções manuais para Linux. Esse processo não é oficialmente mantido para ser compatível com o macOS. É recomendável usar um gerenciador de pacotes como o Homebrew. Somente use o método de instalação manual se não tiver nenhuma outra opção disponível.

Para obter as instruções manuais de instalação, consulte Instalar Azure CLI no Linux manualmente.

Próximas etapas

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