Instalar a CLI do Azure no Linux

A CLI do Azure é uma ferramenta de linha de comando multiplataforma que pode ser instalada localmente em computadores Linux. Você pode usar a CLI do Azure no Linux para se conectar ao Azure e executar comandos administrativos sobre os recursos do Azure. A CLI no Linux permite a execução de vários comandos por meio de um terminal usando prompts de linha de comando interativos ou um script. Quando você estiver pronto para instalar a CLI do Azure no Linux, é recomendável usar o gerenciador de pacotes da sua distribuição do Linux. Selecione o gerenciador de pacotes apropriado para a sua distribuição nas opções acima. Se você não tiver nenhum dos gerenciadores de pacotes listados, será possível instalar manualmente a CLI do Azure no Linux selecionando a opção Script de instalação.

A versão atual da CLI do Azure é a 2.30.0. Para saber mais sobre a versão mais recente, veja as notas de versão. Para localizar a versão instalada e ver se você precisa atualizá-la, execute az version.

Visão geral

O gerenciador de pacotes apt contém um pacote x86_64 para a CLI do Azure que foi testado nas distribuições a seguir.

Distribuição Versão
Ubuntu 14.04 LTS (Trusty Tahir), 16.04 LTS (Xenial Xerus), 18.04 LTS (Bionic Beaver), 20.04 LTS (Focal Fossa), 20.10 (Groovy Gorilla)
Debian Debian 8 (Jessie), Debian 9 (Stretch), Debian 10 (Buster)

Aviso

Ubuntu 20.04 (Focal Fossa) e 20.10 (Groovy Gorilla) incluem um pacote azure-cli com a versão 2.0.81 fornecido pelo repositório universe. Esse pacote está desatualizado e não é recomendado. Se esse pacote estiver instalado, remova-o antes de continuar executando o comando sudo apt remove azure-cli -y && sudo apt autoremove -y.

O pacote deb azure-cli não oferece suporte à arquitetura ARM64.

Opções de instalação

Há duas formas de instalar a CLI do Azure no seu sistema. Primeiro, você pode executar um comando que vai baixar um script de instalação e executar os comandos de instalação. Ou, se preferir, você pode executar os comandos de instalação por conta própria em um processo passo a passo. Os dois métodos são apresentados abaixo.

Opção 1: Instalar com um comando

A equipe da CLI do Azure mantém um script para executar todos os comandos de instalação em uma etapa. Esse script é baixado por meio de curl e encaminhado diretamente para bash a fim de instalar a CLI.

Se você quiser inspecionar o conteúdo do script por conta própria antes de executá-lo, basta baixar o script usando curl e inspecioná-lo no seu editor de texto favorito.

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

Opção 2: Instruções de instalação passo a passo

Se você preferir um processo de instalação passo a passo, conclua as etapas a seguir para instalar a CLI do Azure.

  1. Obtenha os pacotes necessários para o processo de instalação:

    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:

    curl -sL https://packages.microsoft.com/keys/microsoft.asc |
        gpg --dearmor |
        sudo tee /etc/apt/trusted.gpg.d/microsoft.gpg > /dev/null
    
  3. Adicione o repositório de software da CLI do Azure:
    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:

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

Instalar versão específica

Você deve primeiro configurar as informações do repositório azure-cli, conforme mostrado acima. As versões disponíveis podem ser encontradas nas Notas sobre a versão da CLI do Azure.

  1. Para exibir as versões disponíveis com o comando:

    apt-cache policy azure-cli
    
  2. Para instalar a versão específica:

    sudo apt-get install azure-cli=<version>-1~bullseye
    

Solução de problemas

Aqui estão alguns problemas comuns vistos durante a instalação com apt. Se você tiver um problema não abordado aqui, arquive um problema no github.

Nenhum problema com o módulo no Ubuntu 20.04 (Focal)/WSL

Se você tiver instalado azure-cli em Focal sem adicionar o repositório de software da CLI do Azure na etapa 3 das instruções de instalação manual ou sem usar nosso script, poderá encontrar problemas indicando, por exemplo, que não há nenhum módulo chamado "decorator" ou "antlr4", já que o pacote instalado é o azure-cli 2.0.81 desatualizado do repositório focal/universe. Remova-a primeiro executando sudo apt remove azure-cli -y && sudo apt autoremove -y e, em seguida, siga as instruções acima para instalar o pacote azure-cli mais recente.

