Instalación de la CLI clásica de Azure

  • Artículo

Importante

Este tema describe cómo instalar la CLI clásica de Azure. La CLI clásica está en desuso y solo debe usarse con el modelo de implementación clásico. Para todas las demás implementaciones, utilice la CLI de Azure.

Instale rápidamente la CLI clásica de Azure para utilizar un conjunto de comandos de código abierto basados en shell para crear y administrar recursos en Microsoft Azure. Tiene varias opciones para instalar estas herramientas multiplataforma en su equipo:

  • Paquete de npm: ejecute npm (el administrador de paquetes para JavaScript) para instalar el paquete de la CLI clásica de Azure en su distribución de Linux o sistema operativo. Se requieren node.js y npm.
  • Instalador: descargue un instalador para facilitar la instalación en Mac o Windows.
  • Contenedor de Docker: empiece a usar la CLI clásica en un contenedor de Docker listo para ejecutarse. Requiere un host de Docker.

Si desea obtener más opciones y los antecedentes, consulte el repositorio del proyecto en GitHub.

Una vez que instale la CLI clásica de Azure, conéctese con azure login y ejecute los comandos azure desde la interfaz de la línea de comandos (Bash, Terminal, símbolo del sistema, etc.) para trabajar con los recursos de Azure.

Opción 1: Instalación de un paquete de NPM

Para instalar la CLI clásica desde un paquete de npm, asegúrese de que ha descargado e instalado la versión más reciente de Node.js y npm. A continuación, ejecute npm install para instalar el paquete azure-cli:

npm install -g azure-cli

En distribuciones de Linux, es posible que tenga que usar sudo para ejecutar correctamente el comando npm, tal como se muestra a continuación:

sudo npm install -g azure-cli

Nota

Si necesita instalar o actualizar Node.js y npm en el sistema operativo, se recomienda instalar Node.js LTS versión 4.x o posterior. Si utiliza una versión anterior, podrían producirse errores de instalación.

Si lo prefiere, también puede descargar un archivo tar desde las versiones de GitHub. Después, instale el paquete de npm descargado de la siguiente manera (en las distribuciones de Linux podría tener que usar sudo):

npm install -g <path to downloaded tar file>

Opción 2: Uso de un instalador

Si usa un equipo Mac o Windows, los instaladores DMG y MSI están disponibles en versiones de GitHub.

Sugerencia

En Windows, también puede descargar el Instalador de plataforma web para instalar la CLI clásica. Este instalador ofrece la opción de instalar SDK de Azure adicionales y herramientas de la línea de comandos.

Opción 3: Uso de un contenedor Docker

Si ha configurado el equipo como un host de Docker, puede ejecutar la CLI clásica de Azure en un contenedor de Docker. Ejecute el comando siguiente (en las distribuciones de Linux, es posible que tenga que usar sudo):

docker run -it mcr.microsoft.com/azure-cli:0.10.14

Ejecución de los comandos de la CLI clásica de Azure

Una vez instalada la CLI clásica de Azure, ejecute el comando azure desde la interfaz de usuario de la línea de comandos (Bash, Terminal, símbolo del sistema, etc.). Por ejemplo, si desea ejecutar el comando help, escriba lo siguiente:

azure help

Nota

En algunas distribuciones de Linux, puede recibir un error similar al /usr/bin/env: ‘node’: No such file or directory. Este error procede de las instalaciones recientes de Node.js que se instala en /usr/bin/nodejs. Para corregirlo, cree un vínculo simbólico a /usr/bin/node, para lo que debe ejecutar este comando:

sudo ln -s /usr/bin/nodejs /usr/bin/node

Para saber qué versión de la CLI clásica de Azure se ha instalado, escriba lo siguiente:

azure --version

Nota

La primera vez que usa la CLI clásica de Azure, verá un mensaje en el que se le pregunta si quiere permitir que Microsoft recopile información de uso. La participación es voluntaria. Si elige participar, puede dejar de hacerlo cuando desee mediante la ejecución de azure telemetry --disable. Para habilitar la participación en cualquier momento, ejecute azure telemetry --enable.

Actualización de la CLI clásica

Microsoft puede liberar versiones actualizadas de la CLI clásica de Azure. Vuelva a instalar la CLI clásica mediante el programa de instalación para su sistema operativo o ejecute el contenedor de Docker más reciente. O bien, si tiene las versiones de Node.js y npm más recientes instaladas, escriba lo siguiente para efectuar la actualización (en las distribuciones de Linux, es posible que necesite utilizar sudo).

npm update -g azure-cli

Habilitación de la finalización con tabulación

La función de autocompletar de los comandos de la CLI clásica es compatible con Mac y Linux.

Para habilitarla en zsh, ejecute el siguiente código:

echo '. <(azure --completion)' >> .zshrc

Para habilitarla en Bash, ejecute el siguiente código:

azure --completion >> ~/azure.completion.sh
echo 'source ~/azure.completion.sh' >> ~/.bash_profile

Pasos siguientes