Instalar a CLI do Azure no macOSInstall Azure CLI on macOS

Para a plataforma macOS, pode instalar a CLI do Azure com o gestor 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 sua instalação da atualização da CLI.Homebrew makes it easy to keep your installation of the CLI update to date. O pacote CLI foi testado em versões de macOS 10.9 e posteriores.The CLI package has been tested on macOS versions 10.9 and later.

A versão atual do Azure CLI é de 2.8.0.The current version of the Azure CLI is 2.8.0. Para obter informações sobre a versão mais recente, veja as notas de versão.For information about the latest release, see the release notes. Para encontrar a sua versão instalada e ver se precisa de atualizar, corra 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 forma mais fácil de gerir a instalação da CLI.Homebrew is the easiest way to manage your CLI install. Fornece formas convenientes para instalar, atualizar e desinstalar.It provides convenient ways to install, update, and uninstall. Se não tiver o homebrew disponível no seu sistema, instale-o antes de continuar.If you don't have homebrew available on your system, install homebrew before continuing.

Pode instalar a CLI ao atualizar as informações do repositório brew e, em seguida, ao executar 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

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

Em seguida, pode executar a CLI do Azure com o comando az.You can then run the Azure CLI with the az command. Para iniciar sessão, utilize o comando az login.To sign in, use az login command.

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

    az login
    

    Se o CLI conseguir abrir o seu navegador predefinido, fá-lo-á e carregará uma página de entrada 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 https://aka.ms/devicelogin página do navegador e introduza o código de autorização apresentado no seu terminal.Otherwise, open a browser page at https://aka.ms/devicelogin and enter the authorization code displayed in your terminal.

  2. Inicie sessão com as credenciais da sua conta no browser.Sign in with your account credentials in the browser.

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

Resolução de problemasTroubleshooting

Se ocorrer um problema ao instalar a CLI através do Homebrew, aqui estão alguns dos erros comuns.If you encounter a problem when installing the CLI through Homebrew, here are some common errors. Se detetar um problema que não é mencionado neste artigo, registe um problema no github.If you experience a problem not covered here, file an issue on github.

A conclusão não está a funcionar.Completion is not working

A fórmula homebrew do Azure CLI az instala um ficheiro de conclusão nomeado no /usr/local/etc/bash_completion.d/diretório de conclusões gerido pela Homebrew (a localização padrão é).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 permitir a conclusão, siga asinstruções da 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

É possível que haja um erro de correspondência de versão secundária 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 utiliza um ambiente virtual do Python, pelo que precisa de encontrar 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 solução possível passa por instalar e voltar a ligar 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 uma cache do Homebrew obsoleta.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.

O proxy bloqueia a ligaçãoProxy blocks connection

Pode não conseguir obter recursos da Homebrew a menos que tenha configurado corretamente para usar o seu representante.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 do proxy homebrew.Follow the Homebrew proxy configuration instructions.

Importante

Se estiver por trás HTTP_PROXY HTTPS_PROXY de um proxy, deve ser definido para ligar aos serviços Azure com o CLI.If you are behind a proxy, HTTP_PROXY and HTTPS_PROXY must be set to connect to Azure services with the CLI. Se não estiver a usar o auth básico, é .bashrc aconselhável exportar estas variáveis no seu ficheiro.If you are not using basic auth, it's recommended to export these variables in your .bashrc file. Siga sempre as políticas de segurança do seu negócio e os requisitos do administrador do seu sistema.Always follow your business' security policies and the requirements of your system administrator.

Para obter os recursos da garrafa da Homebrew, o seu representante precisa de permitir ligações HTTPS aos 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 erros, melhoramentos, novas funcionalidades e funcionalidade de pré-visualização.The CLI is regularly updated with bug fixes, improvements, new features, and preview functionality. Está disponível uma nova versão aproximadamente a cada duas semanas.A new release is available roughly every two weeks. Atualize as suas informações de repositório local e então 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 optar por desinstalar a CLI do Azure, é com muita pena que o vemos ir embora.If you decide to uninstall the Azure CLI, we're sorry to see you go. Antes de desinstalar, utilize o comando az feedback para nos indicar o que é possível melhorar ou corrigir.Before you uninstall, use the az feedback command to let us know what could be improved or fixed. O nosso objetivo é tornar a CLI do Azure liver de erros e intuitiva para o utilizador.Our goal is to make the Azure CLI bug-free and user-friendly. Se encontrou um erro, pedimos que registe um problema no GitHub.If you found a bug, we'd appreciate it if you file a GitHub issue.

Utilize 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 não puder utilizar o homebrew para instalar o Azure CLI no seu ambiente, é possível utilizar 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. Note que este 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. Recomenda-se sempre a utilização de um gestor de pacotes como o Homebrew.Using a package manager such as Homebrew is always recommended. Utilize apenas o método de instalação manual se não tiver outra opção disponível.Only use the manual installation method if you have no other option available.

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

Passos SeguintesNext Steps

Agora que instalou a CLI do Azure, dê uma vista de olhos em todas as suas funcionalidades e comandos comuns.Now that you've installed the Azure CLI, take a short tour of its features and common commands.