lsb_release não retorna a versão correta da distribuição de base

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. Esse valor é usado no processo de instalação para determinar o pacote de instalação. 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. 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.

Nenhum pacote para distribuição

Às vezes, um pacote da CLI do Azure pode ser disponibilizado somente um tempo depois do lançamento da distribuição. 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. Se não houver pacotes disponíveis para sua distribuição de base, tente um pacote de uma distribuição anterior.

Para isso, defina o valor de AZ_REPO manualmente ao adicionar o repositório. Para as distribuições do Ubuntu, use o repositório bionic; para as distribuições do Debian, use stretch. Não há suporte para as distribuições lançadas antes do Ubuntu Trusty e do Debian Wheezy.

O EOS (SO elementar) falha ao instalar a CLI do Azure

O EOS não consegue instalar a CLI do Azure porque lsb_release retorna HERA, que é o nome da versão de EOS. A solução é corrigir o arquivo /etc/apt/sources.list.d/azure-cli.list e alterar hera main para bionic main.

Conteúdo do arquivo original:

deb [arch=amd64] https://packages.microsoft.com/repos/azure-cli/ hera main

Conteúdo do arquivo modificado

deb [arch=amd64] https://packages.microsoft.com/repos/azure-cli/ bionic main

Conexão de blocos de proxy

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. Será preciso entrar em contato com o administrador do sistema para saber quais hosts e portas devem ser usados para esses proxies.

Esses valores são seguidos por vários programas do Linux, incluindo os que são usados no processo de instalação. Para definir esses valores:

# 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. Se você não estiver usando a autenticação básica, é recomendável exportar as variáveis no arquivo .bashrc. Sempre siga as políticas de segurança da sua empresa e os requisitos do administrador do sistema.

Talvez você queira configurar explicitamente apt para usar esse proxy sempre. Verifique se as linhas a seguir aparecem em um arquivo de configuração apt em /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.

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. Se você precisar de mais informações sobre a configuração do proxy, confira a documentação oficial do Ubuntu:

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:

  • https://packages.microsoft.com

A CLI não consegue instalar nem ser executada no Subsistema Windows para 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. A CLI depende de alguns recursos que podem apresentar um bug no 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.

Para solucionar os problemas de instalação do WSL e possivelmente resolvê-los:

  • Se possível, execute um processo de instalação idêntico em um computador Linux ou em uma VM para ver se tem êxito. Se isso acontecer, é praticamente certo que o problema está relacionado ao WSL. Para iniciar uma VM Linux no Azure, consulte a documentação para criar uma VM Linux no Portal do Azure.
  • Verifique se você está executando a versão mais recente do WSL. Para obter a versão mais recente, atualize sua instalação do Windows 10.
  • Verifique se há problemas em aberto com o WSL que possam endereçar o problema. Muitas vezes, haverá sugestões sobre como resolvê-lo ou informações sobre uma versão em que ele será corrigido.
  • 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.

Se continuar ocorrendo problemas de instalação ou execução no WSL, cogite instalar a CLI para Windows.

Atualizar

A CLI fornece um comando na ferramenta para atualizar para a versão mais recente:

az upgrade

Observação

O comando az upgrade foi adicionado à versão 2.11.0 e não funcionará nas versões anteriores a 2.11.0. Versões mais antigas podem ser atualizadas sendo reinstaladas conforme descrito em Instalar a CLI do Azure.

Esse comando também atualizará todas as extensões instaladas por padrão. Para obter mais opções de az upgrade, confira a página de referência do comando.

Você também pode usar apt-get upgrade para atualizar o pacote da CLI.

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. Para atualizar apenas a CLI, use apt-get install.

sudo apt-get update && sudo apt-get install --only-upgrade -y azure-cli

Desinstalar

