Partilhar via


Instalar a Azure CLI no Linux

Este artigo explica como instalar a Azure CLI no Linux. Selecione o gerenciador de pacotes apropriado para sua distribuição nas opções na parte superior da página. Recomenda-se o uso do gerenciador de pacotes de uma distribuição Linux.

A versão atual do Azure CLI é 2.84.0. Para obter informações sobre a versão mais recente, consulte as notas de versão. Para encontrar sua versão instalada e ver se você precisa atualizar, execute az version.

Antes de começar

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

  • Use o yum gerenciador de pacotes se estiver usando um sistema Linux que não suporte o dnf gerenciador de pacotes.

Install Azure CLI

Para instalar o Azure CLI, siga estes passos:

  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 repositório:

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

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

    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 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 repositório:

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

    Para RHEL 7, adicione azure-cli 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
    

    Atenção

    CentOS 7 End Of Life (EOL) foi 30 de junho de 2024. Para obter informações sobre os ambientes suportados do Azure CLI, consulte ciclo de vida do suporte do Azure CLI

  3. Instalar com o comando dnf install.

    sudo dnf install azure-cli
    

Instalar versão específica

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

  1. Para visualizar 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

A partir da versão 2.11.0, o Azure CLI fornece um comando na ferramenta para atualizar para a versão mais recente.

az upgrade

Este comando também atualiza todas as extensões instaladas por predefinição. Para obter mais az upgrade opções, consulte a página de referência do comando. Para Azure CLI versões anteriores a 2.11.0, atualize reinstalando conforme descrito em Instale o Azure CLI.

Também podes atualizar o Azure CLI com o comando dnf update.

sudo dnf update azure-cli

Desinstalar Azure CLI

Se decidires desinstalar a Azure CLI, lamentamos ver-te embora. Antes de desinstalar, utilize o comando az feedback para nos indicar o que é possível melhorar ou corrigir. O nosso objetivo é tornar a Azure CLI livre de bugs e fácil de usar. Se encontraram um bug, agradeceríamos que apresentassem uma GitHub questão.

  1. Remova o pacote do seu sistema.

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

    sudo rm /etc/yum.repos.d/azure-cli.repo
    
  3. Se você não usar nenhum outro pacote 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
    

Remover os dados

Se não planeia reinstalar a Azure CLI, remova os seus dados.

rm -rf ~/.azure

Solução de problemas

Seguem-se alguns problemas comuns vistos durante a instalação com dnf. Se tiver um problema não abordado aqui, apresenta uma reclamação no GitHub.

Instale no RHEL 7.6 ou noutros sistemas sem Python 3

Se puderes, atualiza o teu sistema para uma versão com suporte oficial para o pacote python 3.6+. Caso contrário, primeiro tens de instalar um pacote python3 e depois instalar Azure CLI sem dependências.

Pode usar o seguinte comando para descarregar e instalar o script de instalação Azure CLI com python 3.6 construído a partir da fonte:

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

Você também pode fazê-lo passo a passo:

Primeiro, Azure CLI requer SSL 1.1+ e precisas de construir openssl 1.1 a partir da fonte antes de construir 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

Depois constrói Python 3 a partir da 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 os passos 1 e 2 da instrução install para adicionar o repositório Azure CLI. Agora você pode baixar o pacote e instalá-lo sem dependência.

Observação

Se o plugin de download dnf ainda não estiver instalado, você encontrará um command not found erro ao executar o código a seguir. Utilize dnf install 'dnf-command(download)' para instalar a extensão de download do gestor de pacotes dnf.

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

Como alternativa, também podes instalar Python 3 usando outro repositório. Use este método, se você configurou python3 , mas ainda está recebendo o erro python3: command not found. Certifique-se de que foi incluído no seu caminho.

scl enable rh-python36 bash

O proxy bloqueia a ligação

Se você não conseguir se conectar a um recurso externo devido a um proxy, certifique-se de ter definido corretamente as HTTP_PROXY variáveis e HTTPS_PROXY em seu shell. Você precisa entrar em contato com o administrador do sistema para saber quais hosts e porta(s) usar(em) para esses proxies.

