Instalar a CLI do Azure no Linux

A CLI do Azure é uma ferramenta de linha de comandos de várias plataformas que pode ser instalada localmente em computadores Linux. Pode utilizar a CLI do Azure no Linux para ligar ao Azure e executar comandos administrativos em recursos do Azure. A CLI no Linux permite a execução de vários comandos através de um terminal com linhas de comandos interativas ou um script. Quando estiver pronto para instalar a CLI do Azure no Linux, recomenda-se que utilize o gestor de pacotes de distribuição do Linux. Selecione o gestor de pacotes adequado para a sua distribuição nas opções acima. Se não tiver um dos gestores de pacotes listados, pode instalar manualmente a CLI do Azure no Linux ao selecionar a opção Instalar script .

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

Descrição Geral

Para distribuições do Linux com dnf , como RHEL 8/9 ou CentOS Stream 8/9, existem pacotes RPM para a CLI do Azure.

Aviso

A partir da CLI 2.39.0 do Azure (lançada a 02/08/2022), não serão lançados pacotes RPM para RHEL 7 e CentOS 7. Pode continuar a utilizar versões históricas da CLI do Azure nestes sistemas, mas não haverá atualizações ou correções de erros. Considere atualizar para versões mais recentes do RHEL ou centOS para utilizar a CLI do Azure mais recente.

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

Importante

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

Tenha em atenção que o Python 2 atingiu o fim de vida (EOL) a 1 de janeiro de 2020 e deixará de receber atualizações. A CLI do Azure deixou cair o suporte para o Python 2.7 desde a versão 2.1.0. As novas versões já não são garantidas para serem executadas com o Python 2.7 corretamente.

Nota

Utilize yum o gestor de pacotes se estiver a utilizar sistemas Linux que não suportam dnf o gestor de pacotes.

Instalar

  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 9, adicione packages-microsoft-com-prod o repositório:

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

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

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

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

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

    sudo dnf install azure-cli
    

Instalar versão específica

Primeiro, tem de configurar azure-cli as informações do repositório, conforme mostrado acima. As versões disponíveis podem ser encontradas nas notas de versão da CLI do Azure.

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

Resolução de problemas

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

Instalar no RHEL 7.6 ou noutros sistemas sem Python 3

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

Pode utilizar o seguinte comando para instalar a CLI do Azure com python 3.6 a origem incorporada:

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

Também pode fazê-lo passo a passo:

Em primeiro lugar, a CLI do Azure requer SSL 1.1+ e tem de criar openssl 1.1 a partir da origem antes de criar python3:

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

Em seguida, crie o Python 3 a partir da origem:

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

Por fim, siga o passo 1 e 2 da instrução de instalação para adicionar o repositório da CLI do Azure. Agora pode transferir o pacote e instalá-lo sem dependência.

Nota

Caso não tenha o plug-in de transferência dnf instalado, encontrará um erro de comando não encontrado na execução do código abaixo. Utilize dnf install 'dnf-command(download)' para instalar o plug-in de transferência do dnf.

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

Como alternativa, também pode instalar o Python 3 através de algum repositório adicional. Desta forma, se tiver configurado python3 , mas ainda estiver a receber um erro python3: command not found ao tentar executar a cli, terá de adicioná-la ao seu caminho.

scl enable rh-python36 bash

O proxy bloqueia a ligação

Se não conseguir ligar a um recurso externo devido a um proxy, certifique-se de que definiu corretamente as HTTP_PROXY variáveis e HTTPS_PROXY na shell. Terá de contactar o administrador de sistema para saber que anfitriões e portas utilizar para estes proxies.

Estes valores são respeitados por muitos programas Linux, incluindo os que são utilizados no 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 estiver atrás de um proxy, estas variáveis de shell têm de ser definidas para ligar aos serviços do Azure com a CLI. Se não estiver a utilizar autenticação básica, é recomendado exportar estas variáveis no seu .bashrc ficheiro. Siga sempre as políticas de segurança da sua empresa e os requisitos do administrador de sistema.

