Instalación de la Azure CLI en Linux

En este artículo se explica cómo instalar el Azure CLI en Linux. Seleccione el administrador de paquetes adecuado para su distribución entre las opciones de la parte superior de la página. Se recomienda usar el administrador de paquetes de una distribución de Linux.

La versión actual del Azure CLI es 2.84.0. Para obtener información sobre la última versión, consulte las notas de la versión. Para averiguar tu versión instalada y ver si necesitas actualizar, ejecuta az version.

Antes de empezar

• Azure CLI 2.38.2 (publicado el 21 de junio de 2024) es la última versión compatible con RHEL 7 y Centos 7. Microsoft ya no proporciona actualizaciones ni correcciones de errores para estas distribuciones.

• Utilice el administrador de paquetes yum si está utilizando un sistema Linux que no sea compatible con el administrador de paquetes dnf.

Instalación de Azure CLI

Para instalar el Azure CLI, siga estos pasos:

1. Importe la clave del repositorio de Microsoft. Para RHEL 10 y CentOS Stream 10,

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

   Para versiones anteriores, use el siguiente comando:

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

2. Para RHEL 10, agregue packages-microsoft-com-prod el repositorio:

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

   Para CentOS Stream 10, agregue el repositorio packages-microsoft-com-prod.

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

   Para RHEL 9 o CentOS Stream 9, agregue packages-microsoft-com-prod el repositorio:

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

   Para RHEL 8, agregue el repositorio packages-microsoft-com-prod.

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

   Para RHEL 7, agregue azure-cli el repositorio:

   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
   

   Precaución

   CentOS 7 End Of Life (EOL) fue el 30 de junio de 2024. Para obtener información sobre los entornos admitidos por Azure CLI, consulte ciclo de vida de soporte de Azure CLI

3. Realice la instalación con el comando dnf install.

   sudo dnf install azure-cli
   

Instalación de una versión concreta

Primero debe configurar la información del repositorio azure-cli como se mostró anteriormente. Las versiones disponibles se pueden encontrar en notas de la versión de Azure CLI.

1. Para ver las versiones disponibles con el comando:

   dnf list --showduplicates azure-cli
   

2. Para instalar una versión específica:

   sudo dnf install azure-cli-<version>-1.el7
   

Actualizar Azure CLI

A partir de la versión 2.11.0, el Azure CLI proporciona un comando en la herramienta para actualizar a la versión más reciente.

az upgrade

Este comando también actualiza todas las extensiones instaladas de forma predeterminada. Para más az upgrade opciones, consulte la página de referencia del comando. Para las versiones de Azure CLI anteriores a 2.11.0, actualice reinstalando como se describe en Instalar el Azure CLI.

También puede actualizar el Azure CLI con el comando dnf update.

sudo dnf update azure-cli

Desinstalar Azure CLI

Si decide desinstalar el CLI de Azure, lamentamos verle partir. Antes de desinstalar, use el comando az feedback para contarnos lo que se podría mejorar o corregir. Nuestro objetivo es que Azure CLI esté libre de errores y sea fácil de usar. Si encontró un error, le agradeceríamos si file un problema de GitHub.

1. Elimine el paquete de su equipo.

   sudo dnf remove azure-cli
   

2. Si no tiene previsto volver a instalar la CLI, elimine la información del repositorio.

   sudo rm /etc/yum.repos.d/azure-cli.repo
   

3. Si no usa otros paquetes de Microsoft, quite la clave de firma.

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

Eliminar datos

Si no tiene previsto volver a instalar Azure CLI, quite sus datos.

rm -rf ~/.azure

Solución de problemas

Estos son algunos problemas comunes que se han observado cuando se instala con dnf. Si experimenta un problema que no se trata aquí, file un problema en GitHub.

Instalación en RHEL 7.6 u otros sistemas sin Python 3

Si es posible, actualice el sistema a una versión con soporte técnico oficial para paquetes python 3.6+. De lo contrario, primero debe instalar un paquete python3 y, después, instalar Azure CLI sin dependencia.

