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 através de linhas de comandos interativas ou de um script. Quando estiver pronto para instalar a CLI do Azure no Linux, recomenda-se que utilize o gestor de pacotes de uma 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, poderá instalar manualmente a CLI do Azure no Linux ao selecionar a opção Instalar script .

A versão atual da CLI do Azure é 2.49.0. 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 CLI 2.39.0 do Azure (lançada a 02/08/2022) é a última versão suportada no RHEL 7 e Centos 7 e continuará a receber correções de segurança até ao fim do ciclo de vida dos sistemas operativos. A Microsoft não fornecerá outras atualizações ou correções de erros nesta versão.

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 Red Hat e CentOS são mantidos e suportados pelas respetivas distribuições.

A versão atual da CLI do Azure é 2.49.0. 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 versões mais recentes podem não ser executadas corretamente com o Python 2.7.

Nota

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

Nota

O azure-cli pacote suporta a arquitetura arm64 a partir de 2.46.0.

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 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:

   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 conseguir, atualize o 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 transferir e instalar o script de instalação da CLI do Azure com python 3.6 criado a partir da origem:

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 terá 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 os passos 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

Se o plug-in de transferência do dnf ainda não estiver instalado, ocorrerá um command not found erro ao executar o 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 com um repositório adicional. Utilize este método, se tiver configurado python3 , mas ainda estiver a receber 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 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 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.38.0 (lançada a 05/07/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 versões mais recentes podem não ser 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 pacotes x86_64 e ARM64 para a CLI do Azure que foram testados nas seguintes distribuições. Não existe nenhum pacote ARM64 para o Ubuntu 18.04.

Distribuição	Versão
Ubuntu	18.04 LTS (Castores Biónicos), 20.04 LTS (Fossa Focal), 22.04 (Medusas 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 mais recente do Azure.

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 .

Nota

O azure-cli pacote suporta a arquitetura arm64 a partir de 2.46.0.

Opções de Instalação

Existem duas opções para instalar a CLI do Azure no seu sistema. Pode transferir um script de instalação que irá executar os comandos de instalação automaticamente ou pode executar os comandos de instalação por si próprio num processo passo a passo, se preferir. 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 a instalação da CLI.

Se quiser inspecionar o conteúdo do script 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

Configure as informações do azure-cli 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 sem Focal 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 chamado "decorador" ou "antlr4", uma vez que o pacote que instalou é desatualizado azure-cli 2.0.81 do focal/universe 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 do Ubuntu ou outras distribuições derivadas de Debian (como a Casa da Moeda do Linux) podem não devolver o nome de versão correto 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 da qual a sua distribuição é derivada, pode definir o AZ_REPO valor manualmente ao adicionar o repositório. Caso contrário, procure informações sobre 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, um pacote da CLI do Azure atualizado não está imediatamente disponível após uma versão de distribuição. A CLI do Azure foi 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 de Debian, utilize o repositório mais recente bullseye :

AZ_REPO="bullseye"

Importante

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, 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 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:

• apt.conf manpage
• Ubuntu wiki - apt-get howto

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 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 estiver a 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 o Linux do Azure.

Nota

O azure-cli pacote suporta a arquitetura ARM64 do 2.46.0.

Instalar

1. Instale o conjunto oficial organizado pela Microsoft de certificados de raiz fidedigna:

   sudo tdnf install ca-certificates
   

2. Instalar a CLI do Azure:

   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:

• Python 3.6.x, 3.7.x ou 3.8.x.
• libffi
• OpenSSL 1.0.2

Importante

A CLI do Azure deixou cair o suporte para o Python 2.7 desde a versão 2.1.0. As versões mais recentes podem não ser executadas corretamente com o Python 2.7.

Instalar ou atualizar

Tanto a instalação como a atualização da CLI do Azure requerem a nova execução do script de instalação.

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 com bash ou zsh, experimente limpar a cache hash de comandos da shell e verifique se o problema está 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 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 é o diretório raiz do utilizador ($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.

Introdução à CLI do Azure