Instalar CLI do Azure no macOS – Versão prévia

CLI do Azure é uma ferramenta de linha de comando multiplataforma para gerenciar recursos Azure interativamente ou por meio de scripts.

No macOS, CLI do Azure está fazendo a transição da fórmula Homebrew Core para um modelo de instalação mais mantenedível e flexível. O novo modelo inclui:

  • Homebrew Cask (recomendado para a maioria dos usuários)
  • Tarball (recomendado para ambientes offline ou isolados)

Essa experiência está atualmente em versão prévia e se tornará a abordagem de instalação padrão em uma versão futura.

Por que usar o Homebrew Cask?

  • Experiência de instalação e atualização mais simples
  • Gerencia automaticamente dependências
  • Alinha-se com o futuro modelo de instalação com suporte

O que está mudando

CLI do Azure está evoluindo para dar suporte à autenticação mais segura, incluindo a autenticação baseada em agente. Esses recursos exigem um modelo de instalação baseado no gestor de pacotes Cask. Como resultado, estamos fazendo a transição do Homebrew Core para o Homebrew Cask. Essa alteração não remove nem limita nenhuma funcionalidade de CLI do Azure existente. O Homebrew Cask é totalmente compatível com todos os recursos e versões atuais do CLI do Azure.

Essa alteração melhora a consistência entre ambientes e oferece melhor suporte para cenários como instalação offline e ambientes de implantação controlados.

Importante

CLI do Azure está atualmente em uma fase de avaliação para o modelo de instalação do Homebrew Cask. Durante essa fase, a instalação está disponível somente por meio de um tap personalizado do Homebrew.

  • Método atual: brew install azure-cli
  • Novos métodos (fase de visualização):
    • Homebrew Cask via toque personalizado
      1. brew tap azure/azure-cli
      2. brew install --cask azure-cli-preview
    • Instalação baseada em Tarball

Escolher um método de instalação

Use as diretrizes a seguir para selecionar o método de instalação que melhor se ajusta ao seu cenário:

Scenario Método recomendado
A maioria dos usuários Homebrew Cask
Sistemas offline ou isolados do ar Tarball
Local de instalação personalizado necessário Tarball

Instalar CLI do Azure usando o Homebrew Cask

O Homebrew fornece a experiência de instalação mais simples e mantenedível para CLI do Azure no macOS. Ele manipula a instalação, as atualizações e a remoção usando fluxos de trabalho de gerenciamento de pacote padrão.

Pré-requisitos

  • macOS (Apple Silicon ou Intel)
  • Homebrew instalado

Se CLI do Azure já estiver instalado usando a fórmula Homebrew, desinstale-a antes de continuar para evitar conflitos:

brew uninstall azure-cli

Instalar a CLI do Azure.

Instala-se o CLI do Azure usando o Homebrew Cask do tap personalizado do CLI do Azure. Esse é o único método de instalação Homebrew com suporte durante a fase de visualização.

brew tap azure/azure-cli
brew install --cask azure-cli-preview

Verifique a instalação

Após a instalação, confirme se CLI do Azure está disponível:

az --version

Atualizar CLI do Azure

Para atualizar para a versão mais recente:

brew update && brew upgrade --cask azure-cli-preview

Desinstalar a CLI do Azure

Para remover CLI do Azure:

brew uninstall --cask azure-cli-preview
brew untap azure/azure-cli

Após a fase de visualização

Quando a instalação do Homebrew Cask se torna geralmente disponível:

  • O método de instalação de pré-visualização (azure-cli-preview via comando personalizado) será descontinuado.
  • CLI do Azure estará disponível no repositório homebrew cask oficial.

Instale CLI do Azure usando:

brew install --cask azure-cli
# Or
brew install azure-cli

As instalações existentes usando a fórmula Homebrew Core devem migrar para a instalação baseada em Cask. A fórmula Homebrew Core não terá mais suporte após essa transição.

Instalar CLI do Azure usando um Tarball