Puede usar el siguiente comando para descargar e instalar el script de instalación de Azure CLI con python 3.6 compilado a partir del origen:

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

También puede hacerlo paso a paso:

En primer lugar, Azure CLI requiere SSL 1.1+ y debe compilar openssl 1.1 desde el origen antes de compilar 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

A continuación, compile Python 3 desde el origen:

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 último, siga los pasos 1 y 2 de la instrucción install para agregar el repositorio de Azure CLI. Ahora puede descargar el paquete e instalarlo sin dependencias.

Nota:

Si el complemento de descarga dnf aún no está instalado, se producirá un error command not found al ejecutar el código siguiente. Use dnf install 'dnf-command(download)' para instalar el complemento de descarga de dnf.

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

Como alternativa, también puede instalar Python 3 mediante another repo. Use este método, si ha configurado python3 pero sigue recibiendo el error python3: command not found. Asegúrese de que se ha incluido en su ruta.

scl enable rh-python36 bash

El servidor proxy bloquea la conexión

Si no puede conectarse a un recurso externo debido a un servidor proxy, asegúrese de que ha configurado correctamente las variables HTTP_PROXY y HTTPS_PROXY en el shell. Debe ponerse en contacto con el administrador del sistema para saber qué hosts y puertos se van a usar para estos servidores proxy.

Muchos programas de Linux usan los valores de estas variables y durante el proceso de instalación. Para establecer estos 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

Si usted está detrás de un proxy, estas variables de shell deben establecerse para conectarse a los servicios de Azure con la CLI. Si no utiliza autenticación básica, se recomienda exportar estas variables en su archivo .bashrc. Siga siempre las directivas de seguridad de su empresa y los requisitos del administrador del sistema.

Es posible que también quiera configurar explícitamente dnf para usar siempre este proxy. Asegúrese de que las líneas siguientes aparecen en la sección [main] 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 obtener la clave de firma de Microsoft y el paquete de nuestro repositorio, el servidor proxy debe permitir conexiones HTTPS a la siguiente dirección:

• https://packages.microsoft.com

La CLI no se puede instalar o ejecutar en Windows Subsystem for Linux

Dado que Windows Subsystem for Linux (WSL) es una capa de traducción de llamadas del sistema sobre la plataforma de Windows, podría experimentar un error al intentar instalar o ejecutar el Azure CLI. La CLI se basa en algunas características que podrían producir un error en WSL. Si experimenta un error, independientemente de cómo instale la CLI, es muy probable que se trate de un problema de WSL y no del proceso de instalación de la CLI.

Para solucionar los problemas de instalación de WSL y posiblemente resolver otros problemas:

• Si puede, ejecute un proceso de instalación idéntico en una máquina Linux para ver si se realiza correctamente. Si es así, su problema probablemente está relacionado con WSL. Para iniciar una máquina virtual Linux en Azure, consulte la documentación crear una máquina virtual Linux en el portal de Azure.
• Asegúrese de que usa la versión más reciente de WSL. Para obtener la versión más reciente, actualizar la instalación de Windows 10.
• Verifique los problemas abiertos con WSL que pudieran resolver sus problemas. Suele haber sugerencias sobre cómo solucionar el problema o información sobre una versión donde se corrige el problema.
• Si no hay ninguna incidencia abierta para su problema, abra una incidencia nueva con WSL y asegúrese de incluir toda la información posible.

Si sigue teniendo problemas al instalar o ejecutar en WSL, considere instalar la CLI para Windows.

Antes de empezar

• Azure CLI 2.38.2 (publicado el 21 de junio de 2024) es la versión más reciente compatible con SUSE Linux Enterprise Server (SLES) y OpenSUSE (Leap). Microsoft ya no proporciona actualizaciones ni correcciones de errores para estas distribuciones.

• SUSE mantiene y admite paquetes proporcionados por repositorios SUSE/OpenSUSE.

• En Azure, las máquinas virtuales (VM) SUSE y OpenSUSE basadas en imágenes Azure Marketplace ya tienen instalado el Azure CLI.

