Instalar Azure CLI no macOS

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

Para a plataforma macOS, instala o Azure CLI com gestor de pacotes homebrew. O homebrew facilita manter a instalação da Azure CLI atualizada. O pacote Azure CLI requer macOS 13 ou superior.

A versão atual do Azure CLI é 2.84.0. Para obter informações sobre a versão mais recente, consulte as notas de versão. Para encontrar sua versão instalada e ver se você precisa atualizar, execute az version.

Instale com Homebrew

O homebrew é a forma mais fácil de gerir a tua instalação da Azure 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.

Podes instalar o Azure CLI no macOS atualizando a informação do teu repositório de brew e depois executando o comando install:

brew update && brew install azure-cli

Solução de problemas

Se encontrar um problema ao instalar a Azure CLI através do Homebrew, aqui ficam alguns erros comuns. Se tiver um problema não abordado aqui, apresenta uma reclamação no GitHub.

O preenchimento automático não está a funcionar

A fórmula Homebrew do Azure CLI instala um ficheiro de conclusão chamado az no diretório de completações gerido pelo Homebrew (a localização 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 consigo encontrar Python nem pacotes instalados

Pode haver uma incompatibilidade de versão secundária ou outro problema durante a instalação do homebrew. A Azure CLI não utiliza um ambiente virtual em Python, por isso depende de encontrar a versão Python instalada. 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 do Azure 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 configure para usar seu proxy. Siga as instruções de configuração do proxy 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

A Azure CLI é regularmente atualizada com correções de bugs, melhorias, novas funcionalidades e funcionalidades de pré-visualização. Uma nova versão está disponível cerca de uma vez por mês.

A partir da versão 2.11.0, o Azure CLI 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 do comando. Para Azure CLI versões 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, em seguida, atualizar o azure-cli pacote.

brew update && brew upgrade azure-cli

Desinstale

Se decidires desinstalar a Azure CLI, lamentamos ver-te embora. Antes de desinstalar, utilize o comando az feedback para nos indicar o que é possível melhorar ou corrigir. O nosso objetivo é tornar a Azure CLI livre de bugs e fácil de usar. Se encontraram um bug, agradeceríamos que apresentassem uma GitHub questão.

Utilize o Homebrew para desinstalar o pacote azure-cli.

brew uninstall azure-cli

Remover os dados

Se não planeia reinstalar a Azure CLI, remova os seus dados.

rm -rf ~/.azure

Outros métodos de instalação

Se não conseguires usar homebrew para instalar a Azure CLI no teu ambiente, é possível usar as instruções manuais para Linux. Este processo não é oficialmente mantido para ser compatível com macOS. Recomenda-se o uso de um gerenciador de pacotes como o Homebrew. Use o método de instalação manual apenas se não tiver outra opção disponível.

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

Próximas Etapas

Agora que instalou a Azure CLI no macOS, faça uma breve visita às suas funcionalidades e comandos comuns.