Os valores nessas variáveis são usados por muitos programas Linux e durante o processo de instalação. Para definir estes 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 estiveres atrás de um proxy, estas variáveis shell têm de ser definidas para se ligarem aos serviços do Azure com a CLI. Se você não estiver usando autenticação básica, é recomendável exportar essas variáveis em seu .bashrc arquivo. Siga sempre as políticas de segurança da sua empresa e os requisitos do administrador do sistema.

Você também pode querer configurar dnf explicitamente para sempre usar esse proxy. Certifique-se de que as seguintes linhas apareçam na secção [main]:

[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, seu proxy precisa permitir conexões HTTPS para o seguinte endereço:

  • https://packages.microsoft.com

A CLI falha em instalar ou correr no Windows Subsystem for Linux

Como Windows Subsystem for Linux (WSL) é uma camada de tradução de chamadas de sistema sobre a plataforma Windows, pode experienciar um erro ao tentar instalar ou executar a Azure CLI. A CLI depende de alguns recursos que podem ter um bug no WSL. Se você tiver um erro, não importa como você instala a CLI, há uma boa chance de que seja um problema com a WSL e não com o processo de instalação da CLI.

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

  • Se puder, execute um processo de instalação idêntico em uma máquina Linux ou VM para ver se ele é bem-sucedido. Se isso acontecer, é provável que seu problema esteja relacionado à WSL. Para iniciar uma VM Linux em Azure, consulte a documentação criar uma VM Linux no portal .
  • Certifique-se de que você está executando a versão mais recente do WSL. Para obter a versão mais recente, atualize a sua instalação Windows 10.
  • Verifique se há problemas em aberto com o WSL que possam abordar o seu problema. Muitas vezes, 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 problemas existentes para o seu problema, registre um novo problema com o WSL e certifique-se de incluir o máximo de informações possível.

Se continuares a ter problemas a instalar ou correr em WSL, considera instalar o CLI para Windows.

Antes de começar

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

  • A SUSE mantém e suporta pacotes fornecidos pelos repositórios SUSE/OpenSUSE.

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

Install Azure CLI

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

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

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

  3. Instalar a partir de repositórios da Microsoft

Instalar a partir de repositórios SUSE ou OpenSUSE

O pacote RPM do Azure CLI depende do pacote python3.

sudo zypper install -y azure-cli

Instalar a partir de repositórios da Microsoft

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

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

  1. Instalar 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 azure-cli local:

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

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

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

Instalar versão específica

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

  1. Veja 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

A partir da versão 2.11.0, o Azure CLI fornece um comando na ferramenta para atualizar para a versão mais recente.

az upgrade

Este comando também atualiza todas as extensões instaladas por predefinição. Para obter mais az upgrade opções, consulte a página de referência do comando. Para Azure CLI versões anteriores a 2.11.0, atualize reinstalando conforme descrito em Instale o Azure CLI.

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

sudo zypper refresh
sudo zypper update azure-cli

Desinstalar Azure CLI

Se decidires desinstalar a Azure CLI, lamentamos ver-te embora. Antes de desinstalar, utilize o comando az feedback para nos indicar o que é possível melhorar ou corrigir. O nosso objetivo é tornar a Azure CLI livre de bugs e fácil de usar. Se encontraram um bug, agradeceríamos que apresentassem uma GitHub questão.

  1. Remova o pacote do seu sistema.

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

    sudo zypper removerepo azure-cli
    
  3. Se você não usar 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
    

Remover os dados

Se não planeia reinstalar a Azure CLI, remova os seus dados.

rm -rf ~/.azure

Solução de problemas

Seguem-se alguns problemas comuns vistos durante a instalação com zypper. Se tiver um problema não abordado aqui, apresenta uma reclamação no GitHub.

Instalar sem Python 3

Importante

O pacote RPM do Azure CLI depende do pacote python3. No teu sistema, isto pode ser uma versão em Python que antecede o requisito do Python 3.6.x. Se isto o afetar, encontre um pacote de substituição python3 .

Esteja ciente de que o Python 2 atingiu o fim de vida útil (EOL) a 1 de janeiro de 2020 e já não receberá atualizações. Azure CLI deixou de suportar Python 2.7 desde a versão 2.1.0. Versões mais recentes da CLI podem não correr corretamente usando Python 2.7.

NotImplementedError na VM OpenSUSE 15

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

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

Se atualizou a Azure CLI sem remover as dependências da versão 2.0.45, as dependências antigas podem afetar a versão mais recente da Azure CLI. Você precisa adicionar de volta a versão antiga para vincular às suas dependências e, em seguida, remover azure-cli junto com suas 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

Instale no SLES 12 ou noutros sistemas sem Python 3.6

No SLES 12, o pacote predefinido python3 é o 3.4 e não é suportado pela Azure CLI. Você pode primeiro seguir a etapa 1-3 da instrução de instalação para adicionar o azure-cli repositório. Em seguida, crie uma versão python3 superior a partir do código-fonte. Finalmente, pode descarregar o pacote Azure CLI e instalá-lo sem dependências.

Pode usar o comando seguinte para instalar ou atualizar a Azure CLI com base nos passos acima. O script instala o Python 3.8 sob /usr/local/azcli e faz com que o Azure CLI o utilize definindo um alias de az para PATH=/usr/local/azcli/bin:$PATH az. Você também pode baixar o script e modificá-lo de acordo com suas necessidades. Por exemplo, podes 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

Na primeira instalação, lembre-se de executar o seguinte comando para ativar o alias.

source ~/.bashrc

O proxy bloqueia a ligação

Se você não conseguir se conectar a um recurso externo devido a um proxy, certifique-se de ter definido corretamente as HTTP_PROXY variáveis e HTTPS_PROXY em seu shell. Você precisa entrar em contato com o administrador do sistema para saber quais hosts e porta(s) usar(em) para esses proxies.

Os valores nessas variáveis são usados por muitos programas Linux e durante o processo de instalação. Para definir estes 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 estiveres atrás de um proxy, estas variáveis shell têm de ser definidas para se ligarem aos serviços do Azure com a CLI. Se você não estiver usando autenticação básica, é recomendável exportar essas variáveis em seu .bashrc arquivo. Siga sempre as políticas de segurança da sua empresa e os requisitos do administrador do sistema.

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

Para obter configuração avançada ou mais informações, consulte a documentação de configuração do OpenSUSE Proxy

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

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

A CLI falha em instalar ou correr no Windows Subsystem for Linux

Como Windows Subsystem for Linux (WSL) é uma camada de tradução de chamadas de sistema sobre a plataforma Windows, pode experienciar um erro ao tentar instalar ou executar a Azure CLI. A CLI depende de alguns recursos que podem ter um bug no WSL. Se você tiver um erro, não importa como você instala a CLI, há uma boa chance de que seja um problema com a WSL e não com o processo de instalação da CLI.

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

  • Se puder, execute um processo de instalação idêntico em uma máquina Linux ou VM para ver se ele é bem-sucedido. Se isso acontecer, é provável que seu problema esteja relacionado à WSL. Para iniciar uma VM Linux em Azure, consulte a documentação criar uma VM Linux no portal .
  • Certifique-se de que você está executando a versão mais recente do WSL. Para obter a versão mais recente, atualize a sua instalação Windows 10.
  • Verifique se há problemas em aberto com o WSL que possam abordar o seu problema. Muitas vezes, 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 problemas existentes para o seu problema, registre um novo problema com o WSL e certifique-se de incluir o máximo de informações possível.

Se continuares a ter problemas a instalar ou correr em WSL, considera instalar o CLI para Windows.

Problema do certificado SSL

Quando um certificado está quebrado ou desatualizado em uma máquina, você pode receber um erro indicando que o curl não conseguiu verificar a legitimidade do servidor e, portanto, não pôde estabelecer uma conexão segura. Atualize o certificado para corrigir o problema.

sudo zypper update-ca-certificates

Antes de começar

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

    Distribuição Versão
    Debian 11 (Bullseye), 12 (Rato de biblioteca)
    Ubuntu 22.04 (Jammy Jellyfish), 24.04 (Noble Numbate)

Install Azure CLI

Existem duas opções para instalar a Azure CLI no seu sistema. Você pode baixar um script de instalação que executa os comandos de instalação para você, ou você mesmo pode executar os comandos de instalação em um processo passo a passo. Ambos os métodos são fornecidos aqui:

Opção 1: Instalar com um comando

A forma mais fácil de instalar a Azure CLI é através de um script mantido pela equipa da Azure CLI. Este script executa todos os comandos de instalação em uma única etapa. Este script é baixado via curl e canalizado diretamente para bash instalar a CLI.

Se você deseja inspecionar o conteúdo do script antes de executar, baixe o script primeiro usando curl e inspecione-o em 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, complete os seguintes passos para instalar a 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. Transfira e instale a chave de assinatura 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. Adicionar o repositório de software Azure CLI:
    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 azure-cli pacote:

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

Instalar versão específica

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

  1. Consulte as 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 da distribuição Linux mostrado:

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

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

Se receberes a mensagem de erro Versão x.xx.x-1~distributionName para azure-cli não foi encontrada, usa lsb_release -cs para encontrar a distribuição que estás a executar.

Atualizar Azure CLI

A partir da versão 2.11.0, o Azure CLI fornece um comando na ferramenta para atualizar para a versão mais recente.

az upgrade

Este comando também atualiza todas as extensões instaladas por predefinição. Para obter mais az upgrade opções, consulte a página de referência do comando. Para Azure CLI versões 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 CLI. Este comando atualiza todos os pacotes instalados no seu sistema que não tiveram uma alteração de dependência.

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

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

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

Desinstalar Azure CLI

Se decidires desinstalar a Azure CLI, lamentamos ver-te embora. Antes de desinstalar, utilize o comando az feedback para nos indicar o que é possível melhorar ou corrigir. O nosso objetivo é tornar a Azure CLI livre de bugs e fácil de usar. Se encontraram um bug, agradeceríamos que apresentassem uma GitHub questão.

  1. Desinstale com apt-get remove:

    sudo apt-get remove -y azure-cli
    
  2. Se não planeia reinstalar a CLI, remova a informação do repositório do Azure CLI:

    sudo rm /etc/apt/sources.list.d/azure-cli.sources
    
  3. Se você não estiver usando outros pacotes da Microsoft, remova a chave de assinatura:

    sudo rm /etc/apt/keyrings/microsoft.gpg
    
  4. Remova todos os pacotes desnecessários:

    sudo apt autoremove
    

Remover os dados

Se não planeia reinstalar a Azure CLI, remova os seus dados.

rm -rf ~/.azure

Solução de problemas

Seguem-se alguns problemas comuns vistos durante a instalação com apt. Se tiver um problema não abordado aqui, apresenta uma reclamação no GitHub.

O azure-cli pacote suporta a arquitetura ARM64 da CLI versão 2.46.0.

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

Algumas distribuições do Ubuntu ou outras derivadas do Debian (como o Linux Mint) podem não retornar o nome correto da versão de lsb_release. Este valor é utilizado no processo de instalação para determinar o pacote a instalar. Se você sabe o nome de código da versão Ubuntu ou Debian da qual sua distribuição é derivada, você pode definir o AZ_REPO valor manualmente ao adicionar o repositório. Caso contrário, procure informações para sua distribuição sobre como determinar o nome do código de distribuição base e definir AZ_REPO para o valor correto.

Nenhum pacote para sua distribuição

Por vezes, um pacote Azure CLI atualizado não está imediatamente disponível após o lançamento de uma versão de distribuição. A Azure CLI foi concebida para ser resiliente a futuras versões de dependências e depende do menor número possível delas. Se não houver nenhum pacote disponível para sua distribuição base, tente um pacote para uma distribuição anterior.

Para tentar um pacote para uma distribuição anterior, defina o valor de AZ_REPO manualmente ao adicionar o repositório. Para distribuições do Ubuntu, use o repositório mais recente jammy :

AZ_REPO="jammy"

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

AZ_REPO="bookworm"

Importante

Distribuições lançadas antes do Ubuntu Bionic e Debian Buster não são suportadas.

O Elementary OS (EOS) falha em instalar a Azure CLI

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

Conteúdo original do ficheiro:

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

O proxy bloqueia a ligação

Se você não conseguir se conectar a um recurso externo devido a um proxy, certifique-se de ter definido corretamente as HTTP_PROXY variáveis e HTTPS_PROXY em seu shell. Você precisa entrar em contato com o administrador do sistema para saber quais hosts e porta(s) usar(em) para esses proxies.

Os valores nessas variáveis são usados por muitos programas Linux e durante o processo de instalação. Para definir estes 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 estiveres atrás de um proxy, estas variáveis shell têm de ser definidas para se ligarem aos serviços do Azure com a CLI. Se você não estiver usando autenticação básica, é recomendável exportar essas variáveis em seu .bashrc arquivo. Siga sempre as políticas de segurança da sua empresa e os requisitos do administrador do sistema.

Você também pode querer configurar apt explicitamente para sempre usar esse proxy. Verifique se as seguintes linhas aparecem em um arquivo de configuração apt em /etc/apt/apt.conf.d/. Recomendamos usar o arquivo de configuração global existente, 40proxiesum arquivo de configuração de proxy existente ou 99local, mas 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 [username]:[password]@ parte do URI do proxy. Se você precisar de mais informações para a configuração de proxy, consulte a documentação oficial do Ubuntu:

Para obter a chave de assinatura da Microsoft e obter o pacote do nosso repositório, seu proxy precisa permitir conexões HTTPS para o seguinte endereço: 'https://packages.microsoft.com.

A CLI falha em instalar ou correr no Windows Subsystem for Linux

Como Windows Subsystem for Linux (WSL) é uma camada de tradução de chamadas de sistema sobre a plataforma Windows, pode experienciar um erro ao tentar instalar ou executar a Azure CLI. A CLI depende de alguns recursos que podem ter um bug no WSL. Se você tiver um erro, não importa como você instala a CLI, há uma boa chance de que seja um problema com a WSL e não com o processo de instalação da CLI.

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

  • Se puder, execute um processo de instalação idêntico em uma máquina Linux ou VM para ver se ele é bem-sucedido. Se isso acontecer, é provável que seu problema esteja relacionado à WSL. Para iniciar uma VM Linux em Azure, consulte a documentação criar uma VM Linux no portal .
  • Certifique-se de que você está executando a versão mais recente do WSL. Para obter a versão mais recente, atualize a sua instalação Windows 10.
  • Verifique se há problemas em aberto com o WSL que possam abordar o seu problema. Muitas vezes, 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 problemas existentes para o seu problema, registre um novo problema com o WSL e certifique-se de incluir o máximo de informações possível.

Se continuares a ter problemas a instalar ou correr em WSL, considera instalar o CLI para Windows.

Install Azure CLI

Os RPMs são lançados para Azure Linux através de CBL-Mariner. O azure-cli pacote suporta a arquitetura ARM64 da CLI versão 2.46.0.

Para instalar o Azure CLI, siga estes passos:

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

    sudo tdnf install ca-certificates
    
  2. Install Azure CLI:

    sudo tdnf install azure-cli
    

Instalar versão específica

As versões disponíveis podem ser encontradas em Azure CLI notas de lançamento.

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

tdnf list azure-cli

Para instalar uma versão específica:

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

Atualizar Azure CLI

Atualize a Azure CLI com o comando tdnf update:

sudo tdnf update azure-cli

Desinstalar Azure CLI

Se decidires desinstalar a Azure CLI, lamentamos ver-te embora. Antes de desinstalar, utilize o comando az feedback para nos indicar o que é possível melhorar ou corrigir. O nosso objetivo é tornar a Azure CLI livre de bugs e fácil de usar. Se encontraram um bug, agradeceríamos que apresentassem uma GitHub questão.

Remova o pacote do seu sistema:

sudo tdnf remove azure-cli

Remover os dados

Se não planeia reinstalar a Azure CLI, remova os seus dados.

rm -rf ~/.azure

Próximas Etapas

Agora que instalou a Azure CLI, faça uma breve visita às suas funcionalidades e comandos comuns.