Instalación de la CLI de Azure 2.0

Instale hoy mismo la nueva versión de la CLI de Azure. La hemos mejorado y actualizado para facilitar la administración nativa de los recursos de Azure desde la línea de comandos. Se puede usar en macOS, Linux y Windows. Para más información sobre la versión más reciente, consulte las notas de la versión.

Nota

Si necesita la versión anterior de la CLI de Azure, vea aquí cómo instalar la CLI de Azure 1.0.

Instalación en macOS

En macOS, es posible instalar con Homebrew o de forma manual.

Instalación con Homebrew

  1. Si no lo tiene todavía, instale Homebrew siguiendo las instrucciones de instalación correspondientes.

  2. Si ha instalado manualmente la CLI, siga las instrucciones para la desinstalación manual.

  3. Actualice los repositorios locales de Homebrew.

    brew update
    
  4. Instale el paquete azure-cli.

    brew install azure-cli
    

Nota

Si instaló anteriormente la CLI de Azure 1.0 con Homebrew, en lugar de instalar el paquete puede obtener la CLI 2.0 durante el proceso de actualización normal de Homebrew.

brew upgrade

Instalación manual

  1. Instalación de la CLI de Azure 2.0 con curl.

    curl -L https://aka.ms/InstallAzureCli | bash
    
  2. Para que algunos cambios surtan efecto, es posible que tenga que reiniciar el shell.

    exec -l $SHELL
    
  3. Ejecute la CLI desde el símbolo del sistema con el comando az.

Instalación en Windows

Instalación con MSI para la línea de comandos de Windows

Para instalar la CLI en Windows y usarla en la línea de comandos de Windows, descargue y ejecute el instalador de la CLI de Azure (MSI).

Instalación con apt-get para Bash en Ubuntu en Windows

  1. Si no dispone de Bash en Windows, instálelo.

  2. Abra el shell de Bash.

  3. Modifique la lista de orígenes.

    echo "deb [arch=amd64] https://packages.microsoft.com/repos/azure-cli/ wheezy main" | \
         sudo tee /etc/apt/sources.list.d/azure-cli.list
    
  4. Ejecute los siguientes comandos sudo:

    sudo apt-key adv --keyserver packages.microsoft.com --recv-keys 417A0893
    sudo apt-get install apt-transport-https
    sudo apt-get update && sudo apt-get install azure-cli
    
  5. Ejecute la CLI desde el símbolo del sistema con el comando az.

Instalación en Debian/Ubuntu con apt-get

Para distribuciones que usan el administrador de paquetes apt, puede instalar la CLI de Azure 2.0 a través de apt-get.

Nota

La distribución debe ser compatible con Python 2.7.x o Python 3.x para poder usar la CLI.

  1. Modifique la lista de orígenes:

    • Sistema de 32 bits

      echo "deb https://packages.microsoft.com/repos/azure-cli/ wheezy main" | \
           sudo tee /etc/apt/sources.list.d/azure-cli.list
      
    • Sistema de 64 bits

      echo "deb [arch=amd64] https://packages.microsoft.com/repos/azure-cli/ wheezy main" | \
           sudo tee /etc/apt/sources.list.d/azure-cli.list
      
  2. Ejecute los siguientes comandos sudo:

    sudo apt-key adv --keyserver packages.microsoft.com --recv-keys 417A0893
    sudo apt-get install apt-transport-https
    sudo apt-get update && sudo apt-get install azure-cli
    
  3. Ejecute la CLI desde el símbolo del sistema con el comando az.

Instalación en RHEL, Fedora y CentOS con yum

Para distribuciones que usan el administrador de paquetes yum, puede instalar la CLI de Azure 2.0 a través de yum.

Nota

La distribución debe ser compatible con Python 2.7.x o Python 3.x para poder usar la CLI.

  1. Importe la clave del repositorio de Microsoft:

    sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
    
  2. Cree la información del repositorio azure-cli local:

    sudo sh -c 'echo -e "[azure-cli]\nname=Azure CLI\nbaseurl=https://packages.microsoft.com/yumrepos/azure-cli\nenabled=1\ngpgcheck=1\ngpgkey=https://packages.microsoft.com/keys/microsoft.asc" > /etc/yum.repos.d/azure-cli.repo'
    
  3. Actualice el índice del paquete yum e instálelo:

    yum check-update
    sudo yum install azure-cli
    
  4. Ejecute la CLI desde el símbolo del sistema con el comando az.