Também pode querer configurar dnf explicitamente para utilizar este proxy em todos os momentos. Certifique-se de que as seguintes linhas são apresentadas na [main] secção de /etc/dnf/dnf.conf:

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

Para obter a chave de assinatura da Microsoft e obter o pacote do nosso repositório, o proxy tem de permitir ligações HTTPS ao seguinte endereço:

  • https://packages.microsoft.com

Falha na instalação ou execução da CLI no Subsistema Windows para Linux

Uma vez que Subsistema Windows para Linux (WSL) é uma camada de tradução de chamadas de sistema na parte superior da plataforma windows, poderá ocorrer um erro ao tentar instalar ou executar a CLI do Azure. A CLI baseia-se em algumas funcionalidades que podem ter um erro no WSL. Se ocorrer um erro independentemente da forma como instala a CLI, existe uma boa probabilidade de ser um problema com o WSL e não com o processo de instalação da CLI.

Para resolver problemas de instalação do WSL e, possivelmente, resolver problemas:

  • Se puder, execute um processo de instalação idêntico numa máquina ou VM do Linux para ver se é bem-sucedido. Se o fizer, o problema está quase certamente relacionado com o WSL. Para iniciar uma VM do Linux no Azure, veja a documentação criar uma VM do Linux no Portal do Azure .
  • Certifique-se de que está a executar a versão mais recente do WSL. Para obter a versão mais recente, atualize a instalação do Windows 10.
  • Verifique se existem problemas abertos com o WSL que possam resolver o problema. Muitas vezes, haverá sugestões sobre como contornar o problema ou informações sobre uma versão em que o problema será corrigido.
  • Se não existirem problemas existentes para o seu problema, crie um novo problema com o WSL e certifique-se de que inclui o máximo de informações possível.

Se continuar a ter problemas ao instalar ou executar no WSL, considere instalar a CLI para Windows.

Atualizar

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

az upgrade

Nota

O az upgrade comando foi adicionado na versão 2.11.0 e não funcionará com versões anteriores à versão 2.11.0. As versões mais antigas podem ser atualizadas ao reinstalar, conforme descrito em Instalar a CLI do Azure.

Este comando também atualizará todas as extensões instaladas por predefinição. Para obter mais az upgrade opções, consulte a página de referência de comandos.

Também pode atualizar a CLI do Azure com o dnf update comando .

sudo dnf update azure-cli

Desinstalar

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 não utilizar outros pacotes da Microsoft, remova a chave de assinatura.

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

Aviso

O último pacote da CLI do Azure desenvolvido pela Microsoft para SUSE Linux Enterprise Server (SLES) e OpenSUSE (Leap) é a versão 2.39.0 (lançada a 02/08/2022). Pode continuar a utilizar versões históricas da CLI do Azure nestes sistemas, mas não haverá mais atualizações ou correções de erros da Microsoft para essas versões.

A CLI do Azure e o script de Instalação do Linux continuarão a ser desenvolvidos e suportados pela Microsoft. Os pacotes fornecidos pelos repositórios SUSE/OpenSUSE são mantidos e suportados pelo SUSE.

Descrição Geral

No Azure, as máquinas virtuais (VMs) SUSE e OpenSUSE com base em Azure Marketplace imagens já têm a Interface de Command-Line do Azure (CLI do Azure) instalada.

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

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

  2. Utilize o método de instalação descrito no separador "Instalar script (qualquer)".

Instalar a CLI do Azure

Instalar a partir de repositórios SUSE ou OpenSUSE

Importante

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

Tenha em atenção que o Python 2 atingiu o fim de vida (EOL) a 1 de janeiro de 2020 e deixará de receber atualizações. A CLI do Azure deixou cair o suporte para o Python 2.7 desde a versão 2.1.0. As novas versões já não são garantidas para serem executadas corretamente com o Python 2.7.

sudo zypper install -y azure-cli

Instalar com o script de instalação

Pode instalar manualmente a CLI do Azure em qualquer versão do Linux com a opção Instalar script .

Se estiver a atualizar para a versão mais recente com este método, certifique-se de que desinstala primeiro a versão anterior, bem como quaisquer repositórios que 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 com os repositórios da Microsoft, siga estes passos.