Se você decidir desinstalar a CLI do Azure, lamentamos sua saída. Antes de desinstalar, use o comando az feedback para nos informar sobre o que poderia ser melhorado ou corrigido. Nosso objetivo é deixar a CLI do Azure livre de bugs e amigável ao usuário. Se você encontrou um erro, agradeceríamos se registrasse um problema do GitHub.

  1. Desinstalar com 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:

    sudo rm /etc/apt/sources.list.d/azure-cli.list
    
  3. Se você não usa nenhum outro pacote da Microsoft, remova a chave de assinatura:

    sudo rm /etc/apt/trusted.gpg.d/microsoft.gpg
    
  4. Remova quaisquer pacotes desnecessários:

    sudo apt autoremove
    

Visão geral

Para distribuições Linux com dnf, como o RHEL, Fedora ou CentOS há um pacote para a CLI do Azure. Este pacote foi testado com RHEL 7.7, RHEL 8, Fedora 24 e superior, CentOS 7 e CentOS 8.

A versão atual da CLI do Azure é a 2.30.0. Para saber mais sobre a versão mais recente, veja as notas de versão. Para localizar a versão instalada e ver se você precisa atualizá-la, execute az version.

Importante

O pacote RPM da CLI do Azure depende do pacote python3. Em seu sistema, isso pode ser uma versão do Python que antecede o requisito do Python 3.6.x. Se isso afeta você, localize um pacote python3 de substituição.

Lembre-se de que o Python 2 foi retirado do mercado em 1º de janeiro de 2020 e não receberá mais atualizações. A CLI do Azure não é mais compatível com o Python 2.7 desde a versão 2.1.0. Não há garantia de que as novas versões serão executadas com o Python 2.7 corretamente.

Observação

Use o gerenciador de pacotes yum se você estiver utilizando sistemas Linux que não dão suporte ao gerenciador de pacotes dnf.

Instalar

  1. Importe a chave do repositório da Microsoft.

    sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
    
  2. Crie informações sobre o repositório do local azure-cli.

    echo -e "[azure-cli]
    name=Azure CLI
    baseurl=https://packages.microsoft.com/yumrepos/azure-cli
    enabled=1
    gpgcheck=1
    gpgkey=https://packages.microsoft.com/keys/microsoft.asc" | sudo tee /etc/yum.repos.d/azure-cli.repo
    
  3. Instale com o comando dnf install.

    sudo dnf install azure-cli
    

Instalar versão específica

Você deve primeiro configurar as informações do repositório azure-cli, conforme mostrado acima. As versões disponíveis podem ser encontradas nas Notas sobre a versão da CLI do Azure.

  1. Para exibir as versões disponíveis com o comando:

    dnf list --showduplicates azure-cli
    
  2. Para instalar a versão específica:

    sudo dnf install azure-cli-<version>-1.el7
    

Solução de problemas

Aqui estão alguns problemas comuns vistos durante a instalação com dnf. Se você tiver um problema não abordado aqui, arquive um problema no GitHub.

Instalar no RHEL 7.6 ou em outros sistemas sem Python 3

Se puder, atualize seu sistema para uma versão com suporte oficial para o pacote python 3.6+. Caso contrário, primeiro, você precisará instalar um pacote do python3 e instalar a CLI do Azure sem nenhuma dependência.

Use o seguinte comando para instalar a CLI do Azure com o python 3.6 compilado da origem:

curl -sL https://azurecliprod.blob.core.windows.net/rhel7_6_install.sh | sudo bash

Faça isso também passo a passo:

Primeiro, a CLI do Azure exige o SSL 1.1+ e você precisará criar o openssl 1.1 da origem antes de compilar o python3:

$ sudo dnf install gcc gcc-c++ make ncurses patch wget tar zlib zlib-devel -y
# build openssl from source
$ cd ~
$ wget https://www.openssl.org/source/openssl-1.1.1d.tar.gz
$ tar -xzf openssl-1.1.1d.tar.gz
$ cd openssl-1.1.1d
$ ./config --prefix=/usr/local/ssl --openssldir=/usr/local/ssl
$ make
$ sudo make install
# configure shared object lookup directory so that libssl.so.1.1 can be found
$ echo "/usr/local/ssl/lib" | sudo tee /etc/ld.so.conf.d/openssl-1.1.1d.conf
# reload config
$ sudo ldconfig -v

Em seguida, crie o Python 3 da origem:

