Instalar a CLI do Azure no macOS
A CLI (Interface de Linha de Comando) do Azure é uma ferramenta de linha de comando de plataforma cruzada 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 o gerenciador de pacotes homebrew. O Homebrew torna mais fácil manter a sua instalação da atualização da CLI. O pacote CLI foi testado em versões de macOS 10.9 e posteriores.
A versão atual da CLI do Azure é 2.67.0. Para obter informações sobre a versão mais recente, veja as notas de versão. Para encontrar sua versão instalada e ver se você precisa atualizar, execute az version.
Instalar com o Homebrew
O homebrew é a forma mais fácil de gerir a instalação da CLI. 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
Resolução de Problemas
Se ocorrer um problema ao instalar a CLI através do Homebrew, aqui estão alguns dos erros comuns. Se você tiver um problema não abordado aqui, registre 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 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
É possível que haja um erro de correspondência de versão secundária ou outro problema durante a instalação do Homebrew. A CLI não utiliza um ambiente virtual do Python, pelo que precisa de encontrar a versão instalada do Python. 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 versão 1.x da CLI 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 tenha configurado corretamente para usar seu proxy. Siga as instruções de configuração do proxy Homebrew.
Importante
Se você estiver atrás de um proxy HTTP_PROXY e HTTPS_PROXY deve ser definido para se conectar aos serviços do Azure com a CLI.
Se você não estiver usando autenticação básica, é recomendável 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.shhttps://homebrew.bintray.com
Atualizar
A CLI é atualizada regularmente com correções de erros, melhoramentos, novas funcionalidades e funcionalidade de pré-visualização. Uma nova versão está 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
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 de 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 o .
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 liver de erros e intuitiva 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 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. Usar um gerenciador de pacotes como o Homebrew é sempre recomendado. 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.
Passos Seguintes
Agora que você instalou a CLI do Azure no macOS, faça um breve tour por seus recursos e comandos comuns.
