Instalar a CLI do Azure no macOSInstall Azure CLI on macOS

Para a plataforma macOS, você pode instalar a CLI do Azure com o gerenciador de pacotes homebrew.For the macOS platform, you can install the Azure CLI with homebrew package manager. O Homebrew torna mais fácil manter a instalação da CLI atualizada.Homebrew makes it easy to keep your installation of the CLI update to date. O pacote da CLI foi testado em versões do macOS 10.9 e posteriores.The CLI package has been tested on macOS versions 10.9 and later.

A versão atual da CLI do Azure é a 2.8.0.The current version of the Azure CLI is 2.8.0. Para saber mais sobre a versão mais recente, veja as notas de versão.For information about the latest release, see the release notes. Para localizar sua versão instalada e ver se você precisar atualizá-la, execute az --version.To find your installed version and see if you need to update, run az --version.

Instalar com o HomebrewInstall with Homebrew

O homebrew é a maneira mais fácil de gerenciar a instalação da CLI.Homebrew is the easiest way to manage your CLI install. Ele fornece maneiras convenientes de instalar, atualizar e desinstalar.It provides convenient ways to install, update, and uninstall. Se você não tiver o homebrew disponível em seu sistema, instale-o antes de continuar.If you don't have homebrew available on your system, install homebrew before continuing.

Você pode instalar a CLI atualizando suas informações de repositório brew e executando o comando install:You can install the CLI by updating your brew repository information, and then running the install command:

brew update && brew install azure-cli

Importante

A CLI do Azure tem uma dependência no pacote python3 do Homebrew, e a instalará.The Azure CLI has a dependency on the Homebrew python3 package, and will install it. A CLI do Azure é certamente compatível com a versão mais recente do python3 publicada no Homebrew.The Azure CLI is guaranteed to be compatible with the latest version of python3 published on Homebrew.

É possível executar a CLI do Azure com o comando az.You can then run the Azure CLI with the az command. Para entrar, use o comando az login.To sign in, use az login command.

  1. Execute o comando login.Run the login command.

    az login
    

    Se a CLI puder abrir o navegador padrão, ela o fará e carregará uma página de entrada do Azure.If the CLI can open your default browser, it will do so and load an Azure sign-in page.

    Caso contrário, abra uma página de navegador em https://aka.ms/devicelogin e insira o código de autorização exibido no terminal.Otherwise, open a browser page at https://aka.ms/devicelogin and enter the authorization code displayed in your terminal.

  2. Entre com suas credenciais de conta no navegador.Sign in with your account credentials in the browser.

Para saber mais sobre os diferentes métodos de autenticação, confira Entrar com a CLI do Azure.To learn more about different authentication methods, see Sign in with Azure CLI.

solução de problemasTroubleshooting

Se você encontrar um problema ao instalar a CLI através do Homebrew, aqui estão alguns erros comuns.If you encounter a problem when installing the CLI through Homebrew, here are some common errors. Se você tiver um problema não abordado aqui, arquive um problema no github.If you experience a problem not covered here, file an issue on github.

A conclusão não está funcionandoCompletion is not working

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/).The Homebrew formula of Azure CLI installs a completion file named az in the Homebrew-managed completions directory (default location is /usr/local/etc/bash_completion.d/). Para habilitar a conclusão, siga as instruções do Homebrew aqui.To enable completion, please follow Homebrew's instructions here.

Não é possível localizar o Python ou os pacotes instaladosUnable to find Python or installed packages

Pode haver uma pequena incompatibilidade de versão ou outro problema durante a instalação do homebrew.There may be a minor version mismatch or other issue during homebrew installation. A CLI não usa um ambiente virtual Python, portanto, ela se baseia em localizar a versão instalada do Python.The CLI doesn't use a Python virtual environment, so it relies on finding the installed Python version. Uma possível correção é instalar e revincular a dependência python3 do Homebrew.A possible fix is to install and relink the python3 dependency from Homebrew.

brew update && brew install python3 && brew upgrade python3
brew link --overwrite python3

A versão 1.x da CLI está instaladaCLI version 1.x is installed

Se tiver sido instalada uma versão desatualizada, pode ser devido a um cache de homebrew obsoleto.If an out-of-date version was installed, it could be because of a stale homebrew cache. Siga as instruções de atualização.Follow the update instructions.

Conexão de blocos de proxyProxy blocks connection

Talvez você não consiga obter recursos do Homebrew, a menos que o tenha configurado corretamente para usar seu proxy.You may be unable to get resources from Homebrew unless you have correctly configured it to use your proxy. Siga as instruções de configuração de proxy do Homebrew.Follow the Homebrew proxy configuration instructions.

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.If you are behind a proxy, HTTP_PROXY and HTTPS_PROXY must be set to connect to Azure services with the CLI. Se você não estiver usando a autenticação básica, é recomendável exportar as variáveis no arquivo .bashrc.If you are not using basic auth, it's recommended to export these variables in your .bashrc file. Sempre siga as políticas de segurança da sua empresa e os requisitos do administrador do sistema.Always follow your business' security policies and the requirements of your system administrator.

Para obter os recursos de Bottle do Homebrew, o proxy precisa permitir conexões HTTPS com os seguintes endereços:In order to get the bottle resources from Homebrew, your proxy needs to allow HTTPS connections to the following addresses:

  • https://formulae.brew.sh
  • https://homebrew.bintray.com

AtualizarUpdate

A CLI é atualizada regularmente com correções de bugs, aprimoramentos, novos recursos e funcionalidade de visualização.The CLI is regularly updated with bug fixes, improvements, new features, and preview functionality. Uma nova versão fica disponível aproximadamente a cada duas semanas.A new release is available roughly every two weeks. Atualize as informações do repositório local e atualize o pacote azure-cli.Update your local repository information and then upgrade the azure-cli package.

brew update && brew upgrade azure-cli

DesinstalarUninstall

Se você decidir desinstalar a CLI do Azure, lamentamos sua saída.If you decide to uninstall the Azure CLI, we're sorry to see you go. Antes de desinstalar, use o comando az feedback para nos informar sobre o que poderia ser melhorado ou corrigido.Before you uninstall, use the az feedback command to let us know what could be improved or fixed. Nosso objetivo é deixar a CLI do Azure livre de bugs e amigável ao usuário.Our goal is to make the Azure CLI bug-free and user-friendly. Se você encontrou um erro, agradeceríamos se registrasse um problema do GitHub.If you found a bug, we'd appreciate it if you file a GitHub issue.

Use o homebrew para desinstalar o pacote azure-cli.Use homebrew to uninstall the azure-cli package.

brew uninstall azure-cli

Outros métodos de instalaçãoOther installation methods

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.If you can't use homebrew to install the Azure CLI in your environment, it's possible to use the manual instructions for Linux. Observe que esse processo não é oficialmente mantido para ser compatível com o macOS.Note that this process is not officially maintained to be compatible with macOS. É sempre recomendável usar um gerenciador de pacotes, como o Homebrew.Using a package manager such as Homebrew is always recommended. Somente use o método de instalação manual se não tiver nenhuma outra opção disponível.Only use the manual installation method if you have no other option available.

Para as instruções de instalação manual, confira Instalar manualmente a CLI do Azure no Linux.For the manual installation instructions, see Install Azure CLI on Linux manually.

Próximas etapasNext Steps

Agora que você instalou a CLI do Azure, faça um tour breve de seus recursos e comandos comuns.Now that you've installed the Azure CLI, take a short tour of its features and common commands.