Instalar CLI do Azure com o aptInstall Azure CLI with apt

Se você estiver executando uma distribuição fornecida com apt, como Ubuntu ou Debian, há um pacote x86_64 disponível para a CLI do Azure.If you are running a distribution that comes with apt, such as Ubuntu or Debian, there's an x86_64 package available for the Azure CLI. Este pacote foi testado e é compatível com:This package has been tested with and is supported for:

  • Ubuntu trusty, xenial, artful, bionic e discoUbuntu trusty, xenial, artful, bionic, and disco
  • Debian wheezy, jessie e stretchDebian wheezy, jessie, and stretch

A versão atual da CLI do Azure é a 2.0.71.The current version of the Azure CLI is 2.0.71. 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.

Observação

O pacote para a CLI do Azure instala seu próprio interpretador de Python e não usa o Python do sistema.The package for Azure CLI installs its own Python interpreter, and does not use the system Python.

InstalarInstall

Oferecemos duas maneiras de instalar a CLI do Azure com distribuições que dão suporte a apt: Como um script tudo-em-um que executa os comandos de instalação para você, e instruções que podem ser executadas como um processo passo a passo por conta própria.We offer two ways to install the Azure CLI with distributions that support apt: As an all-in-one script that runs the install commands for you, and instructions that you can run as a step-by-step process on your own.

Instalar com um comandoInstall with one command

Oferecemos e mantemos um script que executa todos os comandos de instalação em uma única etapa.We offer and maintain a script which runs all of the installation commands in one step. Executá-lo usando curl e redirecione diretamente para bash, ou baixe o script para um arquivo e inspecione-o antes da execução.Run it by using curl and pipe directly to bash, or download the script to a file and inspect it before running.

Importante

Esse script é verificado somente para o Ubuntu 16.04+ e Debian 8+.This script is only verified for Ubuntu 16.04+ and Debian 8+. Ele pode não funcionar em outras distribuições.It may not work on other distributions. Se você estiver usando uma distribuição derivada como Linux Mint, siga as instruções de instalação manual e execute qualquer solução de problemas necessária.If you're using a derived distribution such as Linux Mint, follow the manual install instructions and perform any necessary troubleshooting.

curl -sL https://aka.ms/InstallAzureCLIDeb | sudo bash

Instruções para instalação manualManual install instructions

Se você não quiser executar um script como superusuário ou se o script tudo-em-um falhar, siga estas etapas para instalar a CLI do Azure.If you don't want to run a script as superuser or the all-in-one script fails, follow these steps to install the Azure CLI.

  1. Obtenha os pacotes necessários para o processo de instalação:Get packages needed for the install process:

    sudo apt-get update
    sudo apt-get install ca-certificates curl apt-transport-https lsb-release gnupg
    
  2. Baixe e instale a chave de autenticação da Microsoft:Download and install the Microsoft signing key:

    curl -sL https://packages.microsoft.com/keys/microsoft.asc | \
        gpg --dearmor | \
        sudo tee /etc/apt/trusted.gpg.d/microsoft.asc.gpg > /dev/null
    
  3. Adicione o repositório de software da CLI do Azure:Add the Azure CLI software repository:
    AZ_REPO=$(lsb_release -cs)
    echo "deb [arch=amd64] https://packages.microsoft.com/repos/azure-cli/ $AZ_REPO main" | \
        sudo tee /etc/apt/sources.list.d/azure-cli.list
    
  4. Atualize as informações do repositório e instale o pacote azure-cli:Update repository information and install the azure-cli package:

    sudo apt-get update
    sudo apt-get install azure-cli
    

Execute a CLI do Azure com o comando az.Run the Azure CLI with the az command. Para entrar, use o comando az login.To sign in, use the az login command.

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

    az login
    

    Se a CLI pode abrir seu navegador padrão, ela irá fazê-lo e carregar uma página de entrada.If the CLI can open your default browser, it will do so and load a sign-in page.

    Caso contrário, você precisará abrir uma página do navegador e seguir as instruções na linha de comando para inserir um código de autorização depois de navegar até https://aka.ms/devicelogin no navegador.Otherwise, you need to open a browser page and follow the instructions on the command line to enter an authorization code after navigating to https://aka.ms/devicelogin in your browser.

  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

