Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
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
yumgerenciador de pacotes se estiver usando um sistema Linux que não suporte odnfgerenciador de pacotes.
Install Azure CLI
Para instalar o Azure CLI, siga estes passos:
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.ascPara versões inferiores, use o seguinte comando:
sudo rpm --import https://packages.microsoft.com/keys/microsoft.ascPara RHEL 10, adicione
packages-microsoft-com-prodrepositório:sudo dnf install -y https://packages.microsoft.com/config/rhel/10/packages-microsoft-prod.rpmPara 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.rpmPara RHEL 9 ou CentOS Stream 9, adicione
packages-microsoft-com-prodrepositório:sudo dnf install -y https://packages.microsoft.com/config/rhel/9.0/packages-microsoft-prod.rpmPara RHEL 8, adicione
packages-microsoft-com-prodrepositório:sudo dnf install -y https://packages.microsoft.com/config/rhel/8/packages-microsoft-prod.rpmPara RHEL 7, adicione
azure-clirepositó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.repoAtençã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
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.
Para visualizar as versões disponíveis com o comando:
dnf list --showduplicates azure-cliPara 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.
Remova o pacote do seu sistema.
sudo dnf remove azure-cliSe não tenciona reinstalar a CLI, remova as informações sobre o repositório.
sudo rm /etc/yum.repos.d/azure-cli.repoSe 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:
Use o pacote Enterprise fornecido pela SUSE nos repositórios SUSE/OpenSUSE.
Use o método de instalação descrito na aba "Instalar script (qualquer)".
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)
Instalar
curl:sudo zypper install -y curlImporte a chave de repositório da Microsoft:
sudo rpm --import https://packages.microsoft.com/keys/microsoft.ascCrie informações sobre o repositório
azure-clilocal:sudo zypper addrepo --name 'Azure CLI' --check https://packages.microsoft.com/yumrepos/azure-cli azure-cliAtualize o índice do pacote
zyppere instale:sudo zypper install --from azure-cli azure-cliDigite 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.
Veja as versões disponíveis usando este comando:
zypper search --details --match-exact azure-cliPara 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.
Remova o pacote do seu sistema.
sudo zypper remove -y azure-cliSe não tenciona reinstalar a CLI, remova as informações sobre o repositório.
sudo zypper removerepo azure-cliSe 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.comhttps://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
aptconté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.
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-releaseTransfira 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-
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 Atualize as informações do repositório e instale o
azure-clipacote: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.
Consulte as versões disponíveis do Azure CLI.
apt-cache policy azure-cliInstale 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.
Desinstale com
apt-get remove:sudo apt-get remove -y azure-cliSe 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.sourcesSe você não estiver usando outros pacotes da Microsoft, remova a chave de assinatura:
sudo rm /etc/apt/keyrings/microsoft.gpgRemova 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:
Instale o conjunto oficial de certificados raiz confiáveis selecionados pela Microsoft.
sudo tdnf install ca-certificatesInstall 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.