Instalación en openSUSE y SLE con zypper

Para distribuciones que usan el administrador de paquetes zypper, puede instalar la CLI de Azure 2.0 a través de zypper.

Nota

La distribución debe ser compatible con Python 2.7.x o Python 3.x para poder usar la CLI.

  1. Importe la clave del repositorio de Microsoft:

    sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
    
  2. Cree la información del repositorio azure-cli local:

    sudo sh -c 'echo -e "[azure-cli]\nname=Azure CLI\nbaseurl=https://packages.microsoft.com/yumrepos/azure-cli\nenabled=1\ntype=rpm-md\ngpgcheck=1\ngpgkey=https://packages.microsoft.com/keys/microsoft.asc" > /etc/zypp/repos.d/azure-cli.repo'
    
  3. Actualice el índice del paquete zypper e instálelo:

    sudo zypper refresh
    sudo zypper install azure-cli
    
  4. Ejecute la CLI desde el símbolo del sistema con el comando az.

Instalación con Docker

Mantenemos una imagen de Docker preconfigurada con la CLI de Azure 2.0.

Instalación de la CLI con docker run.

docker run azuresdk/azure-cli-python:<version>

Para saber qué versiones hay disponibles, consulte nuestras etiquetas de Docker.

La CLI se instala en la imagen como el comando az en /usr/local/bin.

Nota

Si desea seleccionar las claves SSH de su entorno de usuario, puede utilizar -v ${HOME}:/root para montar $HOME como /root.

docker run -v ${HOME}:/root azuresdk/azure-cli-python:<version>

Instalación en Linux sin un administrador de paquetes

Se recomienda instalar la CLI con un administrador de paquetes si es posible. Si no desea agregar repositorios de Microsoft, o si está trabajando con una distribución para la que no se ha proporcionado ningún paquete, puede instalar manualmente la CLI.

  1. Instale los requisitos previos en función de la distribución de Linux.

    Platform              | Prerequisites
    ----------------------|---------------------------------------------
    Ubuntu 15.10 or 16.04 | sudo apt-get update && sudo apt-get install -y python libssl-dev libffi-dev python-dev build-essential
    Ubuntu 12.04 or 14.04 | sudo apt-get update && sudo apt-get install -y python libssl-dev libffi-dev python-dev
    Debian 8              | sudo apt-get update && sudo apt-get install -y python libssl-dev libffi-dev python-dev build-essential
    Debian 7              | sudo apt-get update && sudo apt-get install -y python libssl-dev libffi-dev python-dev
    CentOS 7.1 or 7.2     | sudo yum check-update; sudo yum install -y gcc python libffi-devel python-devel openssl-devel
    RedHat 7.2            | sudo yum check-update; sudo yum install -y gcc python libffi-devel python-devel openssl-devel
    SUSE OpenSUSE 13.2    | sudo zypper refresh && sudo zypper --non-interactive install curl gcc python python-xml libffi-devel python-devel openssl-devel
    

Si la distribución no está indicada anteriormente, debe instalar Python 2.7 o posterior, libffi y OpenSSL.

  1. Instalación de la CLI con curl.

    curl -L https://aka.ms/InstallAzureCli | bash
    
  2. Para que algunos cambios surtan efecto, es posible que tenga que reiniciar el shell.

    exec -l $SHELL
    
  3. Ejecute la CLI desde el símbolo del sistema con el comando az.

Solución de problemas

Si encuentra algún problema durante la instalación de la CLI, consulte esta sección para ver si su caso particular ya está descrito. Si su problema no está aquí, notifique un problema de Github.

Error de curl "Object Moved" (objeto movido)

Si curl muestra un error relacionado con el parámetro -L o un mensaje de error con el texto "Object Moved" (Objeto movido), pruebe a usar la dirección URL completa en lugar de la redirección aka.ms:

curl https://azurecliprod.blob.core.windows.net/install | bash

Comando az no encontrado

Debe borrar la caché de hash de comandos del shell. Ejecute

hash -r

y compruebe si el problema se resuelve.

Desinstalación de las versiones 1.x de la CLI

Si tiene una versión de la CLI 1.x anterior en el sistema, puede desinstalarla según el tipo de instalación que se usó.

Desinstalación con npm

Quite la CLI anterior con npm uninstall.

npm uninstall -g azure-cli

