Compartilhar via

Instalar o Azure CLI no Linux

Este artigo explica como instalar o Azure CLI no Linux. Selecione o gerenciador de pacotes apropriado para sua distribuição nas opções na parte superior da página. É recomendável usar o gerenciador de pacotes de uma distribuição linux.

A versão atual do Azure CLI é 2.84.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.

Antes de começar

  • Azure CLI 2.38.2 (lançada em 21 de junho de 2024) é a última versão com suporte no RHEL 7 e centos 7. A Microsoft não está mais fornecendo atualizações ou correções de bugs para essas distribuições.

  • Use o gerenciador de pacotes yum se você estiver usando um sistema Linux que não seja compatível com o gerenciador de pacotes dnf.

Instalar Azure CLI

Para instalar o Azure CLI, siga estas etapas:

  1. Importe a chave do repositório da Microsoft. Para RHEL 10 e CentOS Stream 10,

    sudo rpm --import https://packages.microsoft.com/keys/microsoft-2025.asc

    Para versões inferiores, use o seguinte comando:

     sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc

  2. Para RHEL 10, adicione packages-microsoft-com-prod o repositório:

    sudo dnf install -y https://packages.microsoft.com/config/rhel/10/packages-microsoft-prod.rpm

    Para o CentOS Stream 10, adicione packages-microsoft-com-prod repositório:

    sudo dnf install -y https://packages.microsoft.com/config/centos/10/packages-microsoft-prod.rpm

    Para RHEL 9 ou CentOS Stream 9, adicione packages-microsoft-com-prod o repositório:

    sudo dnf install -y https://packages.microsoft.com/config/rhel/9.0/packages-microsoft-prod.rpm

    Para RHEL 8, adicione packages-microsoft-com-prod o repositório:

    sudo dnf install -y https://packages.microsoft.com/config/rhel/8/packages-microsoft-prod.rpm

    Para RHEL 7, adicione azure-cli o repositório:

    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

    Cuidado

    O fim da vida útil (EOL) do CentOS 7 foi em 30 de junho de 2024. Para obter informações sobre Azure CLI ambientes com suporte, consulte Azure CLI ciclo de vida de suporte

  3. Instale com o comando dnf install.

    sudo dnf install azure-cli

Instalar uma versão específica

Você deve primeiro configurar as informações do repositório azure-cli, conforme mostrado anteriormente. As versões disponíveis podem ser encontradas em Azure CLI notas de versão.

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

    dnf list --showduplicates azure-cli

  2. Para instalar uma versão específica:

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

Atualizar Azure CLI

Começando com a versão 2.11.0, o Azure CLI fornece um comando na ferramenta para atualizar para a versão mais recente.

az upgrade

Esse comando também atualiza 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. Para versões Azure CLI anteriores a 2.11.0, atualize reinstalando conforme descrito em Instale o Azure CLI.

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

sudo dnf update azure-cli

Desinstalar Azure CLI

Se você decidir desinstalar o Azure CLI, lamentamos vê-lo partir. Antes de desinstalar, use o comando az feedback para nos informar sobre o que poderia ser melhorado ou corrigido. Nosso objetivo é tornar o Azure CLI sem bugs e amigável. Se você encontrou um bug, gostaríamos que file um problema de 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

Remova dados

Se você não planeja reinstalar Azure CLI, remova seus dados.

rm -rf ~/.azure

Resoluçã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, file um problema em 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 o pacote python3 e, em seguida, instalar o Azure CLI sem dependências.

Você pode usar o seguinte comando para baixar e instalar o script de instalação do Azure CLI com python 3.6 compilado a partir 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, Azure CLI requer SSL 1.1+ e você precisa criar openssl 1.1 de origem antes de criar 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, compile o Python 3 a partir do código-fonte:

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 da instrução instalar para adicionar o repositório Azure CLI. Agora, você pode baixar o pacote e instalá-lo sem nenhuma dependência.

Observação

Se o plug-in de download dnf ainda não estiver instalado, você encontrará um erro command not found ao executar o código a seguir. 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 usando another repo. Use esse método se você tiver configurado python3, mas ainda estiver recebendo o erro python3: command not found. Verifique se ele foi incluído no seu caminho.

scl enable rh-python36 bash

Proxy bloqueia conexão

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. Você precisa entrar em contato com o administrador do sistema para saber qual(is) host(s) e porta(s) usar nesses proxies.

Os valores nessas variáveis são usados por muitos programas do Linux e durante o 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 por trás de um proxy, essas variáveis de shell deverão ser definidas para conectar-se 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 sempre usar esse proxy. 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

Falha na instalação ou execução da CLI no Windows Subsystem for Linux

