Instalar CLI do Azure 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 a CLI do Azure para se conectar à Azure e executar comandos administrativos nos recursos do Azure usando prompts interativos da linha de comando ou um script.

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

A versão atual do CLI do Azure é 2.85.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 CLI do Azure. 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 CLI do Azure 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 CLI do Azure 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 CLI do Azure 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 os pacotes instalados

Pode haver uma incompatibilidade de versão menor ou outro problema durante a instalação do Homebrew. O CLI do Azure 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

CLI do Azure 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 CLI do Azure é 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 CLI do Azure 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 CLI do Azure anteriores a 2.11.0, atualize reinstalando conforme descrito em Instale o CLI do Azure.

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 CLI do Azure, 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 CLI do Azure 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 CLI do Azure, remova seus dados.

rm -rf ~/.azure

Outros métodos de instalação

Se você não puder usar homebrew para instalar o CLI do Azure 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 CLI do Azure no Linux manualmente.

Próximas etapas

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