Instalación de la CLI de Azure en macOSInstall Azure CLI on macOS

Para la plataforma macOS, puede instalar la CLI de Azure mediante el administrador de paquetes de Homebrew.For the macOS platform, you can install the Azure CLI with homebrew package manager. Homebrew facilita mantener actualizada la instalación de la CLI.Homebrew makes it easy to keep your installation of the CLI update to date. El paquete de la CLI se ha probado en las versiones de Mac OS 10.9 y versiones posteriores.The CLI package has been tested on macOS versions 10.9 and later.

La versión actual de la CLI de Azure es la 2.10.0.The current version of the Azure CLI is 2.10.0. Para más información sobre la versión más reciente, consulte las notas de la versión.For information about the latest release, see the release notes. Para averiguar la versión instalada y ver si tiene que actualizar, ejecute az --version.To find your installed version and see if you need to update, run az --version.

Instalación con HomebrewInstall with Homebrew

Homebrew es la manera más fácil de administrar la instalación de la CLI.Homebrew is the easiest way to manage your CLI install. Ofrece formas cómodas de instalar, actualizar y desinstalar.It provides convenient ways to install, update, and uninstall. Si no tiene Homebrew disponible en el sistema, instale Homebrew antes de continuar.If you don't have homebrew available on your system, install homebrew before continuing.

Para instalar la CLI, actualice la información del repositorio de Homebrew y ejecute el comando install:You can install the CLI by updating your brew repository information, and then running the install command:

brew update && brew install azure-cli

Importante

La CLI de Azure tiene una dependencia en el paquete python3 de Homebrew, y lo instalará.The Azure CLI has a dependency on the Homebrew python3 package, and will install it. Se garantiza que la CLI de Azure será compatible con la versión más reciente de python3 publicada en Homebrew.The Azure CLI is guaranteed to be compatible with the latest version of python3 published on Homebrew.

Después, ejecute la CLI de Azure con el comando az.You can then run the Azure CLI with the az command. Para iniciar sesión, use el comando az login.To sign in, use az login command.

  1. Ejecute el comando login.Run the login command.

    az login
    

    Si la CLI puede abrir el explorador predeterminado, lo hará y cargará una página de inicio de sesión de Azure.If the CLI can open your default browser, it will do so and load an Azure sign-in page.

    En caso contrario, abra una página del explorador en https://aka.ms/devicelogin y escriba el código de autorización que se muestra en el terminal.Otherwise, open a browser page at https://aka.ms/devicelogin and enter the authorization code displayed in your terminal.

  2. Inicie sesión con las credenciales de su cuenta en el explorador.Sign in with your account credentials in the browser.

Para más información acerca de los diferentes métodos de autenticación, consulte Inicio de sesión con la CLI de Azure.To learn more about different authentication methods, see Sign in with Azure CLI.

Solución de problemasTroubleshooting

Si se produce un problema al instalar la CLI a través de Homebrew, aquí se muestran algunos errores comunes.If you encounter a problem when installing the CLI through Homebrew, here are some common errors. Si tiene algún problema que no se trata aquí, abra una incidencia en GitHub.If you experience a problem not covered here, file an issue on github.

La conclusión no funcionaCompletion is not working

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/).The Homebrew formula of Azure CLI installs a completion file named az in the Homebrew-managed completions directory (default location is /usr/local/etc/bash_completion.d/). Para habilitar la conclusión, siga las instrucciones de Homebrew aquí.To enable completion, please follow Homebrew's instructions here.

No se puede encontrar Python o los paquetes instaladosUnable to find Python or installed packages

Puede haber una discrepancia con la versión secundaria u otros problemas durante la instalación de Homebrew.There may be a minor version mismatch or other issue during homebrew installation. La CLI no usa un entorno virtual de Python y debe buscar la versión de Python instalada.The CLI doesn't use a Python virtual environment, so it relies on finding the installed Python version. Una posible solución consiste en instalar y volver a vincular la dependencia de python3 desde Homebrew.A possible fix is to install and relink the python3 dependency from Homebrew.

