Instalar a CLI do Azure no macOS
A CLI (Interface de Linha de Comando) do Azure permite a execução de comandos por meio de um terminal usando prompts de linha de comando interativos ou um script. Você pode instalar a CLI do Azure localmente em computadores macOS. A CLI do Azure no macOS permite a execução de vários comandos por meio de um terminal usando prompts de linha de comando interativos ou um script.
Para a plataforma macOS, você pode instalar a CLI do Azure com o gerenciador de pacotes homebrew. O Homebrew torna mais fácil manter a instalação da CLI atualizada. O pacote da CLI foi testado em versões do macOS 10.9 e posteriores.
A versão atual da CLI do Azure é 2.63.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
O homebrew é a maneira mais fácil de gerenciar a instalação da 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 a CLI do Azure no macOS atualizando as informações de repositório do Brew e executando o comando install
:
brew update && brew install azure-cli
Solução de problemas
Se você encontrar um problema ao instalar a CLI através do Homebrew, aqui estão alguns erros comuns. Se você tiver um problema não abordado aqui, arquive um problema no GitHub.
A conclusão não está funcionando
A fórmula Homebrew da CLI do Azure instala um arquivo de conclusão chamado az
no diretório de conclusões 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
, 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 pequena incompatibilidade de versão ou outro problema durante a instalação do homebrew. A CLI não usa um ambiente virtual Python, portanto, ela se baseia em localizar a versão instalada do Python. Uma possível correção é instalar e revincular 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 versão 1.x da CLI 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.
Conexão de blocos de proxy
Talvez você não consiga obter recursos do Homebrew, a menos que o tenha configurado corretamente para usar seu proxy. Siga as instruções de configuração de proxy do Homebrew.
Importante
Se você estiver atrás de um proxy, as variáveis HTTP_PROXY
e HTTPS_PROXY
precisarão ser definidas para se conectarem aos serviços do Azure com a CLI.
Se você não estiver usando a autenticação básica, é recomendável exportar as variáveis no arquivo .bashrc
.
Sempre siga as políticas de segurança da sua empresa e os requisitos do administrador do sistema.
Para obter os recursos de Bottle do Homebrew, o proxy precisa permitir conexões HTTPS com os seguintes endereços:
https://formulae.brew.sh
https://homebrew.bintray.com
Atualizar
A CLI é atualizada regularmente com correções de bugs, aprimoramentos, novos recursos e funcionalidade de visualização. Uma nova versão fica disponível aproximadamente a cada três semanas.
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
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 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 atualizar o pacote azure-cli
.
brew update && brew upgrade azure-cli
Desinstalar
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.
Use o homebrew para desinstalar o pacote azure-cli
.
brew uninstall azure-cli
Remover dados
Se você não planeja reinstalar a CLI do Azure, remova os respectivos dados.
rm -rf ~/.azure
Outros métodos de instalação
Se você não pode usar o Homebrew para instalar a CLI do Azure em seu ambiente, é possível usar as instruções manuais para o Linux. Esse processo não é oficialmente mantido para ser compatível com o macOS. É sempre 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 as instruções de instalação manual, confira Instalar manualmente a CLI do Azure no Linux.
Próximas etapas
Agora que você instalou a CLI do Azure no macOS, faça um breve tour pelos recursos e comandos mais comuns dela.