(Este pacote foi testado com o SLES 15 e o 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 das respetivas dependências.

Instalar uma versão específica

Primeiro, tem de configurar azure-cli as informações do repositório, conforme mostrado acima. As versões disponíveis podem ser encontradas nas notas de versão da CLI do Azure.

  1. Veja as versões disponíveis com 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
    

Resolução de problemas

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

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 juntamente com as respetivas dependências antes de seguir a instrução Instalar para adicionar a CLI do Azure mais recente:

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

Se tiver atualizado a CLI do Azure sem remover as dependências da versão 2.0.45, as dependências antigas poderão afetar a versão mais recente da CLI do Azure. Tem de adicionar novamente a versão antiga para ligar às respetivas dependências e, em seguida, remover azure-cli juntamente com as respetivas 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 noutros sistemas sem o Python 3.6

No SLES 12, o pacote predefinido python3 é 3.4 e não é suportado pela CLI do Azure. Primeiro, pode seguir o passo 1 a 3 da instrução de instalação para adicionar o azure-cli repositório. Em seguida, crie uma versão python3 superior a partir da origem. Por fim, pode transferir o pacote da CLI do Azure e instalá-lo sem dependência.

Pode utilizar o seguinte comando para instalar ou atualizar a CLI do Azure com base nos passos acima. O script irá instalar o Python 3.8 em /usr/local/azcli e fazer com que a CLI do Azure o utilize ao definir um alias de az como PATH=/usr/local/azcli/bin:$PATH az. Também pode transferir o script e modificá-lo de acordo com as suas necessidades. Por exemplo, pode alterar a versão do Python ou instalar a localização.

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

Pela primeira vez, instale, lembre-se de executar o seguinte comando para ativar o alias:

source ~/.bashrc

O proxy bloqueia a ligação

Se não conseguir ligar a um recurso externo devido a um proxy, confirme que definiu corretamente as HTTP_PROXY variáveis e HTTPS_PROXY na shell. Terá de contactar o administrador de sistema para saber que anfitriões e portas devem ser utilizados para estes proxies.

Estes valores são respeitados por muitos programas Linux, incluindo os que são utilizados no 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 estiver atrás de um proxy, estas variáveis de shell têm de ser definidas para ligar aos serviços do Azure com a CLI. Se não estiver a utilizar autenticação básica, é recomendado exportar estas variáveis no seu .bashrc ficheiro. Siga sempre as políticas de segurança da sua empresa e os requisitos do administrador de sistema.

Também pode querer configurar zypper explicitamente (via yast2) para utilizar sempre este proxy. Para tal, execute o yast2 proxy comando como superutilizador e preencha as informações apresentadas no formulário. Se tiver um gestor de janelas disponível no seu sistema, também pode utilizar o Network Services > Proxy painel no YaST Control Center.

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

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

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

Falha na instalação ou execução da CLI no Subsistema Windows para Linux

Uma vez que Subsistema Windows para Linux (WSL) é uma camada de tradução de chamadas do sistema sobre a plataforma Windows, poderá deparar-se com um erro ao tentar instalar ou executar a CLI do Azure. A CLI baseia-se em algumas funcionalidades que podem ter um erro no WSL. Se ocorrer um erro independentemente da forma como instalar a CLI, é provável que seja um problema com o WSL e não com o processo de instalação da CLI.

Para resolver problemas de instalação do WSL e, possivelmente, resolver problemas:

  • Se puder, execute um processo de instalação idêntico num computador Linux ou VM para ver se é bem-sucedido. Se for o caso, o problema está quase certamente relacionado com o WSL. Para iniciar uma VM do Linux no Azure, veja a documentação criar uma VM do Linux no Portal do Azure .
  • Certifique-se de que está a executar a versão mais recente do WSL. Para obter a versão mais recente, atualize a instalação do Windows 10.
  • Verifique se existem problemas abertos com o WSL que possam resolver o problema. Muitas vezes, haverá sugestões sobre como contornar o problema ou informações sobre uma versão em que o problema será corrigido.
  • Se não existirem problemas no seu problema, submeta um novo problema no WSL e certifique-se de que inclui o máximo de informações possível.

Se continuar a ter problemas ao instalar ou executar no WSL, considere instalar a CLI para Windows.

Problema com o certificado SSL

Quando um certificado é quebrado ou desatualizado num computador, poderá receber um erro a indicar que o curl não conseguiu verificar a legitimidade do servidor e, por conseguinte, não conseguiu estabelecer uma ligação segura. Atualize o certificado para corrigir o problema.

sudo zypper update-ca-certificates

Atualizar

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

az upgrade

Nota

O az upgrade comando foi adicionado na versão 2.11.0 e não funcionará com versões anteriores à versão 2.11.0. As versões mais antigas podem ser atualizadas ao reinstalar, conforme descrito em Instalar a CLI do Azure.

Este comando também atualizará todas as extensões instaladas por predefinição. Para obter mais az upgrade opções, consulte a página de referência de comandos.

Também pode atualizar o pacote com o zypper update comando .

sudo zypper refresh
sudo zypper update azure-cli

Desinstalar

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 não utilizar outros pacotes 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
    

Descrição Geral

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

Distribuição Versão
Ubuntu 18.04 LTS (Castor Biónico), 20.04 LTS (Focal Fossa), 22.04 (Medusa-de-Jammy)
Debian 10 (Buster), 11 (Bullseye)

Aviso

Pode continuar a utilizar versões históricas da CLI do Azure em sistemas antigos, mas não haverá atualizações ou correções de erros. Considere atualizar para versões mais recentes do Ubuntu ou Debian para utilizar a CLI do Azure mais recente.

Aviso

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

O azure-cli pacote de base de dados não suporta a arquitetura ARM64.

Opções de Instalação

Existem duas opções para instalar a CLI do Azure no seu sistema. Primeiro, pode executar um único comando que irá transferir um script de instalação e executar os comandos de instalação por si. Em alternativa, se preferir, pode executar os comandos de instalação manualmente num processo passo a passo. Ambos os métodos são fornecidos abaixo.

Opção 1: Instalar com um comando

A equipa da CLI do Azure mantém um script para executar todos os comandos de instalação num único passo. Este script é transferido através curl de e direcionado diretamente para bash para instalar a CLI.

Se quiser inspecionar o conteúdo do script manualmente antes de executar, transfira o script primeiro e curl inspecione-o no seu editor de texto favorito.

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

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

Se preferir um processo de instalação passo a passo, conclua os seguintes passos para instalar a CLI do Azure.

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

    sudo apt-get update
    sudo apt-get install ca-certificates curl apt-transport-https lsb-release gnupg
    
  2. 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_REPO=$(lsb_release -cs)
    echo "deb [arch=`dpkg --print-architecture` signed-by=/etc/apt/keyrings/microsoft.gpg] https://packages.microsoft.com/repos/azure-cli/ $AZ_REPO main" |
        sudo tee /etc/apt/sources.list.d/azure-cli.list
    
  4. Atualize as informações do repositório e instale o azure-cli pacote:

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

Instalar uma versão específica

Primeiro, tem de configurar azure-cli as informações do repositório, conforme mostrado acima. As versões disponíveis podem ser encontradas nas notas de versão da CLI do Azure.

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

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

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

Resolução de problemas

Seguem-se alguns problemas comuns vistos durante a instalação com apt. Se detetar um problema que não é mencionado neste artigo, registe um problema no github.

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

Se instalou azure-cli o Focal sem adicionar o repositório de software da CLI do Azure no passo 3 das instruções de instalação manual ou com o nosso script, poderá encontrar problemas como nenhum módulo com o nome "decorador" ou "antlr4", uma vez que o pacote que instalou está desatualizado azure-cli 2.0.81 a focal/universe partir do repositório. Remova-o primeiro ao executar sudo apt remove azure-cli -y && sudo apt autoremove -ye, em seguida, siga as instruções acima para instalar o pacote mais recente azure-cli .

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

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

Nenhum pacote para a sua distribuição

Por vezes, pode demorar algum tempo depois de uma distribuição ser lançada antes de existir um pacote da CLI do Azure disponível para o mesmo. A CLI do Azure concebida para ser resiliente no que diz respeito a futuras versões de dependências e depende do menor número possível de dependências. Se não existir nenhum pacote disponível para a distribuição base, experimente um pacote para uma distribuição anterior.

Para tal, defina o valor de AZ_REPO manualmente ao adicionar o repositório. Para distribuições do Ubuntu, utilize o repositório mais recente jammy :

AZ_REPO="jammy"

Para distribuições Debian, utilize o repositório mais recente bullseye :

AZ_REPO="bullseye"

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

O SO elementar (EOS) não consegue instalar a CLI do Azure

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

Conteúdo original do ficheiro:

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

Conteúdo de ficheiro modificado

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

O proxy bloqueia a ligação

Se não conseguir ligar a um recurso externo devido a um proxy, confirme que definiu corretamente as HTTP_PROXY variáveis e HTTPS_PROXY na shell. Terá de contactar o administrador de sistema para saber que anfitriões e portas devem ser utilizados para estes proxies.

Estes valores são respeitados por muitos programas Linux, incluindo os que são utilizados no 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 estiver atrás de um proxy, estas variáveis de shell têm de ser definidas para ligar aos serviços do Azure com a CLI. Se não estiver a utilizar autenticação básica, é recomendado exportar estas variáveis no seu .bashrc ficheiro. Siga sempre as políticas de segurança da sua empresa e os requisitos do administrador de sistema.

Também pode querer configurar apt explicitamente para utilizar este proxy em todos os momentos. Certifique-se de que as seguintes linhas aparecem num apt ficheiro de configuração no /etc/apt/apt.conf.d/. Recomendamos que utilize o ficheiro de configuração global existente, um ficheiro de configuração de proxy existente, 40proxiesou 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 utilizar autenticação básica, remova a [username]:[password]@ parte do URI do proxy. Se precisar de mais informações para a configuração do proxy, veja a documentação oficial do Ubuntu:

Para obter a chave de assinatura da Microsoft e obter o pacote do nosso repositório, o proxy tem de permitir ligações HTTPS ao seguinte endereço:

  • https://packages.microsoft.com

Falha na instalação ou execução da CLI no Subsistema Windows para Linux

Uma vez que Subsistema Windows para Linux (WSL) é uma camada de tradução de chamadas do sistema sobre a plataforma Windows, poderá deparar-se com um erro ao tentar instalar ou executar a CLI do Azure. A CLI baseia-se em algumas funcionalidades que podem ter um erro no WSL. Se ocorrer um erro independentemente da forma como instalar a CLI, é provável que seja um problema com o WSL e não com o processo de instalação da CLI.

Para resolver problemas de instalação do WSL e, possivelmente, resolver problemas:

  • Se puder, execute um processo de instalação idêntico num computador Linux ou VM para ver se é bem-sucedido. Se for o caso, o problema está quase certamente relacionado com o WSL. Para iniciar uma VM do Linux no Azure, veja a documentação criar uma VM do Linux no Portal do Azure .
  • Certifique-se de que está a executar a versão mais recente do WSL. Para obter a versão mais recente, atualize a instalação do Windows 10.
  • Verifique se existem problemas abertos com o WSL que possam resolver o problema. Muitas vezes, haverá sugestões sobre como contornar o problema ou informações sobre uma versão em que o problema será corrigido.
  • Se não existirem problemas no seu problema, submeta um novo problema no WSL e certifique-se de que inclui o máximo de informações possível.

Se continuar a ter problemas ao instalar ou executar no WSL, considere instalar a CLI para Windows.

Atualizar

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

az upgrade

Nota

O az upgrade comando foi adicionado na versão 2.11.0 e não funcionará com versões anteriores à versão 2.11.0. As versões mais antigas podem ser atualizadas ao reinstalar, conforme descrito em Instalar a CLI do Azure.

Este comando também atualizará todas as extensões instaladas por predefinição. Para obter mais az upgrade opções, consulte a página de referência de comandos.

Também pode utilizar apt-get upgrade para atualizar o pacote da CLI.

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

Nota

Este comando atualiza todos os pacotes instalados no seus sistema que não tenham tido uma alteração de dependência. Para atualizar apenas a CLI, utilize apt-get install.

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

Desinstalar

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. Desinstalar com apt-get remove:

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

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

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

    sudo apt autoremove
    

Descrição Geral

Os RPMs são lançados para CBL-Mariner 2.0.

Instalar

Instale com o tdnf install comando:

sudo tdnf install azure-cli

Instalar uma versão específica

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

Para ver 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

Atualize a CLI do Azure com o tdnf update comando :

sudo tdnf update azure-cli

Desinstalar

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

Descrição Geral

Nota

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 existe um pacote para a sua distribuição antes de instalar manualmente.

A CLI precisa do seguinte software:

Importante

A CLI deixou cair o suporte para o Python 2.7 desde a versão 2.1.0. As novas versões já não garantem a execução correta com o Python 2.7.

Instalar ou atualizar

Tanto para instalar como para atualizar a CLI é preciso voltar a executar o script de instalação. Instale a CLI ao executar curl.

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

O script também pode ser transferido e executado localmente. Poderá ter de reiniciar a shell para que as alterações entrem em vigor.

Resolução de problemas

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

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 conseguir executar o comando após a instalação e utilizar bash e zsh, limpe a cache de hash do comando da sua shell. Executar

hash -r

e veja se o problema já está resolvido.

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 comando az é

<install path>/bin

O proxy bloqueia a ligação

Se não conseguir ligar a um recurso externo devido a um proxy, confirme que definiu corretamente as HTTP_PROXY variáveis e HTTPS_PROXY na shell. Terá de contactar o administrador de sistema para saber que anfitriões e portas devem ser utilizados para estes proxies.

Estes valores são respeitados por muitos programas Linux, incluindo os que são utilizados no 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 estiver atrás de um proxy, estas variáveis de shell têm de ser definidas para ligar aos serviços do Azure com a CLI. Se não estiver a utilizar autenticação básica, é recomendado exportar estas variáveis no seu .bashrc ficheiro. Siga sempre as políticas de segurança da sua empresa e os requisitos do administrador de sistema.

Para obter os scripts de instalação, o proxy tem de permitir ligações HTTPS aos seguintes endereços:

  • https://aka.ms/
  • https://azurecliprod.blob.core.windows.net/
  • https://pypi.python.org
  • Pontos finais utilizados pelo gestor de pacotes da distribuição (se existirem) para pacotes principais

Falha na instalação ou execução da CLI no Subsistema Windows para Linux

Uma vez que Subsistema Windows para Linux (WSL) é uma camada de tradução de chamadas do sistema sobre a plataforma Windows, poderá deparar-se com um erro ao tentar instalar ou executar a CLI do Azure. A CLI baseia-se em algumas funcionalidades que podem ter um erro no WSL. Se ocorrer um erro independentemente da forma como instalar a CLI, é provável que seja um problema com o WSL e não com o processo de instalação da CLI.

Para resolver problemas de instalação do WSL e, possivelmente, resolver problemas:

  • Se puder, execute um processo de instalação idêntico num computador Linux ou VM para ver se é bem-sucedido. Se for o caso, o problema está quase certamente relacionado com o WSL. Para iniciar uma VM do Linux no Azure, veja a documentação criar uma VM do Linux no Portal do Azure .
  • Certifique-se de que está a executar a versão mais recente do WSL. Para obter a versão mais recente, atualize a instalação do Windows 10.
  • Verifique se existem problemas abertos com o WSL que possam resolver o problema. Muitas vezes, haverá sugestões sobre como contornar o problema ou informações sobre uma versão em que o problema será corrigido.
  • Se não existirem problemas no seu problema, submeta um novo problema no WSL e certifique-se de que inclui o máximo de informações possível.

Se continuar a ter problemas ao instalar ou executar no WSL, considere instalar a CLI para Windows.

Desinstalar

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. A localização de instalação predefinida é $HOME.

  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 não planear reinstalar a CLI do Azure, remova os respetivos dados.

rm -rf ~/.azure

Passos Seguintes

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