Como Windows Subsystem for Linux (WSL) é uma camada de tradução de chamada do sistema na parte superior da plataforma Windows, você pode sofrer um erro ao tentar instalar ou executar o Azure CLI. 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 corrigi-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, é provável que seu problema esteja relacionado ao WSL. Para iniciar uma VM linux no Azure, consulte a documentação criar uma VM Linux no portal Azure documentação.
  • 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 resolver o problema. Frequentemente, há sugestões sobre como contornar o problema ou informações sobre uma versão em que o problema foi corrigido.
  • Se não houver nenhum problema existente para o seu problema, registre um novo problema no WSL e inclua o máximo de informações possível.

Se você continuar com problemas de instalação ou execução no WSL, considere instalar a CLI para Windows.

Antes de começar

  • Azure CLI 2.38.2 (lançada em 21 de junho de 2024) é a versão mais recente com suporte no SUSE Linux Enterprise Server (SLES) e no OpenSUSE (Leap). A Microsoft não está mais fornecendo atualizações ou correções de bugs para essas distribuições.

  • O SUSE mantém e dá suporte a pacotes fornecidos por repositórios SUSE/OpenSUSE.

  • No Azure, as máquinas virtuais (VMs) SUSE e OpenSUSE baseadas em imagens do Azure Marketplace já têm o Azure CLI instalado.

Instalar Azure CLI

Para instalar Azure CLI no SUSE/OpenSUSE, escolha um dos seguintes métodos:

  1. Use o pacote Enterprise fornecido pelo SUSE nos repositórios SUSE/OpenSUSE.

  2. Use o método de instalação descrito na guia "Instalar script (qualquer um)".

  3. Instalar pelos repositórios da Microsoft

Instalar por meio de repositórios SUSE ou OpenSUSE

O pacote RPM do Azure CLI depende do pacote python3.

sudo zypper install -y azure-cli

Instalar pelos repositórios da Microsoft

Para instalar a versão histórica mais recente do Azure CLI usando repositórios da Microsoft, siga estas etapas.

(Este pacote foi testado com SLES 15 e OpenSUSE Leap 15.1.)

  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

    Digite 2 para continuar a instalação, ignorando algumas de suas dependências.

Instalar uma versão específica

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

  1. Exiba as versões disponíveis usando este comando:

    zypper search --details --match-exact azure-cli

  2. Para instalar uma versão específica:

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

Atualizar Azure CLI

Começando com a versão 2.11.0, o Azure CLI fornece um comando na ferramenta para atualizar para a versão mais recente.

az upgrade

Esse comando também atualiza 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. Para versões Azure CLI anteriores a 2.11.0, atualize reinstalando conforme descrito em Instale o Azure CLI.

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

sudo zypper refresh
sudo zypper update azure-cli

Desinstalar Azure CLI

Se você decidir desinstalar o Azure CLI, lamentamos vê-lo partir. Antes de desinstalar, use o comando az feedback para nos informar sobre o que poderia ser melhorado ou corrigido. Nosso objetivo é tornar o Azure CLI sem bugs e amigável. Se você encontrou um bug, gostaríamos que file um problema de 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

Remova dados

Se você não planeja reinstalar Azure CLI, remova seus dados.

rm -rf ~/.azure

Resoluçã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, file um problema em GitHub.

Instalar sem Python 3

Importante

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

Lembre-se de que Python 2 atingiu o fim da vida útil (EOL) em 1º de janeiro de 2020 e não receberá mais atualizações. Azure CLI desistiu do suporte para Python 2.7 desde a versão 2.1.0. Versões mais recentes da CLI podem não ser executadas corretamente usando Python 2.7.

NotImplementedError na VM do OpenSUSE 15

A VM do OpenSUSE 15 tem uma Azure CLI pré-instalada com a versão 2.0.45, que está desatualizada e tem problemas com az login. Remova essa versão junto com suas dependências antes de seguir a instrução Install para adicionar o Azure CLI mais recente:

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

Se você atualizou o Azure CLI sem remover as dependências da versão 2.0.45, suas dependências antigas poderão afetar a versão mais recente do Azure CLI. 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 outros sistemas sem Python 3.6

No SLES 12, o pacote python3 padrão é 3.4 e não é compatível com Azure CLI. 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 a partir da origem. Por fim, você pode baixar o pacote Azure CLI e instalá-lo sem dependência.

Você pode usar o comando a seguir para instalar ou atualizar Azure CLI com base nas etapas acima. O script instala Python 3.8 em /usr/local/azcli e torna Azure CLI usá-lo definindo um alias de 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 a versão do Python ou o local de instalação.

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

Proxy bloqueia conexão

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. Você precisa entrar em contato com o administrador do sistema para saber qual(is) host(s) e porta(s) usar nesses proxies.

Os valores nessas variáveis são usados por muitos programas do Linux e durante o 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 por trás de um proxy, essas variáveis de shell deverão ser definidas para conectar-se 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 sempre usar esse proxy. 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

