Instalación de la CLI de Azure en macOS
El Interfaz de la línea de comandos de Azure (CLI) es una herramienta de línea de comandos multiplataforma que se puede instalar localmente en equipos macOS. Puede usar la CLI de Azure para conectarse a Azure y ejecutar comandos administrativos en recursos de Azure mediante avisos de línea de comandos interactivos o un script.
Para la plataforma macOS, instale la CLI de Azure con el administrador de paquetes homebrew. Homebrew facilita mantener actualizada la instalación de la CLI. El paquete de la CLI se ha probado en las versiones de Mac OS 10.9 y versiones posteriores.
La versión actual de la CLI de Azure es la 2.66.0. Para más información sobre la versión más reciente, consulte las notas de la versión. Para averiguar la versión instalada y ver si tiene que actualizar, ejecute az version.
Instalación con Homebrew
Homebrew es la manera más fácil de administrar la instalación de la CLI. Ofrece formas cómodas de instalar, actualizar y desinstalar. Si no tiene Homebrew disponible en el sistema, instale Homebrew antes de continuar.
Para instalar la CLI de Azure en macOS, actualice la información del repositorio de Homebrew y ejecute el comando install:
brew update && brew install azure-cli
Solución de problemas
Si se produce un problema al instalar la CLI a través de Homebrew, aquí se muestran algunos errores comunes. Si tiene algún problema que no se trata aquí, abra una incidencia en GitHub.
La finalización no funciona
La fórmula Homebrew de la CLI de Azure instala un archivo de conclusión llamado az en el directorio de conclusiones administradas por Homebrew (la ubicación predeterminada es /usr/local/etc/bash_completion.d/). Para habilitar la finalización, siga las instrucciones de Homebrew aquí.
Para Zsh, agregue las dos líneas siguientes a la parte inferior del archivo .zshrc y, a continuación, guarde y vuelva a cargar el perfil Zsh.
autoload bashcompinit && bashcompinit
source $(brew --prefix)/etc/bash_completion.d/az
No se puede encontrar Python o los paquetes instalados
Puede haber una discrepancia con la versión secundaria u otros problemas durante la instalación de Homebrew. La CLI no usa un entorno virtual de Python y debe buscar la versión de Python instalada. Una posible solución consiste en instalar y volver a vincular la dependencia de python@3.10 desde Homebrew.
brew update && brew install python@3.10 && brew upgrade python@3.10
brew link --overwrite python@3.10
Versión de la CLI 1.x instalada
Si se instaló una versión no actualizada, podría deberse a que la memoria caché de Homebrew estaba obsoleta. Siga las instrucciones de actualización.
El servidor proxy bloquea la conexión
No puede obtener recursos de Homebrew, a menos que lo haya configurado correctamente para usar el servidor proxy. Siga las instrucciones de configuración del servidor proxy de Homebrew.
Importante
Si está detrás de un servidor proxy, HTTP_PROXY y HTTPS_PROXY 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.
Para obtener los recursos Bottle de Homebrew, el servidor proxy debe permitir las conexiones HTTPS a las siguientes direcciones:
https://formulae.brew.shhttps://homebrew.bintray.com
Actualizar
La CLI se actualiza regularmente con correcciones de errores, mejoras, nuevas características y funcionalidades en versión preliminar. Hay una nueva versión disponible aproximadamente cada tres semanas.
A partir de la versión 2.11.0, la 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 de az upgrade, consulte la página de referencia del comando. Para las versiones de la CLI de Azure anteriores a la 2.11.0, actualice mediante la reinstalación como se describe en Instalación de la CLI de Azure.
También puede actualizar la información del repositorio local de Homebrew y, a continuación, actualizar el paquete azure-cli.
brew update && brew upgrade azure-cli
Desinstalación
Si decide desinstalar la CLI de Azure, sentimos que se marche. Antes de desinstalar, use el comando az feedback para contarnos lo que se podría mejorar o corregir. Nuestro objetivo es hacer una CLI de Azure sin errores y fácil de usar. Si encuentra un error, le rogamos que abra una incidencia en GitHub.
Use Homebrew para desinstalar el paquete azure-cli.
brew uninstall azure-cli
Eliminar datos
Si no planea volver a instalar la CLI de Azure, quite sus datos.
rm -rf ~/.azure
Otros métodos de instalación
Si no puede usar Homebrew para instalar la CLI de Azure en su entorno, es posible usar las instrucciones manuales para Linux. Este proceso no se mantiene oficialmente para que sea compatible con macOS. Siempre se recomienda usar un administrador de paquetes como Homebrew. Solo debe usar el método de instalación manual si no dispone de ninguna otra opción.
Para las instrucciones de instalación manual, consulte Instalación de la CLI de Azure en Linux manualmente.
Pasos siguientes
Ahora que ha instalado la CLI de Azure en macOS, dé un breve paseo por sus características y comandos más comunes.