Instalación de Azure CLI

Para instalar Azure CLI en SUSE/OpenSUSE, elija uno de los métodos siguientes:

1. Use el paquete Enterprise proporcionado por SUSE en los repositorios de SUSE/OpenSUSE.

2. Utilice el método de instalación descrito en la pestaña "Guion de instalación (cualquiera)".

3. Instalación desde los repositorios de Microsoft

Instalación desde los repositorios de SUSE u OpenSUSE

El paquete RPM del Azure CLI depende del paquete python3.

sudo zypper install -y azure-cli

Instalación desde los repositorios de Microsoft

Para instalar la versión histórica más reciente del Azure CLI mediante repositorios de Microsoft, siga estos pasos.

(Este paquete se ha probado con SLES 15 y OpenSUSE Leap 15.1).

1. Instale curl:

   sudo zypper install -y curl
   

2. Importe la clave del repositorio de Microsoft:

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

3. Crear información del repositorio azure-cli local.

   sudo zypper addrepo --name 'Azure CLI' --check https://packages.microsoft.com/yumrepos/azure-cli azure-cli
   

4. Actualice el índice del paquete zypper e instálelo:

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

   Especifique 2 para continuar con la instalación y omitir algunas de sus dependencias.

Instalación de una versión concreta

Primero debe configurar la información del repositorio azure-cli como se mostró anteriormente. Las versiones disponibles se pueden encontrar en las notas de la versión de Azure CLI.

1. Puede ver las versiones disponibles con este comando:

   zypper search --details --match-exact azure-cli
   

2. Para instalar una versión específica:

   sudo zypper install --from azure-cli azure-cli=<version>-1.el7
   

Actualizar Azure CLI

A partir de la versión 2.11.0, el Azure CLI proporciona un comando en la herramienta para actualizar a la versión más reciente.

az upgrade

Este comando también actualiza todas las extensiones instaladas de forma predeterminada. Para más az upgrade opciones, consulte la página de referencia del comando. Para las versiones de Azure CLI anteriores a 2.11.0, actualice reinstalando como se describe en Instalar el Azure CLI.

También puede actualizar el paquete con el comando zypper update.

sudo zypper refresh
sudo zypper update azure-cli

Desinstalar Azure CLI

Si decide desinstalar el CLI de Azure, lamentamos verle partir. Antes de desinstalar, use el comando az feedback para contarnos lo que se podría mejorar o corregir. Nuestro objetivo es que Azure CLI esté libre de errores y sea fácil de usar. Si encontró un error, le agradeceríamos si file un problema de GitHub.

1. Elimine el paquete de su equipo.

   sudo zypper remove -y azure-cli
   

2. Si no tiene previsto volver a instalar la CLI, elimine la información del repositorio.

   sudo zypper removerepo azure-cli
   

3. Si no usa otros paquetes de Microsoft, quite la clave de firma de 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
   

Eliminar datos

Si no tiene previsto volver a instalar Azure CLI, quite sus datos.

rm -rf ~/.azure

Solución de problemas

Estos son algunos problemas comunes que se han observado cuando se instala con zypper. Si experimenta un problema que no se trata aquí, file un problema en GitHub.

Instalación sin Python 3

Importante

El paquete RPM del Azure CLI depende del paquete python3. En tu sistema, puede ser una versión de Python que sea anterior al requisito de Python 3.6.x. Si esto le afecta, busque un paquete python3 de reemplazo.

Tenga en cuenta que Python 2 ha alcanzado el final de la vida (EOL) el 1 de enero de 2020 y ya no recibirá actualizaciones. Azure CLI ha eliminado la compatibilidad con Python 2.7 desde la versión 2.1.0. Es posible que las versiones más recientes de la CLI no se ejecuten correctamente con Python 2.7.

Error NotImplementedError en una máquina virtual de OpenSUSE 15