$ PYTHON_VERSION="3.6.9"
$ PYTHON_SRC_DIR=$(mktemp -d)
$ wget -qO- https://www.python.org/ftp/python/$PYTHON_VERSION/Python-$PYTHON_VERSION.tgz | tar -xz -C "$PYTHON_SRC_DIR"
$ cd $PYTHON_SRC_DIR/Python-$PYTHON_VERSION
$ ./configure --prefix=/usr --with-openssl=/usr/local/ssl
$ make
$ sudo make install

Por fim, siga as etapas 1 e 2 das instruções de instalação para adicionar o repositório da CLI do Azure. Agora, você pode baixar o pacote e instalá-lo sem nenhuma dependência.

Observação

Caso você não tenha o plug-in de download do dnf instalado, um erro de comando não encontrado será exibido durante a execução do código abaixo. Use dnf install 'dnf-command(download)' para instalar o plug-in de download do dnf.

$ sudo dnf download azure-cli
$ sudo rpm -ivh --nodeps azure-cli-*.rpm

Como alternativa, você também pode instalar o Python 3 por meio de um repositório adicional. Seguindo esse procedimento, se você configurou o python3 mas ainda está recebendo um erro do python3: command not found ao tentar executar a CLI, adicione-o ao caminho.

$ scl enable rh-python36 bash

Conexão de blocos de proxy

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. Será preciso entrar em contato com o administrador do sistema para saber quais hosts e portas devem ser usados para esses proxies.

Esses valores são seguidos por vários programas do Linux, incluindo os que são usados no processo de instalação. Para definir esses valores:

# 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. Se você não estiver usando a autenticação básica, é recomendável exportar as variáveis no arquivo .bashrc. Sempre siga as políticas de segurança da sua empresa e os requisitos do administrador do sistema.

Talvez você queira configurar explicitamente dnf para usar esse proxy sempre. Verifique se as linhas a seguir aparecem na seção [main] de /etc/dnf/dnf.conf:

[main]
# ...
proxy=http://[proxy]:[port] # If your proxy requires https, change http->https
proxy_username=[username] # Only required for basic auth
proxy_password=[password] # Only required for basic auth

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:

  • https://packages.microsoft.com

A CLI não consegue instalar nem ser executada no Subsistema Windows para 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. A CLI depende de alguns recursos que podem apresentar um bug no 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.

Para solucionar os problemas de instalação do WSL e possivelmente resolvê-los:

  • Se possível, execute um processo de instalação idêntico em um computador Linux ou em uma VM para ver se tem êxito. Se isso acontecer, é praticamente certo que o problema está relacionado ao WSL. Para iniciar uma VM Linux no Azure, consulte a documentação para criar uma VM Linux no Portal do Azure.
  • Verifique se você está executando a versão mais recente do WSL. Para obter a versão mais recente, atualize sua instalação do Windows 10.
  • Verifique se há problemas em aberto com o WSL que possam endereçar o problema. Muitas vezes, haverá sugestões sobre como resolvê-lo ou informações sobre uma versão em que ele será corrigido.
  • 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.

Se continuar ocorrendo problemas de instalação ou execução no WSL, cogite instalar a CLI para Windows.

Atualizar

A CLI fornece um comando na ferramenta para atualizar para a versão mais recente:

az upgrade

Observação

O comando az upgrade foi adicionado à versão 2.11.0 e não funcionará nas versões anteriores a 2.11.0. Versões mais antigas podem ser atualizadas sendo reinstaladas conforme descrito em Instalar a CLI do Azure.

Esse comando também atualizará todas as extensões instaladas por padrão. Para obter mais opções de az upgrade, confira a página de referência do comando.

Você também pode atualizar a CLI do Azure com o comando dnf update.

sudo dnf update azure-cli

Desinstalar

Se você decidir desinstalar a CLI do Azure, lamentamos sua saída. Antes de desinstalar, use o comando az feedback para nos informar sobre o que poderia ser melhorado ou corrigido. Nosso objetivo é deixar a CLI do Azure livre de bugs e amigável ao usuário. Se você encontrou um erro, agradeceríamos se registrasse um problema do GitHub.

  1. Remova o pacote do seu sistema.

    sudo dnf remove azure-cli
    
  2. Se você não pretende reinstalar a CLI, remova as informações do repositório.

    sudo rm /etc/yum.repos.d/azure-cli.repo
    
  3. Se você não usa outros pacotes da Microsoft, remova a chave de assinatura.

    MSFT_KEY=`rpm -qa gpg-pubkey /* --qf "%{version}-%{release} %{summary}\n" | grep Microsoft | awk '{print $1}'`
    sudo rpm -e --allmatches gpg-pubkey-$MSFT_KEY
    