Aqui estão alguns problemas comuns vistos durante a instalação com apt.Here are some common problems seen when installing with apt. 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.

lsb_release não retorna a versão correta da distribuição de baselsb_release does not return the correct base distribution version

Algumas distribuições derivadas do Ubuntu ou do Debian, como o Linux Mint, podem não retornar o nome correto da versão de lsb_release.Some Ubuntu- or Debian-derived distributions such as Linux Mint may not return the correct version name from lsb_release. Esse valor é usado no processo de instalação para determinar o pacote de instalação.This value is used in the install process to determine the package to install. Se você souber o nome do código da versão do Ubuntu ou do Debian da qual sua distribuição é derivada, poderá definir o valor de AZ_REPO manualmente ao adicionar o repositório.If you know the code name of the Ubuntu or Debian version your distribution is derived from, you can set the AZ_REPO value manually when adding the repository. Caso contrário, procure informações para sua distribuição sobre como determinar o nome do código da distribuição de base e defina AZ_REPO com o valor correto.Otherwise, look up information for your distribution on how to determine the base distribution code name and set AZ_REPO to the correct value.

Nenhum pacote para distribuiçãoNo package for your distribution

Às vezes, um pacote da CLI do Azure pode ser disponibilizado somente um tempo depois do lançamento da distribuição.Sometimes it may be a while after a distribution is released before there's an Azure CLI package available for it. A CLI do Azure é projetada para ser resiliente em relação a versões futuras das dependências e precisam da menor quantidade possível delas.The Azure CLI designed to be resilient with regards to future versions of dependencies and rely on as few of them as possible. Se não houver pacotes disponíveis para sua distribuição de base, tente um pacote de uma distribuição anterior.If there's no package available for your base distribution, try a package for an earlier distribution.

Para isso, defina o valor de AZ_REPO manualmente ao adicionar o repositório.To do this, set the value of AZ_REPO manually when adding the repository. Para as distribuições do Ubuntu, use o repositório bionic; para as distribuições do Debian, use stretch.For Ubuntu distributions use the bionic repository, and for Debian distributions use stretch. Não há suporte para as distribuições lançadas antes do Ubuntu Trusty e do Debian Wheezy.Distributions released before Ubuntu Trusty and Debian Wheezy are not supported.

Conexão de blocos de proxyProxy blocks connection

Se você não conseguir se conectar a um recurso externo por causa de um proxy, verifique se as variáveis HTTP_PROXY e HTTPS_PROXY foram definidas corretamente no shell.If you're unable to connect to an external resource due to a proxy, make sure that you've correctly set the HTTP_PROXY and HTTPS_PROXY variables in your shell. Será preciso entrar em contato com o administrador do sistema para saber quais hosts e portas devem ser usados para esses proxies.You will need to contact your system administrator to know what host(s) and port(s) to use for these proxies.

Esses valores são seguidos por vários programas do Linux, incluindo os que são usados no processo de instalação.These values are respected by many Linux programs, including those which are used in the install process. Para definir esses valores:To set these values:

# No auth
export HTTP_PROXY=http://[proxy]:[port]
export HTTPS_PROXY=https://[proxy]:[port]

# Basic auth
export HTTP_PROXY=http://[username]:[password]@[proxy]:[port]
export HTTPS_PROXY=https://[username]:[password]@[proxy]:[port]

Importante

Se você estiver atrás de um proxy, as variáveis do shell precisarão ser definidas para se conectarem aos serviços do Azure com a CLI.If you are behind a proxy, these shell variables 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.

Talvez você queira configurar explicitamente apt para usar esse proxy sempre.You may also want to explicitly configure apt to use this proxy at all times. Verifique se as linhas a seguir aparecem em um arquivo de configuração apt em /etc/apt/apt.conf.d/.Make sure that the following lines appear in an apt configuration file in /etc/apt/apt.conf.d/. É recomendável usar o arquivo de configuração global existente, um arquivo de configuração de proxy existente, 40proxies ou 99local. No entanto, siga os requisitos de administração do sistema.We recommend using either your existing global configuration file, an existing proxy configuration file, 40proxies, or 99local, but follow your system administration requirements.

Acquire {
    http::proxy "http://[username]:[password]@[proxy]:[port]";
    https::proxy "https://[username]:[password]@[proxy]:[port]";
}