La máquina virtual openSUSE 15 tiene una Azure CLI preinstalada con la versión 2.0.45, que está obsoleta y tiene problemas con az login. Quite esta versión junto con sus dependencias antes de seguir las instrucciones Install para agregar la Azure CLI más reciente:

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

Si ha actualizado el Azure CLI sin quitar las dependencias de la versión 2.0.45, sus dependencias anteriores pueden afectar a la versión más reciente del Azure CLI. Debe volver a agregar la versión anterior para vincularla con sus dependencias y, a continuación, eliminar azure-cli junto con sus dependencias:

# 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

Instalación en SLES 12 u otros sistemas sin Python 3.6

En SLES 12, el paquete de python3 predeterminado es 3.4 y no es compatible con Azure CLI. En primer lugar, puede seguir los pasos 1 a 3 de las instrucciones de instalación para agregar el repositorio azure-cli. A continuación, cree una versión superior de python3 desde el código fuente. Por último, puede descargar el paquete Azure CLI e instalarlo sin dependencia.

Puede usar el siguiente comando para instalar o actualizar Azure CLI en función de los pasos anteriores. El script instala Python 3.8 en /usr/local/azcli y hace que Azure CLI lo use estableciendo un alias de az en PATH=/usr/local/azcli/bin:$PATH az. También puede descargar el script y modificarlo según sus necesidades. Por ejemplo, puede cambiar la versión de Python o la ubicación de instalación.

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

Para la primera instalación, recuerde ejecutar el siguiente comando para activar el alias:

source ~/.bashrc

El servidor proxy bloquea la conexión

Si no puede conectarse a un recurso externo debido a un servidor proxy, asegúrese de que ha configurado correctamente las variables HTTP_PROXY y HTTPS_PROXY en el shell. Debe ponerse en contacto con el administrador del sistema para saber qué hosts y puertos se van a usar para estos servidores proxy.

Muchos programas de Linux usan los valores de estas variables y durante el proceso de instalación. Para establecer estos 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

Si usted está detrás de un proxy, estas variables de shell deben establecerse para conectarse a los servicios de Azure con la CLI. Si no utiliza autenticación básica, se recomienda exportar estas variables en su archivo .bashrc. Siga siempre las directivas de seguridad de su empresa y los requisitos del administrador del sistema.

Es posible que también quiera configurar explícitamente zypper (mediante yast2) para usar siempre este proxy. Para ello, ejecute el comando yast2 proxy como superusuario y rellene la información del formulario. Si tiene un administrador de ventanas disponible en el sistema, también puede usar el panel Network Services > Proxy en YaST Control Center.

Para ver la configuración avanzada o más información, consulte la documentación de la configuración del servidor proxy de OpenSUSE.

Para obtener la clave de firma de Microsoft y obtener el paquete desde nuestro repositorio, el proxy debe permitir las conexiones HTTPS a las siguientes direcciones:

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

La CLI no se puede instalar o ejecutar en Windows Subsystem for Linux

Dado que Windows Subsystem for Linux (WSL) es una capa de traducción de llamadas del sistema sobre la plataforma de Windows, podría experimentar un error al intentar instalar o ejecutar el Azure CLI. La CLI se basa en algunas características que podrían producir un error en WSL. Si experimenta un error, independientemente de cómo instale la CLI, es muy probable que se trate de un problema de WSL y no del proceso de instalación de la CLI.

Para solucionar los problemas de instalación de WSL y posiblemente resolver otros problemas:

• Si puede, ejecute un proceso de instalación idéntico en una máquina Linux para ver si se realiza correctamente. Si es así, su problema probablemente está relacionado con WSL. Para iniciar una máquina virtual Linux en Azure, consulte la documentación crear una máquina virtual Linux en el portal de Azure.
• Asegúrese de que usa la versión más reciente de WSL. Para obtener la versión más reciente, actualizar la instalación de Windows 10.
• Verifique los problemas abiertos con WSL que pudieran resolver sus problemas. Suele haber sugerencias sobre cómo solucionar el problema o información sobre una versión donde se corrige el problema.
• Si no hay ninguna incidencia abierta para su problema, abra una incidencia nueva con WSL y asegúrese de incluir toda la información posible.