Desinstalación con código distribuible

Si realizó la instalación mediante el instalador de la CLI de Azure (MSI) o un paquete de macOS, use la misma herramienta para quitar la instalación.

Desinstalación con Docker

Si ha instalado una imagen de Docker para usar la versión anterior de la CLI, quite dicha imagen y los contenedores asociados. Después, puede volver a crear los contenedores después de instalar la nueva imagen de Docker, tal y como se describe en las instrucciones de instalación.

docker rmi -f microsoft/azure-cli

Actualización de la CLI

Para actualizar la CLI de Azure, use el mismo método que usó para su instalación.

Actualización con Homebrew

  1. Si anteriormente realizó la instalación de forma manual, siga las instrucciones de instalación con Homebrew.

  2. Actualice la información del repositorio local de Homebrew.

    brew update
    
  3. Actualice los paquetes instalados.

    brew upgrade
    

Actualización con MSI

Ejecute de nuevo el instalador de la CLI de Azure (MSI).

Actualización con apt-get

Para actualizar el paquete de la CLI, use apt-get upgrade.

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

Nota

Esto actualizará todos los paquetes instalados en el sistema que no hayan tenido un cambio de dependencia. Para actualizar solo la CLI, use apt-get install.

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

Actualización con Docker

  1. Actualización de la imagen local con docker pull.

    docker pull azuresdk/azure-cli-python
    
  2. Obtenga los contenedores que está usando con la imagen de la CLI.

    docker container ls -a --filter 'ancestor=azuresdk/azure-cli-python'
    
    CONTAINER ID        IMAGE                              COMMAND             CREATED             STATUS                        PORTS               NAMES
    34a868beb2ab        azuresdk/azure-cli-python:latest      "/bin/sh -c bash"   8 minutes ago       Exited (0) 8 minutes ago                       inspiring_benz
    

Nota

Si instaló una versión específica de la imagen, debe agregar :<version> al final del nombre de la imagen.

  1. Detenga y vuelva a crear los contenedores.

    docker stop inspiring_benz
    docker rm inspiring_benz
    docker run azuresdk/azure-cli-python
    

Actualización manual

Para actualizar, siga las instrucciones de instalación manual en macOS o Linux.

Desinstalación

Si decide desinstalar la CLI, sentimos que se marche. Debe desinstalar con el mismo método que utilizó para instalar la CLI.

Desinstalación con Homebrew

Desinstale el paquete azure-cli.

brew uninstall azure-cli

Desinstalación con MSI

Ejecute MSI de nuevo y elija la opción de desinstalación.

Desinstalación con apt-get

Desinstalación mediante apt-get remove:

sudo apt-get remove -y azure-cli

Desinstalación con Docker

Si ha instalado una imagen de Docker, debe quitar los contenedores que la ejecutan y, a continuación, eliminar la imagen local.

  1. Obtenga los contenedores que están ejecutando la imagen azure-cli.

    docker container ls -a --filter 'ancestor=azuresdk/azure-cli-python'
    
    CONTAINER ID        IMAGE                              COMMAND             CREATED             STATUS                        PORTS               NAMES
    34a868beb2ab        azuresdk/azure-cli-python:latest      "/bin/sh -c bash"   8 minutes ago       Exited (0) 8 minutes ago                       inspiring_benz
    
  2. Elimine los contenedores con la imagen de la CLI.

    docker rm 34a868beb2ab
    
  3. Quite la imagen de la CLI instalada localmente.

    docker rmi azuresdk/azure-cli-python
    

Nota

Si instaló una versión específica de la imagen, debe agregar :<version> al final del nombre de la imagen.

Desinstalación manual

Si usó el script de https://aka.ms/InstallAzureCli para instalar la CLI, siga estos pasos para desinstalarla.

  1. Quite los archivos instalados.

    rm -r <install location>/lib/azure-cli
    rm <install location>/bin/az
    
  2. Elimine la línea <install location>/lib/azure-cli/az.completion de <install location>/.bash_profile.

  3. Si el shell utiliza una caché de comandos, vuelva a cargarlo.

    hash -r
    

Nota

La ubicación de instalación predeterminada es /Users/<username>.

Notificación de problemas y comentarios sobre la CLI

Si aparecen errores al usar la herramienta, envíe un problema en la sección Issues (Problemas) del repositorio de GitHub. Para proporcionar comentarios desde la línea de comandos, use el comando az feedback.