brew update && brew install python3 && brew upgrade python3
brew link --overwrite python3

Versión de la CLI 1.x instaladaCLI version 1.x is installed

Si se instaló una versión no actualizada, podría deberse a que la memoria caché de Homebrew estaba obsoleta.If an out-of-date version was installed, it could be because of a stale homebrew cache. Siga las instrucciones de actualización.Follow the update instructions.

El servidor proxy bloquea la conexiónProxy blocks connection

No puede obtener recursos de Homebrew, a menos que lo haya configurado correctamente para usar el servidor proxy.You may be unable to get resources from Homebrew unless you have correctly configured it to use your proxy. Siga las instrucciones de configuración del servidor proxy de Homebrew.Follow the Homebrew proxy configuration instructions.

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.If you are behind a proxy, HTTP_PROXY and HTTPS_PROXY must be set to connect to Azure services with the CLI. Si no utiliza autenticación básica, se recomienda exportar estas variables en su archivo .bashrc.If you are not using basic auth, it's recommended to export these variables in your .bashrc file. Siga siempre las directivas de seguridad de su empresa y los requisitos del administrador del sistema.Always follow your business' security policies and the requirements of your system administrator.

Para obtener los recursos Bottle de Homebrew, el servidor proxy debe permitir las conexiones HTTPS a las siguientes direcciones:In order to get the bottle resources from Homebrew, your proxy needs to allow HTTPS connections to the following addresses:

  • https://formulae.brew.sh
  • https://homebrew.bintray.com

ActualizarUpdate

La CLI se actualiza regularmente con correcciones de errores, mejoras, nuevas características y funcionalidades en versión preliminar.The CLI is regularly updated with bug fixes, improvements, new features, and preview functionality. Hay una nueva versión disponible aproximadamente cada dos semanas.A new release is available roughly every two weeks. Debe actualizar la información del repositorio local y, a continuación, actualizar el paquete azure-cli.Update your local repository information and then upgrade the azure-cli package.

brew update && brew upgrade azure-cli

DesinstalaciónUninstall

Si decide desinstalar la CLI de Azure, sentimos que se marche.If you decide to uninstall the Azure CLI, we're sorry to see you go. Antes de desinstalar, use el comando az feedback para contarnos lo que se podría mejorar o corregir.Before you uninstall, use the az feedback command to let us know what could be improved or fixed. Nuestro objetivo es hacer una CLI de Azure sin errores y fácil de usar.Our goal is to make the Azure CLI bug-free and user-friendly. Si encuentra un error, le rogamos que abra una incidencia en GitHub.If you found a bug, we'd appreciate it if you file a GitHub issue.

Use Homebrew para desinstalar el paquete azure-cli.Use homebrew to uninstall the azure-cli package.

brew uninstall azure-cli

Otros métodos de instalaciónOther installation methods

Si no puede usar Homebrew para instalar la CLI de Azure en su entorno, es posible usar las instrucciones manuales para Linux.If you can't use homebrew to install the Azure CLI in your environment, it's possible to use the manual instructions for Linux. Tenga en cuenta que este proceso no se mantiene oficialmente para que sea compatible con macOS.Note that this process is not officially maintained to be compatible with macOS. Siempre se recomienda usar un administrador de paquetes como Homebrew.Using a package manager such as Homebrew is always recommended. Solo debe usar el método de instalación manual si no dispone de ninguna otra opción.Only use the manual installation method if you have no other option available.

Para las instrucciones de instalación manual, consulte Instalación de la CLI de Azure en Linux manualmente.For the manual installation instructions, see Install Azure CLI on Linux manually.

Pasos siguientesNext Steps

Ahora que ha instalado la CLI de Azure, dé un breve paseo por sus características y comandos más comunes.Now that you've installed the Azure CLI, take a short tour of its features and common commands.