Si sigue teniendo problemas al instalar o ejecutar en WSL, considere instalar la CLI para Windows.

Problema de certificado SSL

Cuando un certificado deja de funcionar o está obsoleto en una máquina, es posible que reciba un error que indica que curl no pudo comprobar la legitimidad del servidor y, por lo tanto, no pudo establecer una conexión segura. Actualice el certificado para corregir el problema.

sudo zypper update-ca-certificates

Antes de empezar

• El administrador de paquetes />

  Distribución	Versión
  Debian	11 (Bullseye), 12 (Gusano del libro)
  Ubuntu	22.04 (Jammy Jellyfish), 24.04 (Noble Numbat)

Instalación de Azure CLI

Hay dos opciones para instalar el Azure CLI en el sistema. Puede descargar un script de instalación que ejecute automáticamente los comandos de instalación, o puede ejecutar los comandos de instalación por su cuenta en un proceso paso a paso. Aquí se proporcionan ambos métodos:

Opción 1: Instalación con un comando

La manera más fácil de instalar el Azure CLI es a través de un script mantenido por el equipo de Azure CLI. Este script ejecuta todos los comandos de instalación en un solo paso. Este script se descarga mediante curl y se canaliza directamente a bash para instalar la CLI.

Si desea inspeccionar el contenido del script antes de ejecutarlo, descargue el script con curl e inspecciónelo en el editor de texto que prefiera.

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

Opción 2: instrucciones de instalación paso a paso

Si prefiere un proceso de instalación paso a paso, complete los pasos siguientes para instalar el Azure CLI.

1. Obtenga los paquetes necesarios para el proceso de instalación:

   sudo apt-get update
   sudo apt-get install apt-transport-https ca-certificates curl gnupg lsb-release
   

2. Descargue e instale la clave de firma de 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. Agregar el repositorio de software de Azure CLI:

   AZ_DIST=$(lsb_release -cs)
   echo "Types: deb
   URIs: https://packages.microsoft.com/repos/azure-cli/
   Suites: ${AZ_DIST}
   Components: main
   Architectures: $(dpkg --print-architecture)
   Signed-by: /etc/apt/keyrings/microsoft.gpg" | sudo tee /etc/apt/sources.list.d/azure-cli.sources
   

4. Actualice la información del repositorio e instale el paquete azure-cli:

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

Instalación de una versión concreta

Configure la información del repositorio azure-cli como se muestra anteriormente. Las versiones disponibles se pueden encontrar en notas de la versión de Azure CLI.

1. Vea las versiones disponibles del Azure CLI.

   apt-cache policy azure-cli
   

2. Instalación de una versión 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 una versión específica sin variables, reemplace la versión de Azure CLI y el nombre de distribución de Linux que se muestra:

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

Si recibe el mensaje de error No se puede encontrar el paquete azure-cli, laazure-cli información del repositorio no está configurada. Siga los pasos indicados en la opción 2: Instrucciones de instalación paso a paso.

Si recibe un mensaje de error versión x.xx.x-1~distributionName para azure-cli no se encontró, use lsb_release -cs para encontrar la distribución que está ejecutando.

Actualizar Azure CLI

A partir de la versión 2.11.0, el Azure CLI proporciona un comando en la herramienta para actualizar a la versión más reciente.

az upgrade

Este comando también actualiza todas las extensiones instaladas de forma predeterminada. Para más az upgrade opciones, consulte la página de referencia del comando. Para las versiones de Azure CLI anteriores a 2.11.0, actualice reinstalando como se describe en Instalar el Azure CLI.

También puede usar apt-get upgrade para actualizar el paquete de la CLI. Este comando actualiza todos los paquetes instalados en el sistema que no hayan tenido un cambio de dependencia.

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

Para actualizar solo la CLI, use apt-get install.

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

Desinstalar Azure CLI