Se o proxy não usar autenticação básica, remova a parte [username]:[password]@ do URI do proxy.If your proxy does not use basic auth, remove the [username]:[password]@ portion of the proxy URI. Se você precisar de mais informações sobre a configuração do proxy, confira a documentação oficial do Ubuntu:If you require more information for proxy configuration, see the official Ubuntu documentation:

Para obter a chave de assinatura da Microsoft e o pacote do nosso repositório, o proxy precisa permitir conexões HTTPS com o seguinte endereço:In order to get the Microsoft signing key and get the package from our repository, your proxy needs to allow HTTPS connections to the following address:

  • https://packages.microsoft.com

A CLI não consegue instalar nem ser executada no Subsistema Windows para LinuxCLI fails to install or run on Windows Subsystem for Linux

Como o Subsistema Windows para Linux (WSL) é uma camada de tradução de chamadas do sistema com base na plataforma Windows, você pode encontrar um erro ao tentar instalar ou executar a CLI do Azure.Since Windows Subsystem for Linux (WSL) is a system call translation layer on top of the Windows platform, you might experience an error when trying to install or run the Azure CLI. A CLI depende de alguns recursos que podem apresentar um bug no WSL.The CLI relies on some features that may have a bug in WSL. Caso encontre um erro independentemente da forma de instalação da CLI, há uma boa chance de ser um problema com o WSL, e não com o processo de instalação da CLI.If you experience an error no matter how you install the CLI, there's a good chance it's an issue with WSL and not with the CLI install process.

Para solucionar os problemas de instalação do WSL e possivelmente resolvê-los:To troubleshoot your WSL installation and possibly resolve issues:

  • Se possível, execute um processo de instalação idêntico em um computador Linux ou em uma VM para ver se tem êxito.If you can, run an identical install process on a Linux machine or VM to see if it succeeds. Se isso acontecer, é praticamente certo que o problema está relacionado ao WSL.If it does, your issue is almost certainly related to WSL. Para iniciar uma VM Linux no Azure, consulte a documentação para criar uma VM Linux no Portal do Azure.To start a Linux VM in Azure, see the create a Linux VM in the Azure Portal documentation.
  • Verifique se você está executando a versão mais recente do WSL.Make sure that you're running the latest version of WSL. Para obter a versão mais recente, atualize sua instalação do Windows 10.To get the latest version, update your Windows 10 installation.
  • Verifique se há problemas em aberto com o WSL que possam endereçar o problema.Check for any open issues with WSL which might address your problem. Muitas vezes, haverá sugestões sobre como resolvê-lo ou informações sobre uma versão em que ele será corrigido.Often there will be suggestions on how to work around the problem, or information about a release where the issue will be fixed.
  • Se não houver nenhum problema existente seu caso, registre um novo problema no WSL e inclua o máximo de informações possível.If there are no existing issues for your problem, file a new issue with WSL and make sure that you include as much information as possible.

Se continuar ocorrendo problemas de instalação ou execução no WSL, cogite instalar a CLI para Windows.If you continue to have issues installing or running on WSL, consider installing the CLI for Windows.

AtualizarUpdate

Use apt-get upgrade para atualizar o pacote da CLI.Use apt-get upgrade to update the CLI package.

sudo apt-get update && sudo apt-get upgrade

Observação

Esse comando atualiza todos os pacotes instalados no sistema que não tiveram uma alteração de dependência.This command upgrades all of the installed packages on your system that have not had a dependency change. Para atualizar apenas a CLI, use apt-get install.To upgrade the CLI only, use apt-get install.

sudo apt-get update && sudo apt-get install --only-upgrade -y 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.

  1. Desinstalar com apt-get remove:Uninstall with apt-get remove:

    sudo apt-get remove -y azure-cli
    
  2. Se você não pretender reinstalar a CLI, remova as informações do repositório da CLI do Azure:If you don't plan to reinstall the CLI, remove the Azure CLI repository information:

    sudo rm /etc/apt/sources.list.d/azure-cli.list
    
  3. Remova a chave de autenticação:Remove the signing key:

    sudo rm /etc/apt/trusted.gpg.d/microsoft.asc.gpg
    
  4. Remova quaisquer pacotes desnecessários:Remove any unneeded packages:

    sudo apt autoremove
    

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.