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.
Azure Command-Line Interface (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 administrador de paquetes homebrew. Homebrew facilita la instalación de la CLI de Azure actualizada. El paquete de la CLI de Azure requiere macOS 13 o posterior.
La versión actual de la CLI de Azure es la 2.81.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 la 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.
Para instalar la CLI de Azure en macOS, primero debe actualizar la información del repositorio de brew y luego ejecutar el comando install:
brew update && brew install azure-cli
Solución de problemas
Si se produce un problema al instalar la CLI de Azure a través de Homebrew, estos son algunos errores comunes. Si experimenta un problema que no se trata aquí, presente un problema en GitHub.
La finalización no funciona
La fórmula Homebrew de Azure CLI instala un archivo de compleción llamado az en el directorio de compleciones administrados 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 puede encontrar Python o los paquetes instalados
Puede haber una incompatibilidad de la versión secundaria u otro problema durante la instalación de Homebrew. La CLI de Azure no usa un entorno virtual de Python, por lo que se basa en buscar la versión instalada de Python. 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
La VERSIÓN 1.x de la CLI de Azure está 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
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 configurarse para conectarse a los servicios de Azure con la 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
La CLI de Azure se actualiza periódicamente con correcciones de errores, mejoras, nuevas características y funcionalidad en versión preliminar. Hay disponible una nueva versión aproximadamente una vez al mes.
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 az upgrade opciones, 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 luego actualizar el paquete azure-cli.
brew update && brew upgrade azure-cli
Desinstalar
Si decides desinstalar la CLI de Azure, lamentamos que decidas irte. 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 agradeceríamos que abra una incidencia en GitHub.
Usa Homebrew para desinstalar el paquete azure-cli.
brew uninstall azure-cli
Eliminar datos
Si no tiene previsto 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. 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 Instalar la CLI de Azure en Linux manualmente.
Pasos siguientes
Ahora que ha instalado la 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.