Si decide desinstalar el CLI de Azure, lamentamos verle partir. Antes de desinstalar, use el comando az feedback para contarnos lo que se podría mejorar o corregir. Nuestro objetivo es que Azure CLI esté libre de errores y sea fácil de usar. Si encontró un error, le agradeceríamos si file un problema de GitHub.

1. Desinstale con apt-get remove:

   sudo apt-get remove -y azure-cli
   

2. Si no tiene previsto volver a instalar la CLI, quite la información del repositorio de Azure CLI:

   sudo rm /etc/apt/sources.list.d/azure-cli.sources
   

3. Si no va a usar ningún otro paquete de Microsoft, quite la clave de firma:

   sudo rm /etc/apt/keyrings/microsoft.gpg
   

4. Quite los paquetes que no necesite:

   sudo apt autoremove
   

Eliminar datos

Si no tiene previsto volver a instalar Azure CLI, quite sus datos.

rm -rf ~/.azure

Solución de problemas

Estos son algunos problemas comunes que se han observado cuando se instala con apt. Si experimenta un problema que no se trata aquí, file un problema en GitHub.

El paquete azure-cli admite la arquitectura ARM64 desde la versión 2.46.0 de la CLI.

lsb_release no devuelve la versión de distribución de base correcta

Algunas distribuciones derivadas de Ubuntu o Debian (como Linux Mint) no pueden devolver el nombre de la versión correcta de lsb_release. Este valor se utiliza en el proceso de instalación para determinar el paquete que desea instalar. Si conoce el nombre de código de la versión de Ubuntu o Debian de la que deriva su distribución, puede establecer el valor de AZ_REPO manualmente al agregar el repositorio. En caso contrario, busque información relativa a su distribución acerca de cómo determinar el nombre del código de distribución base y establezca AZ_REPO en el valor correcto.

No hay ningún paquete para su distribución

A veces, un paquete de Azure CLI actualizado no está disponible inmediatamente después de una versión de distribución. El Azure CLI está diseñado para ser resistente a versiones futuras de dependencias y se basa en la menor cantidad posible de ellas. Si no hay ningún paquete disponible para su distribución de base, pruebe un paquete de una distribución anterior.

Para probar un paquete para una distribución anterior, establezca el valor de AZ_REPO manualmente al agregar el repositorio. En el caso de las distribuciones de Ubuntu, use el repositorio jammy más reciente:

AZ_REPO="jammy"

En el caso de las distribuciones de Debian, use el repositorio bookworm más reciente:

AZ_REPO="bookworm"

Importante

Las distribuciones lanzadas antes de Ubuntu Bionic y Debian Buster no se admiten.

El sistema operativo elemental (EOS) no puede instalar el Azure CLI

EOS no puede instalar el Azure CLI porque lsb_release devuelve HERA, que es el nombre de la versión eos. La solución es corregir el archivo /etc/apt/sources.list.d/azure-cli.sources y cambiar Suites: hera por Suites: bionic.

Contenido del archivo original:

Types: deb
URIs: https://packages.microsoft.com/repos/azure-cli/
Suites: hera
Components: main
Architectures: amd64
Signed-by: /etc/apt/keyrings/microsoft.gpg

Contenido de archivo modificado:

Types: deb
URIs: https://packages.microsoft.com/repos/azure-cli/
Suites: bionic
Components: main
Architectures: amd64
Signed-by: /etc/apt/keyrings/microsoft.gpg

El servidor proxy bloquea la conexión

Si no puede conectarse a un recurso externo debido a un servidor proxy, asegúrese de que ha configurado correctamente las variables HTTP_PROXY y HTTPS_PROXY en el shell. Debe ponerse en contacto con el administrador del sistema para saber qué hosts y puertos se van a usar para estos servidores proxy.

Muchos programas de Linux usan los valores de estas variables y durante el proceso de instalación. Para establecer estos 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

Si usted está detrás de un proxy, estas variables de shell deben establecerse para conectarse a los servicios de Azure con la CLI. Si no utiliza autenticación básica, se recomienda exportar estas variables en su archivo .bashrc. Siga siempre las directivas de seguridad de su empresa y los requisitos del administrador del sistema.

