Instalar a CLI do Azure no Linux

Este artigo explica como instalar a CLI do Azure no Linux. Selecione o gerenciador de pacotes apropriado para sua distribuição nas opções na parte superior da página. O uso do gerenciador de pacotes de uma distribuição Linux é recomendado, mas você pode instalar manualmente a CLI do Azure no Linux selecionando a opção Instalar script .

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

Antes de começar

• A CLI do Azure 2.38.2 (lançada em 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.

• A Microsoft continua a desenvolver e dar suporte à CLI do Azure e ao script de Instalação do Linux.

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

Instalar a CLI do Azure

Para instalar a CLI do Azure, siga estas etapas:

1. Importar a chave de repositório da Microsoft.

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

2. Para RHEL 9 ou CentOS Stream, 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 ambientes suportados pela CLI do Azure, consulte Ciclo de vida de suporte da CLI do Azure

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 nas notas de versão da CLI do Azure.

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 a CLI do Azure

A partir da versão 2.11.0, a CLI do Azure 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 de comando. Para versões da CLI do Azure anteriores à 2.11.0, atualize reinstalando conforme descrito em Instalar a CLI do Azure.

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

sudo dnf update azure-cli

Desinstalar a CLI do Azure

Se optar por desinstalar a CLI do Azure, é com muita pena que o vemos ir embora. Antes de desinstalar, utilize o comando az feedback para nos indicar o que é possível melhorar ou corrigir. O nosso objetivo é tornar a CLI do Azure liver de erros e intuitiva para o utilizador. Se encontrou um erro, pedimos que registe um problema no GitHub.

1. Remova o pacote do 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 dados

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

rm -rf ~/.azure

Resolução de Problemas

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

Instale no RHEL 7.6 ou em outros sistemas sem Python 3

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

Você pode usar o seguinte comando para baixar e instalar o script de instalação da CLI do Azure com python 3.6 o build from source:

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

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

Primeiro, a CLI do Azure requer SSL 1.1+ e você precisa criar openssl 1.1 a partir do código-fonte 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, construa 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 de instalação para adicionar o repositório da CLI do Azure. Agora você pode baixar o pacote e instalá-lo sem dependência.

Nota

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. Use dnf install 'dnf-command(download)' para instalar o plugin de download dnf.

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

Como alternativa, você também pode instalar o Python 3 usando outro repo. 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 você estiver atrás de um proxy, essas variáveis de shell devem ser definidas para se conectar 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 /etc/dnf/dnf.confque as seguintes linhas aparecem na [main] seção de :

[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 não consegue instalar ou executar no Subsistema Windows para Linux

Como o Subsistema do Windows para Linux (WSL) é uma camada de conversão de chamada do sistema sobre a plataforma Windows, você pode enfrentar um erro ao tentar instalar ou executar a CLI do Azure. 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 de instalação do WSL e possivelmente resolver problemas:

• 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 no Azure, consulte Criar uma VM Linux na documentação do portal do Azure.
• Certifique-se de que você está executando a versão mais recente do WSL. Para obter a versão mais recente, atualize a instalação do Windows 10.
• Verifique se há problemas em aberto com a WSL que possam resolver 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 você continuar a ter problemas para instalar ou executar no WSL, considere instalar a CLI para Windows.

Antes de começar

• A CLI do Azure 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.

• A Microsoft continua a desenvolver e dar suporte à CLI do Azure e ao script de Instalação do Linux. 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 CLI do Azure instalada.

Instalar a CLI do Azure

Para instalar a CLI do Azure 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 guia "Instalar script (qualquer)".

3. Instalar a partir de repositórios da Microsoft

Instalar a partir de repositórios SUSE ou OpenSUSE

O pacote RPM da CLI do Azure depende do python3 pacote.

sudo zypper install -y azure-cli

Instalar com o script de instalação

Você pode instalar manualmente a CLI do Azure em qualquer versão do Linux usando a opção Instalar script .

Se você estiver atualizando para a versão mais recente usando esse método, certifique-se de desinstalar a versão anterior primeiro e todos os repositórios que você possa ter adicionado para essa versão.

Instalar a partir de repositórios da Microsoft

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

(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
   

   Entrada 2 para continuar a instalação ignorando algumas de 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 versão da CLI do Azure.

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 a CLI do Azure

A partir da versão 2.11.0, a CLI do Azure 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 de comando. Para versões da CLI do Azure anteriores à 2.11.0, atualize reinstalando conforme descrito em Instalar a CLI do Azure.

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

sudo zypper refresh
sudo zypper update azure-cli

Desinstalar a CLI do Azure

Se optar por desinstalar a CLI do Azure, é com muita pena que o vemos ir embora. Antes de desinstalar, utilize o comando az feedback para nos indicar o que é possível melhorar ou corrigir. O nosso objetivo é tornar a CLI do Azure liver de erros e intuitiva para o utilizador. Se encontrou um erro, pedimos que registe um problema no GitHub.

1. Remova o pacote do 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 dados

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

rm -rf ~/.azure

Resolução de Problemas

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

Instalar sem Python 3

Importante

O pacote RPM da CLI do Azure depende do python3 pacote. No seu sistema, esta pode ser uma versão Python anterior ao requisito do Python 3.6.x. Se isto o afetar, encontre um pacote de substituição python3 .

Esteja ciente de que o Python 2 chegou ao fim da vida útil (EOL) em 1º de janeiro de 2020 e não receberá mais atualizações. A CLI do Azure descartou o 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 OpenSUSE 15

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

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, suas dependências antigas podem afetar a versão mais recente da CLI do Azure. 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

Instalar no SLES 12 ou em outros sistemas sem Python 3.6

No SLES 12, o pacote padrão python3 é 3.4 e não é suportado pela CLI do Azure. 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, você pode baixar o pacote da CLI do Azure e instalá-lo sem dependência.

Você pode usar o seguinte comando para instalar ou atualizar a CLI do Azure com base nas etapas acima. O script instala o Python 3.8 em /usr/local/azcli e faz com que a CLI do Azure o use definindo um alias de az como PATH=/usr/local/azcli/bin:$PATH az. Você também pode baixar o script e modificá-lo 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

Pela primeira vez instalar, 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 você estiver atrás de um proxy, essas variáveis de shell devem ser definidas para se conectar 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 não consegue instalar ou executar no Subsistema Windows para Linux

Como o Subsistema do Windows para Linux (WSL) é uma camada de conversão de chamada do sistema sobre a plataforma Windows, você pode enfrentar um erro ao tentar instalar ou executar a CLI do Azure. 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 de instalação do WSL e possivelmente resolver problemas:

• 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 no Azure, consulte Criar uma VM Linux na documentação do portal do Azure.
• Certifique-se de que você está executando a versão mais recente do WSL. Para obter a versão mais recente, atualize a instalação do Windows 10.
• Verifique se há problemas em aberto com a WSL que possam resolver 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 você continuar a ter problemas para instalar ou executar no WSL, considere instalar a 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 apt gerenciador de pacotes contém pacotes x86_64 e ARM64 para a CLI do Azure que foi testada nas distribuições a seguir.

  Distribuição	Versão
  Ubuntu	20.04 LTS (Fossa Focal), 22.04 (Jammy Jellyfish), 24.04 (Noble Numbat)
  Debian	11 (Bullseye), 12 (Bookworm)

• Ubuntu 20.04 (Focal Fossa) e 20.10 (Groovy Gorilla) incluem um azure-cli pacote com versão 2.0.81 universe fornecida pelo repositório. Este pacote está desatualizado e não é recomendado. Se este pacote estiver instalado, remova-o antes de continuar executando o comando sudo apt remove azure-cli -y && sudo apt autoremove -y. Para obter mais informações sobre apt removeo , consulte o gerenciamento de pacotes do Ubuntu ou pergunte ao ubuntu.

Instalar a CLI do Azure

Há duas opções para instalar a CLI do Azure em 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 maneira mais fácil de instalar a CLI do Azure é por meio de um script mantido pela equipe da CLI do Azure. 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, 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 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. Adicione o repositório de software da CLI do Azure:

   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 nas notas de versão da CLI do Azure.

1. Exiba as versões disponíveis da CLI do Azure.

   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 da CLI do Azure e o nome de distribuição do Linux mostrados:

   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 você receber a mensagem de erro Version x.xx.x-1~distributionName for azure-cli was not found, use lsb_release -cs para localizar a distribuição que você está executando.

Atualizar a CLI do Azure

A partir da versão 2.11.0, a CLI do Azure 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 de comando. Para versões da CLI do Azure anteriores à 2.11.0, atualize reinstalando conforme descrito em Instalar a CLI do Azure.

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 a CLI do Azure

Se optar por desinstalar a CLI do Azure, é com muita pena que o vemos ir embora. Antes de desinstalar, utilize o comando az feedback para nos indicar o que é possível melhorar ou corrigir. O nosso objetivo é tornar a CLI do Azure liver de erros e intuitiva para o utilizador. Se encontrou um erro, pedimos que registe um problema no GitHub.

1. Desinstale 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 da CLI do Azure:

   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 dados

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

rm -rf ~/.azure

Resolução de Problemas

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

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

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

Se você instalou azure-cli sem Focal adicionar o repositório de software da CLI do Azure na etapa 3 das instruções de instalação manual ou usando nosso script, poderá encontrar problemas como nenhum módulo chamado 'decorator' ou 'antlr4', pois o pacote instalado está desatualizado azure-cli 2.0.81 do focal/universe repositório. Remova-o primeiro executando sudo apt remove azure-cli -y && sudo apt autoremove -ye, em seguida, siga as instruções acima para instalar o pacote mais recenteazure-cli.

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

Algumas distribuições derivadas do Debian (como o Linux Mint) podem não retornar o nome da versão correta do 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

Às vezes, um pacote atualizado da CLI do Azure não está disponível imediatamente após o lançamento de uma versão de distribuição. A CLI do Azure foi projetada para ser resiliente a versões futuras 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) não consegue 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 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 você estiver atrás de um proxy, essas variáveis de shell devem ser definidas para se conectar 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 apt configuração no /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:

• Página do manual apt.conf
• Ubuntu wiki - apt-get howto

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 não consegue instalar ou executar no Subsistema Windows para Linux

Como o Subsistema do Windows para Linux (WSL) é uma camada de conversão de chamada do sistema sobre a plataforma Windows, você pode enfrentar um erro ao tentar instalar ou executar a CLI do Azure. 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 de instalação do WSL e possivelmente resolver problemas:

• 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 no Azure, consulte Criar uma VM Linux na documentação do portal do Azure.
• Certifique-se de que você está executando a versão mais recente do WSL. Para obter a versão mais recente, atualize a instalação do Windows 10.
• Verifique se há problemas em aberto com a WSL que possam resolver 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 você continuar a ter problemas para instalar ou executar no WSL, considere instalar a CLI para Windows.

Instalar a CLI do Azure

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

Para instalar a CLI do Azure, siga estas etapas:

1. Instale o conjunto oficial de certificados raiz confiáveis com curadoria da Microsoft:

   sudo tdnf install ca-certificates
   

2. Instale a CLI do Azure:

   sudo tdnf install azure-cli
   

Instalar versão específica

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

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 a CLI do Azure

Atualize a CLI do Azure com o tdnf update comando:

sudo tdnf update azure-cli

Desinstalar a CLI do Azure

Se optar por desinstalar a CLI do Azure, é com muita pena que o vemos ir embora. Antes de desinstalar, utilize o comando az feedback para nos indicar o que é possível melhorar ou corrigir. O nosso objetivo é tornar a CLI do Azure liver de erros e intuitiva para o utilizador. Se encontrou um erro, pedimos que registe um problema no GitHub.

Remova o pacote do seu sistema:

sudo tdnf remove azure-cli

Remover dados

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

rm -rf ~/.azure

Antes de começar

Recomendamos vivamente que instale a CLI com um gestor de pacotes. Um gestor de pacotes certifica-se de que recebe sempre as atualizações mais recentes e garante a estabilidade dos componentes da CLI. Verifique e veja se há um pacote para sua distribuição antes de instalar manualmente.

O script de instalação para a CLI do Azure requer o seguinte software:

• Python 3.8.x, 3.9.x, 3.10.x - Para obter mais informações, consulte Ciclo de vida do suporte - dependência do Python.
• libffi
• OpenSSL 1.0.2

Instalar ou atualizar a CLI do Azure

Importante

O script de instalação só funciona em Python 3.8.x, 3.9.x ou 3.10.x. Este script de instalação não funciona em Python 3.11.x ou versões posteriores.

A instalação e a atualização da CLI do Azure exigem a reexecução do script de instalação:

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

O script também pode ser transferido e executado localmente. Talvez seja necessário reiniciar o shell para que as alterações entrem em vigor.

Desinstalar a CLI do Azure

Se optar por desinstalar a CLI do Azure, é com muita pena que o vemos ir embora. Antes de desinstalar, utilize o comando az feedback para nos indicar o que é possível melhorar ou corrigir. O nosso objetivo é tornar a CLI do Azure liver de erros e intuitiva para o utilizador. Se encontrou um erro, pedimos que registe um problema no GitHub.

Desinstale a CLI ao eliminar diretamente os ficheiros da localização escolhida no momento da instalação. O local de instalação padrão é o diretório base ($HOME) do usuário.

1. Remova os ficheiros da CLI instalados.

   rm -r <install location>/lib/azure-cli
   rm <install location>/bin/az
   

2. Modifique o seu ficheiro $HOME/.bash_profile para remover a seguinte linha:

   <install location>/lib/azure-cli/az.completion
   

3. Se utilizar bash ou zsh, recarregue a cache dos comandos da shell.

   hash -r
   

Remover dados

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

rm -rf ~/.azure

Resolução de Problemas

Seguem-se alguns problemas comuns encontrados durante uma instalação manual. Se você tiver um problema não abordado aqui, registre um problema no GitHub.

Instalar sem Python 3

A CLI do Azure descartou o suporte para Python 2.7 desde a versão 2.1.0. No seu sistema, pode haver uma versão do Python anterior ao requisito do Python 3.6.x. Encontre um pacote de substituição python3 .

Erro "Objeto Movido" de curl

Se obtiver um erro de curl relacionado com o parâmetro -L ou uma mensagem de erro com o texto "Objeto Movido", experimente utilizar o URL completo em vez do redirecionamento aka.ms:

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

Comando az não encontrado

Se não for possível executar o comando após a instalação usando bash ou zsh, tente limpar o cache de hash de comando do shell e verifique se o problema foi resolvido.

hash -r

O problema também pode ocorrer se não tiver reiniciado a sua shell após a instalação. Certifique-se de que a localização do comando az está em $PATH. A localização do az comando é ...

 <install path>/bin

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 você estiver atrás de um proxy, essas variáveis de shell devem ser definidas para se conectar 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.

Para obter os scripts de instalação, seu proxy precisa permitir conexões HTTPS para 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 sua distribuição (se houver) para pacotes principais

A CLI não consegue instalar ou executar no Subsistema Windows para Linux

Como o Subsistema do Windows para Linux (WSL) é uma camada de conversão de chamada do sistema sobre a plataforma Windows, você pode enfrentar um erro ao tentar instalar ou executar a CLI do Azure. 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 de instalação do WSL e possivelmente resolver problemas:

• 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 no Azure, consulte Criar uma VM Linux na documentação do portal do Azure.
• Certifique-se de que você está executando a versão mais recente do WSL. Para obter a versão mais recente, atualize a instalação do Windows 10.
• Verifique se há problemas em aberto com a WSL que possam resolver 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 você continuar a ter problemas para instalar ou executar no WSL, considere instalar a CLI para Windows.

Passos Seguintes

Agora que instalou a CLI do Azure, dê uma vista de olhos em todas as suas funcionalidades e comandos comuns.

Introdução à CLI do Azure