Compartir a través de


Instalación de la CLI de Azure en Linux

En este artículo se explica cómo instalar el CLI de Azure 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 CLI de Azure 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

  • CLI de Azure 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 si está utilizando un sistema Linux que no sea compatible con el administrador de paquetes .

Instalación de CLI de Azure

Para instalar el CLI de Azure, 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 el repositorio:

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

    Para CentOS Stream 10, agregue el repositorio .

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

    Para RHEL 9 o CentOS Stream 9, agregue el repositorio:

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

    Para RHEL 8, agregue el repositorio .

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

    Para RHEL 7, agregue 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 de CLI de Azure, consulte ciclo de vida de soporte técnico de CLI de Azure

  3. Realice la instalación con el comando .

    sudo dnf install azure-cli
    

Instalación de una versión concreta

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

  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 CLI de Azure

A partir de la versión 2.11.0, el CLI de Azure 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 opciones, consulte la página de referencia del comando. Para las versiones de CLI de Azure anteriores a 2.11.0, actualice reinstalando como se describe en Instalar el CLI de Azure.

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

sudo dnf update azure-cli

Desinstalar CLI de Azure

Si decide desinstalar el CLI de Azure, lamentamos su partida. Antes de desinstalar, use el comando para contarnos lo que se podría mejorar o corregir. Nuestro objetivo es que el CLI de Azure sea libre de errores y 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 CLI de Azure, quite sus datos.

rm -rf ~/.azure

Solución de problemas

Estos son algunos problemas comunes que se han observado cuando se instala con . 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 . De lo contrario, primero debe instalar un paquete python3 y, después, instalar CLI de Azure sin dependencia.

Puede usar el siguiente comando para descargar e instalar el script de instalación de CLI de Azure 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, CLI de Azure 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 CLI de Azure. 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 al ejecutar el código siguiente. Use 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 pero sigue recibiendo el error . 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 y 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 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 . 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 para usar siempre este proxy. Asegúrese de que las líneas siguientes aparecen en la sección de :

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

Para 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 Subsistema de Windows para Linux

Dado que Subsistema de Windows para 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 CLI de Azure. 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

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

Instalación de CLI de Azure

Para instalar CLI de Azure 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 CLI de Azure 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 CLI de Azure mediante repositorios de Microsoft, siga estos pasos.

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

  1. Instale :

    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 local.

    sudo zypper addrepo --name 'Azure CLI' --check https://packages.microsoft.com/yumrepos/azure-cli azure-cli
    
  4. Actualice el índice del paquete 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 como se mostró anteriormente. Las versiones disponibles se pueden encontrar en las notas de lanzamiento de CLI de Azure.

  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 CLI de Azure

A partir de la versión 2.11.0, el CLI de Azure 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 opciones, consulte la página de referencia del comando. Para las versiones de CLI de Azure anteriores a 2.11.0, actualice reinstalando como se describe en Instalar el CLI de Azure.

También puede actualizar el paquete con el comando .

sudo zypper refresh
sudo zypper update azure-cli

Desinstalar CLI de Azure

Si decide desinstalar el CLI de Azure, lamentamos su partida. Antes de desinstalar, use el comando para contarnos lo que se podría mejorar o corregir. Nuestro objetivo es que el CLI de Azure sea libre de errores y 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 CLI de Azure, quite sus datos.

rm -rf ~/.azure

Solución de problemas

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

Instalación sin Python 3

Importante

El paquete RPM del CLI de Azure depende del paquete python3. En su sistema, esta puede ser una versión de Python anterior al requisito de Python 3.6.x. Si esto le afecta, busque un paquete 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. CLI de Azure 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 CLI de Azure 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 CLI de Azure más reciente:

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

Si ha actualizado el CLI de Azure sin quitar las dependencias de la versión 2.0.45, sus dependencias anteriores pueden afectar a la versión más reciente del CLI de Azure. Debe volver a agregar la versión anterior para vincularla con sus dependencias y, a continuación, eliminar 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 CLI de Azure. En primer lugar, puede seguir los pasos 1 a 3 de las instrucciones de instalación para agregar el repositorio . A continuación, cree una versión superior de desde el código fuente. Por último, puede descargar el paquete CLI de Azure e instalarlo sin dependencia.