Falha na instalação ou execução da CLI no Windows Subsystem for Linux

Como Windows Subsystem for Linux (WSL) é uma camada de tradução de chamada do sistema na parte superior da plataforma Windows, você pode sofrer um erro ao tentar instalar ou executar o Azure CLI. 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 corrigi-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, é provável que seu problema esteja relacionado ao WSL. Para iniciar uma VM linux no Azure, consulte a documentação criar uma VM Linux no portal Azure documentação.
  • 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 resolver o problema. Frequentemente, há sugestões sobre como contornar o problema ou informações sobre uma versão em que o problema foi corrigido.
  • Se não houver nenhum problema existente para o seu problema, registre um novo problema no WSL e inclua o máximo de informações possível.

Se você continuar com problemas de instalação ou execução no WSL, considere 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

Antes de começar

  • O gerenciador de pacotes apt contém pacotes x86_64 e ARM64 para o Azure CLI que foi testado nas distribuições a seguir.

    Distribuição Versão
    Debian 11 (Na Mosca), 12 (Leitor ávido)
    Ubuntu 22.04 (Jamy Jellyfish), 24.04 (Noble Numbat)

Instalar Azure CLI

Há duas opções para instalar o Azure CLI em seu sistema. Você pode baixar um script de instalação que executará os comandos de instalação para você ou pode executar os comandos de instalação por conta própria em etapas. Os dois métodos são apresentados abaixo:

Opção 1: Instalar com um comando

A maneira mais fácil de instalar o Azure CLI é por meio de um script mantido pela equipe de Azure CLI. Esse script executa todos os comandos de instalação em uma única 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 primeiro 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 preferir um processo de instalação passo a passo, conclua as etapas a seguir para instalar o Azure CLI.

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

    sudo apt-get update
sudo apt-get install apt-transport-https ca-certificates curl gnupg lsb-release

  2. Baixe e instale a chave de autenticação da Microsoft:

    sudo mkdir -p /etc/apt/keyrings
curl -sLS https://packages.microsoft.com/keys/microsoft.asc |
  gpg --dearmor | sudo tee /etc/apt/keyrings/microsoft.gpg > /dev/null
sudo chmod go+r /etc/apt/keyrings/microsoft.gpg
  3. Adicione o Azure CLI ao repositório de software:
    AZ_DIST=$(lsb_release -cs)
echo "Types: deb
URIs: https://packages.microsoft.com/repos/azure-cli/
Suites: ${AZ_DIST}
Components: main
Architectures: $(dpkg --print-architecture)
Signed-by: /etc/apt/keyrings/microsoft.gpg" | sudo tee /etc/apt/sources.list.d/azure-cli.sources

  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 uma versão específica

Configure as informações do repositório azure-cli, conforme mostrado anteriormente. As versões disponíveis podem ser encontradas em Azure CLI notas de versão.

  1. Exibir versões disponíveis do Azure CLI.

    apt-cache policy azure-cli

  2. Instale uma versão específica.

    # Obtain the currently installed distribution
AZ_DIST=$(lsb_release -cs)

# Store an Azure CLI version of choice
AZ_VER=2.51.0

# Install a specific version
sudo apt-get install azure-cli=${AZ_VER}-1~${AZ_DIST}

    Para instalar uma versão específica sem variáveis, substitua a versão Azure CLI e o nome de distribuição do Linux mostrados:

    sudo apt-get install azure-cli=2.51.0-1~bullseye

Se você receber uma mensagem de erro Não é possível localizar o pacote azure-cli, as informações do repositório azure-cli não estão configuradas. Siga as etapas fornecidas na Opção 2: instruções de instalação passo a passo.

Se você receber uma mensagem de erro A versão x.xx.x-1~distributionName para a azure-cli não foi encontrada, use lsb_release -cs para localizar a distribuição que você está executando.

Atualizar Azure CLI

Começando com a versão 2.11.0, o Azure CLI fornece um comando na ferramenta para atualizar para a versão mais recente.

az upgrade

Esse comando também atualiza 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. Para versões Azure CLI anteriores a 2.11.0, atualize reinstalando conforme descrito em Instale o Azure CLI.

Você também pode usar apt-get upgrade para atualizar o pacote da CLI. Esse comando atualiza todos os pacotes instalados no sistema que não tiveram uma alteração de dependência.

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

Para atualizar apenas a CLI, use apt-get install.

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

Desinstalar Azure CLI