Es posible que también quiera configurar explícitamente apt para usar siempre este proxy. Asegúrese de que las líneas siguientes aparecen en un archivo de configuración apt en /etc/apt/apt.conf.d/. Se recomienda usar el archivo de configuración global existente, un archivo de configuración de proxy existente, 40proxies o 99local, pero seguir sus requisitos de administración del sistema.

Acquire {
    http::proxy "http://[username]:[password]@[proxy]:[port]";
    https::proxy "https://[username]:[password]@[proxy]:[port]";
}

Si el proxy no utiliza autenticación básica, quite la parte [username]:[password]@ del URI del servidor proxy. Si necesita más información para configurar el servidor proxy, consulte la documentación oficial de Ubuntu:

• página apt.conf man
• Wiki de Ubuntu: apt-get howto

Para conseguir la clave de firma de Microsoft y obtener el paquete de nuestro repositorio, el proxy debe permitir las conexiones HTTPS a la siguiente dirección: `https://packages.microsoft.com.

La CLI no se puede instalar o ejecutar en Windows Subsystem for Linux

Dado que Windows Subsystem for Linux (WSL) es una capa de traducción de llamadas del sistema sobre la plataforma de Windows, podría experimentar un error al intentar instalar o ejecutar el Azure CLI. La CLI se basa en algunas características que podrían producir un error en WSL. Si experimenta un error, independientemente de cómo instale la CLI, es muy probable que se trate de un problema de WSL y no del proceso de instalación de la CLI.

Para solucionar los problemas de instalación de WSL y posiblemente resolver otros problemas:

• Si puede, ejecute un proceso de instalación idéntico en una máquina Linux para ver si se realiza correctamente. Si es así, su problema probablemente está relacionado con WSL. Para iniciar una máquina virtual Linux en Azure, consulte la documentación crear una máquina virtual Linux en el portal de Azure.
• Asegúrese de que usa la versión más reciente de WSL. Para obtener la versión más reciente, actualizar la instalación de Windows 10.
• Verifique los problemas abiertos con WSL que pudieran resolver sus problemas. Suele haber sugerencias sobre cómo solucionar el problema o información sobre una versión donde se corrige el problema.
• Si no hay ninguna incidencia abierta para su problema, abra una incidencia nueva con WSL y asegúrese de incluir toda la información posible.

Si sigue teniendo problemas al instalar o ejecutar en WSL, considere instalar la CLI para Windows.

Instalación de Azure CLI

Los RPM se publican para Azure Linux a través de CBL-Mariner. El paquete azure-cli admite la arquitectura ARM64 desde la versión 2.46.0 de la CLI.

Para instalar el Azure CLI, siga estos pasos:

1. Instale el conjunto de certificados raíz de confianza mantenido oficialmente por Microsoft.

   sudo tdnf install ca-certificates
   

2. Instale Azure CLI:

   sudo tdnf install azure-cli
   

Instalación de una versión concreta

Las versiones disponibles se pueden encontrar en notas de la versión de Azure CLI.

Para ver las versiones disponibles con el comando:

tdnf list azure-cli

Para instalar una versión concreta:

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

Actualizar Azure CLI

Actualice el Azure CLI con el comando tdnf update:

sudo tdnf update azure-cli

Desinstalar Azure CLI

Si decide desinstalar el CLI de Azure, lamentamos verle partir. Antes de desinstalar, use el comando az feedback para contarnos lo que se podría mejorar o corregir. Nuestro objetivo es que Azure CLI esté libre de errores y sea fácil de usar. Si encontró un error, le agradeceríamos si file un problema de GitHub.

Quite el paquete del sistema:

sudo tdnf remove azure-cli

Eliminar datos

Si no tiene previsto volver a instalar Azure CLI, quite sus datos.

rm -rf ~/.azure

Pasos siguientes

Ahora que instaló el Azure CLI, realice un breve recorrido por sus características y comandos comunes.

Comience con Azure CLI