Use este método se:

  • Homebrew não está disponível
  • O acesso à Internet é restrito
  • Você precisa de controle total sobre o local de instalação

Esse método é comumente usado em ambientes corporativos, regulados ou isolados da rede.

Pré-requisitos

  • macOS (Apple Silicon ou Intel)
  • Python 3.13 instalado por meio de qualquer método (python.org, pyenv etc.)

Baixar o tarball

Em um computador com acesso à Internet, você pode baixar automaticamente o tarball mais recente da Interface de Linha de Comando do Azure (CLI do Azure) para sua arquitetura.

ARCH=$(uname -m)
VER=$(curl -s https://api.github.com/repos/Azure/azure-cli/releases/latest | grep tag_name | cut -d '"' -f4 | sed 's/azure-cli-//')
curl -L -o az.tar.gz "https://github.com/Azure/azure-cli/releases/download/azure-cli-$VER/azure-cli-$VER-macos-$ARCH.tar.gz"

Esse script detecta sua arquitetura e baixa o pacote tar mais recente do CLI do Azure da página de lançamentos do CLI do Azure.

  • arm64 indica Apple Silicon
  • x86_64 indica Intel

Selecionar a arquitetura correta garante a compatibilidade e o desempenho ideal.

Dica

Para ambientes offline, execute esse comando em um computador com acesso à Internet e, em seguida, transfira o tarball baixado para o sistema de destino.

Extrair para o diretório de instalação

Escolha um diretório em que CLI do Azure deve ser instalado:

mkdir -p $HOME/lib/azure-cli
tar -xzf az.tar.gz -C $HOME/lib/azure-cli

Configurar variáveis de ambiente

CLI do Azure requer acesso a um runtime Python. Configure seu ambiente para apontar para o Python e os binários do CLI do Azure.

Adicione o seguinte ao seu perfil de shell (~/.zshrc ou ~/.bashrc):

export AZ_PYTHON="/path_to_python"
export PATH="/target_directory_path/bin:$PATH"

Recarregue a configuração do shell:

source ~/.zshrc

Verifique a instalação

az --version

Atualizar CLI do Azure

Para atualizar CLI do Azure em um ambiente offline, baixe um Tarball mais recente e extraia-o sobre a instalação existente:

sudo tar -xzf az.tar.gz -C /target_directory_path

Desinstalar a CLI do Azure

Remova o diretório de instalação:

sudo rm -rf /target_directory_path

Em seguida, remova as entradas AZ_PYTHON e PATH do perfil do shell.

Troubleshooting

Se você encontrar um problema ao instalar ou usar o CLI do Azure com o Homebrew Cask ou o método Tarball, aqui estão alguns erros comuns (muitos dos quais são específicos do Homebrew). Se você tiver um problema não abordado aqui, arquive um problema no GitHub.

CLI do Azure não encontrado

Verifique se o PATH inclui o diretório de instalação:

echo $PATH

A conclusão não está funcionando

A instalação do CLI do Azure via Homebrew (seja por fórmula ou cask) fornece um arquivo de conclusão chamado az no diretório de conclusões gerenciadas do Homebrew. Para habilitar a conclusão, siga as instruções do Homebrew.

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. CLI do Azure não usa um ambiente virtual Python, portanto, ele depende de encontrar a versão Python instalada. Uma possível correção é instalar e relinkar a dependência python@3.13 do Homebrew.

brew update && brew install python@3.13 && brew upgrade python@3.13
brew link --overwrite python@3.13

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.

Importante

Se você estiver por trás de um proxy, HTTP_PROXY e HTTPS_PROXY devem ser configurados para se conectar aos serviços do Azure usando a CLI do Azure. Se você não usar autenticação básica, deverá exportar essas variáveis em seu .bashrc arquivo. Sempre siga 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.sh
  • https://homebrew.bintray.com

Próximas etapas

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

Comece a usar o CLI do Azure

  • Last updated on