Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
La interfaz Azure Command-Line (CLI) es una herramienta de línea de comandos multiplataforma que se puede instalar localmente en equipos macOS. Puede usar el CLI de Azure para conectarse a Azure y ejecutar comandos administrativos en Azure recursos mediante mensajes de línea de comandos interactivos o un script.
Para la plataforma macOS, instale el CLI de Azure con el administrador de paquetes homebrew. Homebrew facilita la instalación de la CLI de Azure actualizada. El paquete CLI de Azure requiere macOS 13 o posterior.
La versión actual del CLI de Azure es 2.85.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.
Instalación con Homebrew
Homebrew es la manera más fácil de administrar la instalación de CLI de Azure. Ofrece formas cómodas de instalar, actualizar y desinstalar. Si no tiene Homebrew disponible en el sistema, instale Homebrew antes de continuar.
Puede instalar el CLI de Azure en macOS actualizando la información del repositorio brew y ejecutando el comando install:
brew update && brew install azure-cli
Solución de problemas
Si se produce un problema al instalar el CLI de Azure a través de Homebrew, estos son algunos errores comunes. Si experimenta un problema que no se trata aquí, file un problema en GitHub.
La finalización no funciona
La fórmula homebrew de CLI de Azure instala un archivo de finalización denominado az en el directorio de finalizaciones 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 de su archivo .zshrc, luego guarde y vuelva a cargar su perfil de Zsh.
autoload bashcompinit && bashcompinit
source $(brew --prefix)/etc/bash_completion.d/az
No se pueden encontrar Python o paquetes instalados.
Puede haber una incompatibilidad de la versión secundaria u otro problema durante la instalación de Homebrew. El CLI de Azure no usa un entorno virtual de Python, por lo que se basa en 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
CLI de Azure versión 1.x está instalado
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
Es posible que no pueda obtener recursos de Homebrew a menos que lo configure para usar el proxy. Siga las instrucciones de configuración del proxy de Homebrew.
Importante
Si está detrás de un proxy, HTTP_PROXY y HTTPS_PROXY deben establecerse para conectarse a los servicios de Azure con CLI de Azure. Si no usa la autenticación básica, debe exportar estas variables en el .bashrc archivo. Siga siempre las directivas de seguridad de su empresa y los requisitos del administrador del sistema.
Para obtener los recursos de botella de Homebrew, el proxy debe permitir conexiones HTTPS a las siguientes direcciones:
https://formulae.brew.shhttps://homebrew.bintray.com
Actualizar
El CLI de Azure se actualiza periódicamente con correcciones de errores, mejoras, nuevas características y funcionalidad de versión preliminar. Hay disponible una nueva versión aproximadamente una vez al mes.
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 az upgrade 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 la información del repositorio local de Homebrew y luego actualizar el paquete azure-cli.
brew update && brew upgrade azure-cli
Desinstalar
Si decide desinstalar el CLI de Azure, lamentamos verlo partir. Antes de desinstalar, use el comando az feedback para contarnos lo que se podría mejorar o corregir. Nuestro objetivo es que el CLI de Azure sea sin errores y fácil de usar. Si encontró un error, le agradeceríamos si file un problema de GitHub.
Usa Homebrew para desinstalar el paquete azure-cli.
brew uninstall azure-cli
Eliminar datos
Si no tiene previsto volver a instalar el CLI de Azure, quite sus datos.
rm -rf ~/.azure
Otros métodos de instalación
Si no puede usar homebrew para instalar el 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. 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 obtener instrucciones de instalación manuales, consulte Install CLI de Azure en Linux manualmente.
Pasos siguientes
Ahora que instaló el CLI de Azure en macOS, realice un breve recorrido por sus características y comandos comunes.
Colaborar con nosotros en GitHub
El origen de este contenido se puede encontrar en GitHub, donde también puede crear y revisar problemas y solicitudes de incorporación de cambios. Para más información, consulte nuestra guía para colaboradores.
