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.