Visão geral

Para distribuições Linux com zypper, como o openSUSE ou SLES, há um pacote disponível para a CLI do Azure. Este pacote foi testado com openSUSE Leap 15.1 e SLES 15.

A versão atual da CLI do Azure é a 2.30.0. Para saber mais sobre a versão mais recente, veja as notas de versão. Para localizar a versão instalada e ver se você precisa atualizá-la, execute az version.

Importante

O pacote RPM da CLI do Azure depende do pacote python3. Em seu sistema, isso pode ser uma versão do Python que antecede o requisito do Python 3.6.x. Se isso afeta você, localize um pacote python3 de substituição.

Lembre-se de que o Python 2 foi retirado do mercado em 1º de janeiro de 2020 e não receberá mais atualizações. A CLI do Azure não é mais compatível com o Python 2.7 desde a versão 2.1.0. Não há garantia de que as novas versões serão executadas com o Python 2.7 corretamente.

Instalar

  1. Instale curl:

    sudo zypper install -y curl
    
  2. Importe a chave de repositório da Microsoft:

    sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
    
  3. Crie informações sobre o repositório do azure-cli local:

    sudo zypper addrepo --name 'Azure CLI' --check https://packages.microsoft.com/yumrepos/azure-cli azure-cli
    
  4. Atualize o índice de pacote do zypper e instale:

    sudo zypper install --from azure-cli azure-cli
    

    Entrada 2 para continuar a instalar, ignorando algumas dependências.

Instalar versão específica

Você deve primeiro configurar as informações do repositório azure-cli, conforme mostrado acima. As versões disponíveis podem ser encontradas nas Notas sobre a versão da CLI do Azure.

  1. Para exibir as versões disponíveis com o comando:

    zypper search --details --match-exact azure-cli
    
  2. Para instalar a versão específica:

    sudo zypper install --from azure-cli azure-cli=<version>-1.el7
    

Solução de problemas

Aqui estão alguns problemas comuns vistos durante a instalação com zypper. Se você tiver um problema não abordado aqui, arquive um problema no GitHub.

NotImplementedError na VM do OpenSUSE 15

A VM do OpenSUSE 15 tem uma CLI do Azure pré-instalada com a versão 2.0.45, que está desatualizada e apresenta problemas com o comando az login. Remova-a junto com as dependências antes de seguir as instruções de instalação para adicionar a última CLI do Azure:

sudo zypper rm -y --clean-deps azure-cli

Se você atualizou a CLI do Azure sem remover as dependências da versão 2.0.45, as dependências antigas podem afetar a última versão da CLI do Azure. Você precisará adicionar novamente a versão antiga para vinculá-la às dependências e remover a azure-cli junto com as dependências:

# The package name may vary on different system version, run 'zypper --no-refresh info azure-cli' to check the source package format
sudo zypper install --oldpackage azure-cli-2.0.45-4.22.noarch

sudo zypper rm -y --clean-deps azure-cli

Instalar no SLES 12 ou em sistemas sem o Python 3.6

No SLES 12, o pacote python3 padrão é 3.4 e não é compatível com a CLI do Azure. Primeiro, siga as etapas 1 a 3 das instruções de instalação para adicionar o repositório da azure-cli. Em seguida, crie uma versão posterior do python3 da origem. Por fim, você poderá baixar o pacote da CLI do Azure e instalá-lo sem nenhuma dependência.

Use o comando a seguir para instalar ou atualizar a CLI do Azure de acordo com as etapas acima. O script instalará o Python 3.8 em /usr/local/azcli e fará com que a CLI do Azure use-o definindo um alias igual a az para PATH=/usr/local/azcli/bin:$PATH az. Baixe também o script e modifique-o de acordo com suas necessidades. Por exemplo, você pode alterar o local de instalação ou a versão do Python.

curl -sL https://azurecliprod.blob.core.windows.net/sles12_install_v2.sh | sudo bash

Ao instalá-lo pela primeira vez, lembre-se de executar o seguinte comando para ativar o alias:

source ~/.bashrc

Conexão de blocos de proxy

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. Será preciso entrar em contato com o administrador do sistema para saber quais hosts e portas devem ser usados para esses proxies.

Esses valores são seguidos por vários programas do Linux, incluindo os que são usados no processo de instalação. Para definir esses valores:

# 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. Se você não estiver usando a autenticação básica, é recomendável exportar as variáveis no arquivo .bashrc. Sempre siga as políticas de segurança da sua empresa e os requisitos do administrador do sistema.

Talvez você queira configurar explicitamente zypper (por meio de yast2) para usar esse proxy sempre. Para fazer isso, execute o comando yast2 proxy como superusuário e preencha as informações apresentadas no formulário. Se você tiver um gerenciador de janelas disponível no sistema, também poderá usar o painel Network Services > Proxy no YaST Control Center.

Para configurações avançadas ou mais informações, confira a documentação de configuração do Proxy do OpenSUSE

Para obter a chave de assinatura da Microsoft e o pacote do nosso repositório, o proxy precisa permitir conexões HTTPS com os seguintes endereços:

  • https://packages.microsoft.com
  • https://download.opensuse.org

A CLI não consegue instalar nem ser executada no Subsistema Windows para 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. A CLI depende de alguns recursos que podem apresentar um bug no 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.

Para solucionar os problemas de instalação do WSL e possivelmente resolvê-los:

  • Se possível, execute um processo de instalação idêntico em um computador Linux ou em uma VM para ver se tem êxito. Se isso acontecer, é praticamente certo que o problema está relacionado ao WSL. Para iniciar uma VM Linux no Azure, consulte a documentação para criar uma VM Linux no Portal do Azure.
  • Verifique se você está executando a versão mais recente do WSL. Para obter a versão mais recente, atualize sua instalação do Windows 10.
  • Verifique se há problemas em aberto com o WSL que possam endereçar o problema. Muitas vezes, haverá sugestões sobre como resolvê-lo ou informações sobre uma versão em que ele será corrigido.
  • 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.

Se continuar ocorrendo problemas de instalação ou execução no WSL, cogite instalar a CLI para Windows.

Problema com o certificado SSL

Quando um certificado é inválido ou está desatualizado em um computador, você pode receber um erro indicando que o cURL falhou ao verificar a legitimidade do servidor e, portanto, não foi possível estabelecer uma conexão segura. Atualize o certificado para corrigir o problema.

sudo zypper update-ca-certificates

Atualizar

A CLI fornece um comando na ferramenta para atualizar para a versão mais recente:

az upgrade

Observação

O comando az upgrade foi adicionado à versão 2.11.0 e não funcionará nas versões anteriores a 2.11.0. Versões mais antigas podem ser atualizadas sendo reinstaladas conforme descrito em Instalar a CLI do Azure.

Esse comando também atualizará todas as extensões instaladas por padrão. Para obter mais opções de az upgrade, confira a página de referência do comando.

Você também pode atualizar o pacote com o comando zypper update.

sudo zypper refresh
sudo zypper update azure-cli

Desinstalar

Se você decidir desinstalar a CLI do Azure, lamentamos sua saída. Antes de desinstalar, use o comando az feedback para nos informar sobre o que poderia ser melhorado ou corrigido. Nosso objetivo é deixar a CLI do Azure livre de bugs e amigável ao usuário. Se você encontrou um erro, agradeceríamos se registrasse um problema do GitHub.

  1. Remova o pacote do seu sistema.

    sudo zypper remove -y azure-cli
    
  2. Se você não pretende reinstalar a CLI, remova as informações do repositório.

    sudo zypper removerepo azure-cli
    
  3. Se você não usa outros pacotes da Microsoft, remova a chave de assinatura da Microsoft.

    MSFT_KEY=`rpm -qa gpg-pubkey /* --qf "%{version}-%{release} %{summary}\n" | grep Microsoft | awk '{print $1}'`
    sudo rpm -e --allmatches gpg-pubkey-$MSFT_KEY
    

Visão geral

Observação

É altamente recomendável instalar a CLI com um gerenciador de pacotes. Um gerenciador de pacotes garante que você sempre obtenha as atualizações mais recentes, além da estabilidade dos componentes da CLI. Verifique e veja se há um pacote de distribuição antes de instalar manualmente.