Se você decidir desinstalar o Azure CLI, lamentamos vê-lo partir. Antes de desinstalar, use o comando az feedback para nos informar sobre o que poderia ser melhorado ou corrigido. Nosso objetivo é tornar o Azure CLI sem bugs e amigável. Se você encontrou um bug, gostaríamos que file um problema de GitHub.

  1. Desinstalar com apt-get remove:

    sudo apt-get remove -y azure-cli

  2. Se você não planeja reinstalar a CLI, remova as informações do repositório Azure CLI:

    sudo rm /etc/apt/sources.list.d/azure-cli.sources

  3. Se você não estiver usando nenhum outro pacote da Microsoft, remova a chave de assinatura:

    sudo rm /etc/apt/keyrings/microsoft.gpg

  4. Remova quaisquer pacotes desnecessários:

    sudo apt autoremove

Remova dados

Se você não planeja reinstalar Azure CLI, remova seus dados.

rm -rf ~/.azure

Resoluçã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, file um problema em GitHub.

O pacote azure-cli é compatível com a arquitetura ARM64 a partir da versão 2.46.0 da CLI.

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

Algumas distribuições do Ubuntu ou derivadas 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 disponível para sua distribuição

Às vezes, um pacote do Azure CLI atualizado não está disponível imediatamente após o lançamento da versão de distribuição. O Azure CLI foi projetado para ser resiliente em relação a versões futuras de dependências e depende do menor número 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 experimentar um pacote para uma distribuição anterior, defina o valor de AZ_REPO manualmente ao adicionar o repositório. Para as distribuições do Ubuntu, use o repositório jammy mais recente:

AZ_REPO="jammy"

Para as distribuições do Debian, use o repositório bookworm mais recente:

AZ_REPO="bookworm"

Importante

Não há suporte para as distribuições lançadas antes do Ubuntu Bionic e do Debian Buster.

O EOS (sistema operacional elementar) falha ao instalar o Azure CLI

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

Conteúdo do arquivo original:

Types: deb
URIs: https://packages.microsoft.com/repos/azure-cli/
Suites: hera
Components: main
Architectures: amd64
Signed-by: /etc/apt/keyrings/microsoft.gpg

Conteúdo do arquivo modificado

Types: deb
URIs: https://packages.microsoft.com/repos/azure-cli/
Suites: bionic
Components: main
Architectures: amd64
Signed-by: /etc/apt/keyrings/microsoft.gpg

Proxy bloqueia conexão

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. Você precisa entrar em contato com o administrador do sistema para saber qual(is) host(s) e porta(s) usar nesses proxies.

Os valores nessas variáveis são usados por muitos programas do Linux e durante o 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 por trás de um proxy, essas variáveis de shell deverão ser definidas para conectar-se 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 sempre usar esse proxy. 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.

Falha na instalação ou execução da CLI no Windows Subsystem for Linux

Como Windows Subsystem for Linux (WSL) é uma camada de tradução de chamada do sistema na parte superior da plataforma Windows, você pode sofrer um erro ao tentar instalar ou executar o Azure CLI. 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 corrigi-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, é provável que seu problema esteja relacionado ao WSL. Para iniciar uma VM linux no Azure, consulte a documentação criar uma VM Linux no portal Azure documentação.
  • 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 resolver o problema. Frequentemente, há sugestões sobre como contornar o problema ou informações sobre uma versão em que o problema foi corrigido.
  • Se não houver nenhum problema existente para o seu problema, registre um novo problema no WSL e inclua o máximo de informações possível.

Se você continuar com problemas de instalação ou execução no WSL, considere instalar a CLI para Windows.

Instalar Azure CLI

Os RPMs são lançados para Azure Linux por CBL-Mariner. O pacote azure-cli é compatível com a arquitetura ARM64 a partir da versão 2.46.0 da CLI.

Para instalar o Azure CLI, siga estas etapas:

  1. Instale o conjunto oficial selecionado pela Microsoft de certificados raiz confiáveis.

    sudo tdnf install ca-certificates

  2. Instale Azure CLI:

    sudo tdnf install azure-cli

Instalar uma versão específica

As versões disponíveis podem ser encontradas em Azure CLI notas de versão.

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

tdnf list azure-cli

Para instalar a versão específica:

sudo tdnf install azure-cli-<version>-1

Atualizar Azure CLI

Atualize o Azure CLI com o comando tdnf update:

sudo tdnf update azure-cli

Desinstalar Azure CLI

Se você decidir desinstalar o Azure CLI, lamentamos vê-lo partir. Antes de desinstalar, use o comando az feedback para nos informar sobre o que poderia ser melhorado ou corrigido. Nosso objetivo é tornar o Azure CLI sem bugs e amigável. Se você encontrou um bug, gostaríamos que file um problema de GitHub.

Remover o pacote do seu sistema:

sudo tdnf remove azure-cli

Remova dados

Se você não planeja reinstalar Azure CLI, remova seus dados.

rm -rf ~/.azure

Próximas etapas

Agora que você instalou o Azure CLI, faça um breve tour pelos recursos e comandos comuns.

Comece com o Azure CLI

  • Last updated on