Puede usar el siguiente comando para instalar o actualizar CLI de Azure en función de los pasos anteriores. El script instala Python 3.8 en /usr/local/azcli y hace que CLI de Azure 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 y 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 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 . 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 (mediante ) para usar siempre este proxy. Para ello, ejecute el comando 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 en .

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 Subsistema de Windows para Linux

Dado que Subsistema de Windows para 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 CLI de Azure. 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 CLI de Azure

Hay dos opciones para instalar el CLI de Azure 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 CLI de Azure es a través de un script mantenido por el equipo de CLI de Azure. Este script ejecuta todos los comandos de instalación en un solo paso. Este script se descarga mediante y se canaliza directamente a para instalar la CLI.

Si desea inspeccionar el contenido del script antes de ejecutarlo, descargue el script con 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 CLI de Azure.

  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 CLI de Azure:
    AZ_DIST=$(lsb_release -cs)
    echo "Types: deb
    URIs: https://packages.microsoft.com/repos/azure-cli/
    Suites: ${AZ_DIST}
    Components: main
    Architectures: $(dpkg --print-architecture)
    Signed-by: /etc/apt/keyrings/microsoft.gpg" | sudo tee /etc/apt/sources.list.d/azure-cli.sources
    
  4. Actualice la información del repositorio e instale el paquete :

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

Instalación de una versión concreta

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

  1. Vea las versiones disponibles del CLI de Azure.

    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 CLI de Azure 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, la 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 para encontrar la distribución que está ejecutando.

Actualizar CLI de Azure

A partir de la versión 2.11.0, el CLI de Azure 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 opciones, consulte la página de referencia del comando. Para las versiones de CLI de Azure anteriores a 2.11.0, actualice reinstalando como se describe en Instalar el CLI de Azure.

También puede usar 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 .

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

Desinstalar CLI de Azure

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

  1. Desinstale con :

    sudo apt-get remove -y azure-cli
    
  2. Si no tiene previsto volver a instalar la CLI, quite la información del repositorio de CLI de Azure:

    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 CLI de Azure, quite sus datos.

rm -rf ~/.azure

Solución de problemas

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

El paquete 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 . 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 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 en el valor correcto.

No hay ningún paquete para su distribución

A veces, un paquete de CLI de Azure actualizado no está disponible inmediatamente después de una versión de distribución. El CLI de Azure 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 manualmente al agregar el repositorio. En el caso de las distribuciones de Ubuntu, use el repositorio más reciente:

AZ_REPO="jammy"

En el caso de las distribuciones de Debian, use el repositorio 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 CLI de Azure

EOS no puede instalar el CLI de Azure porque lsb_release devuelve HERA, que es el nombre de la versión eos. La solución es corregir el archivo y cambiar por .

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 y 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 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 . 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 para usar siempre este proxy. Asegúrese de que las líneas siguientes aparecen en un archivo de configuración en . Se recomienda usar el archivo de configuración global existente, un archivo de configuración de proxy existente, o , 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 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: `

La CLI no se puede instalar o ejecutar en Subsistema de Windows para Linux

Dado que Subsistema de Windows para 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 CLI de Azure. 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 CLI de Azure

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

Para instalar el CLI de Azure, siga estos pasos:

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

    sudo tdnf install ca-certificates
    
  2. Instale CLI de Azure:

    sudo tdnf install azure-cli
    

Instalación de una versión concreta

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

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 CLI de Azure

Actualice el CLI de Azure con el comando tdnf update:

sudo tdnf update azure-cli

Desinstalar CLI de Azure

Si decide desinstalar el CLI de Azure, lamentamos su partida. Antes de desinstalar, use el comando para contarnos lo que se podría mejorar o corregir. Nuestro objetivo es que el CLI de Azure sea libre de errores y 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 CLI de Azure, quite sus datos.

rm -rf ~/.azure

Pasos siguientes

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