Instalar a CLI do Azure no macOS - Pré-visualização

O CLI do Azure é uma ferramenta de linha de comandos multiplataforma para gerir recursos do Azure de forma interativa ou através de scripts.

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

  • Homebrew Cask (recomendado para a maioria dos utilizadores)
  • Tarball (recomendado para ambientes offline ou isolados)

Esta experiência está atualmente em pré-visualização e tornar-se-á a abordagem padrão de instalação numa futura versão.

Porque usar Cask Homebrew?

  • A experiência mais simples de instalação e atualização
  • Gerencia automaticamente as dependências
  • Alinha-se com o futuro modelo de instalação suportada

O que está a mudar

A CLI do Azure está a evoluir para suportar autenticação mais segura, incluindo autenticação baseada em corretores. Estas capacidades requerem um modelo de instalação baseado em cask. Como resultado, estamos a fazer a transição do Homebrew Core para o Homebrew Cask. Esta alteração não remove nem limita qualquer funcionalidade existente da CLI do Azure. O Homebrew Cask é totalmente compatível com todas as funcionalidades e versões atuais do CLI do Azure.

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

Importante

O CLI do Azure está atualmente numa fase de pré-visualização para o modelo de instalação do Homebrew Cask. Durante esta fase, a instalação está disponível apenas por meio de um tap Homebrew personalizado.

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

Escolha um método de instalação

Use as seguintes orientações para selecionar o método de instalação que melhor se adequa ao seu cenário:

Scenario Método recomendado
Maioria dos utilizadores Homebrew Cask
Sistemas offline ou isolados Tarball
Local de instalação personalizado necessário Tarball

Instale o CLI do Azure usando o Homebrew Cask

O Homebrew oferece a experiência de instalação mais simples e fácil de manter para CLI do Azure no macOS. Trata da instalação, atualizações e remoção utilizando fluxos de trabalho padrão de gestão de pacotes.

Pré-requisitos

  • macOS (Apple Silicon ou Intel)
  • Homebrew instalado

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

brew uninstall azure-cli

Instalar a CLI do Azure

Isto instala o CLI do Azure usando o Homebrew Cask do CLI do Azure custom tap. Este é o único método de instalação Homebrew suportado durante a fase de pré-visualização.

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

Verificar a instalação

Após a instalação, confirme que o 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 o CLI do Azure:

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

Após a fase de pré-visualização

Quando a instalação do Homebrew Cask se tornar disponível para o público em geral:

  • O método de instalação de pré-visualização (azure-cli-preview através de tap personalizado) será descontinuado.
  • O CLI do Azure estará disponível no repositório oficial do Homebrew Cask.

Instalar CLI do Azure usando:

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

As instalações existentes que utilizam a fórmula Homebrew Core devem migrar para a instalação baseada em Cask. A fórmula Homebrew Core deixará de ser suportada após esta transição.

Instale a CLI do Azure usando um Tarball

Use este método se:

  • Homebrew não está disponível
  • O acesso à Internet é restrito
  • Precisa de controlo total sobre o local de instalação

Este método é frequentemente utilizado em ambientes empresariais, regulados ou isolados ao ar livre.

Pré-requisitos

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

Descarregue o arquivo tar

Numa máquina com acesso à internet, pode descarregar automaticamente o mais recente tarball do CLI do Azure para a 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"

Este script deteta a sua arquitetura e descarrega o mais recente tarball do CLI do Azure a partir da página de versões do CLI do Azure.

  • arm64 indica Apple Silicon
  • x86_64 indica a Intel

Selecionar a arquitetura correta garante compatibilidade e desempenho ótimo.

Sugestão

Para ambientes offline, execute este comando numa máquina com acesso à internet e depois transfira o tarball descarregado para o sistema alvo.

Extrair para o diretório de instalação

Escolha um diretório onde o CLI do Azure deve estar instalado:

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

Configurar variáveis de ambiente

O CLI do Azure requer acesso a um runtime em Python. Configura o teu ambiente para apontar para o Python e para os binários da CLI da Azure.

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

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

Recarregue a configuração do seu terminal:

source ~/.zshrc

Verificar a instalação

az --version

Atualizar CLI do Azure

Para atualizar a CLI do Azure num ambiente offline, descarregue 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

Remover o diretório de instalação:

sudo rm -rf /target_directory_path

De seguida, remova as entradas AZ_PYTHON e PATH do seu perfil de shell.

Troubleshooting

Se encontrar um problema ao instalar ou usar a 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, registre um problema no GitHub.

CLI do Azure não encontrado

Certifique-se de que o seu PATH inclui o diretório de instalação:

echo $PATH

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

A instalação CLI do Azure Homebrew (seja por fórmula ou cask) fornece um ficheiro de completação chamado az no diretório de completações geridas do Homebrew. Para permitir a completação, siga as instruções do Homebrew.

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

Pode haver uma incompatibilidade de versão secundária ou outro problema durante a instalação do homebrew. O CLI do Azure 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.13 do Homebrew.

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

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.

Importante

Se estiver atrás de um proxy, HTTP_PROXY e HTTPS_PROXY devem estar configurados para se ligar aos serviços Azure usando o CLI do Azure. Se você não usa autenticação básica, você deve 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.sh
  • https://homebrew.bintray.com

Próximas Etapas

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

Comece com o CLI do Azure

  • Last updated on