A CLI requer o seguinte software:

Importante

A CLI não é mais compatível com o Python 2.7 desde a versão 2.1.0. Não há garantia de que as novas versões serão executadas com o Python 2.7 corretamente.

Instalar ou atualizar

Instalar e atualizar a CLI exige executar novamente o script de instalação. Instale a CLI executando curl.

curl -L https://aka.ms/InstallAzureCli | bash

O script também pode ser baixado e executado localmente. Talvez você precise reiniciar o shell para que as alterações entrem em vigor.

Solução de problemas

Aqui estão alguns problemas comuns observados durante uma instalação manual. Se você tiver um problema não abordado aqui, arquive um problema no GitHub.

Erro "Objeto movido" de cURL

Se você receber um erro de curl relacionado ao parâmetro -L ou uma mensagem de erro incluindo o texto "Objeto movido", tente usar a URL completa em vez da aka.ms de redirecionamento:

curl https://azurecliprod.blob.core.windows.net/install | bash

az comando não encontrado

Se não conseguir executar o comando após a instalação e usar bash ou zsh, limpe o cache do hash de comando do shell. Executar

hash -r

e verificar se o problema foi resolvido.

O problema também pode ocorrer se você não reiniciou o shell após a instalação. Verifique se o local do comando az está no $PATH. A localização do comando az é

<install path>/bin

Conexão de blocos de proxy

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. Será preciso entrar em contato com o administrador do sistema para saber quais hosts e portas devem ser usados para esses proxies.

Esses valores são seguidos por vários programas do Linux, incluindo os que são usados no processo de instalação. Para definir esses valores:

# 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. Se você não estiver usando a autenticação básica, é recomendável exportar as variáveis no arquivo .bashrc. Sempre siga as políticas de segurança da sua empresa e os requisitos do administrador do sistema.

Para obter os scripts de instalação, o proxy precisa permitir conexões HTTPS com os seguintes endereços:

  • https://aka.ms/
  • https://azurecliprod.blob.core.windows.net/
  • https://pypi.python.org
  • Pontos de extremidade usados pelo gerenciador de pacotes da distribuição (se houver) para pacotes essenciais

A CLI não consegue instalar nem ser executada no Subsistema Windows para 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. A CLI depende de alguns recursos que podem apresentar um bug no 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.

Para solucionar os problemas de instalação do WSL e possivelmente resolvê-los:

  • Se possível, execute um processo de instalação idêntico em um computador Linux ou em uma VM para ver se tem êxito. Se isso acontecer, é praticamente certo que o problema está relacionado ao WSL. Para iniciar uma VM Linux no Azure, consulte a documentação para criar uma VM Linux no Portal do Azure.
  • Verifique se você está executando a versão mais recente do WSL. Para obter a versão mais recente, atualize sua instalação do Windows 10.
  • Verifique se há problemas em aberto com o WSL que possam endereçar o problema. Muitas vezes, haverá sugestões sobre como resolvê-lo ou informações sobre uma versão em que ele será corrigido.
  • 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.

Se continuar ocorrendo problemas de instalação ou execução no WSL, cogite instalar a CLI para Windows.

Desinstalar

Se você decidir desinstalar a CLI do Azure, lamentamos sua saída. Antes de desinstalar, use o comando az feedback para nos informar sobre o que poderia ser melhorado ou corrigido. Nosso objetivo é deixar a CLI do Azure livre de bugs e amigável ao usuário. Se você encontrou um erro, agradeceríamos se registrasse um problema do GitHub.

Desinstale a CLI excluindo diretamente os arquivos do local escolhido no momento da instalação. O local de instalação padrão é $HOME.

  1. Remova os arquivos da CLI instalados.

    rm -r <install location>/lib/azure-cli
    rm <install location>/bin/az
    
  2. Modifique o arquivo $HOME/.bash_profile para remover a seguinte linha:

    <install location>/lib/azure-cli/az.completion
    
  3. Se usar bash ou zsh, recarregue o cache de comando do shell.

    hash -r
    

Remover dados

Se você não planeja reinstalar a CLI do Azure, remova os respectivos dados.

rm -rf ~/.azure

Próximas etapas

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