Ejecución de la CLI de Azure en un contenedor de Docker

Puede usar Docker para ejecutar un contenedor de Linux independiente con la CLI de Azure preinstalada, lo que proporciona un entorno rápido y aislado para usar la CLI de Azure. Esta imagen de contenedor también puede servir como base para sus propias implementaciones personalizadas.

Advertencia

La CLI de Azure 2.63.0 (publicada en agosto de 2024) es la versión final compatible con la imagen de Docker basada en Alpine. Microsoft ya no proporciona actualizaciones ni correcciones de errores para esta imagen. Para garantizar la compatibilidad continua, migre a la imagen basada en Linux de Azure (Azure Linux 3.0), que se mantiene completamente. Consulte los ejemplos siguientes para usar Azure Linux 3.0.

Para suprimir los mensajes de advertencia, ejecute: az config set core.only_show_errors=yes. Para más información sobre las opciones de configuración, consulte Valores de configuración de la CLI de Azure y variables de entorno.

Inicio del contenedor Docker con Azure CLI preinstalada

Abra una terminal e inicie un contenedor de Docker con la CLI de Azure preinstalada mediante el siguiente comando. Al usar este comando en una canalización, use una etiqueta determinista (como azurelinux3.0) para garantizar un comportamiento coherente.

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

Nota:

Para usar las claves SSH locales dentro del contenedor, monte el directorio .ssh mediante la siguiente opción: --mount type=bind,src="$HOME"/.ssh,dst=/root/.ssh. Esta opción permite al contenedor acceder a las claves SSH desde el entorno de usuario.

docker run -it --mount type=bind,src="$HOME"/.ssh,dst=/root/.ssh mcr.microsoft.com/azure-cli:azurelinux3.0

La CLI de Azure está disponible en la imagen como comando az , que se encuentra en /usr/local/bin/az.

Ejecución del contenedor de Docker con una versión específica de la CLI de Azure

Puede encontrar versiones disponibles en las notas de la versión de Azure CLI.

Para ejecutar una versión específica de la CLI de Azure en un contenedor de Docker, use el siguiente comando y reemplace por 2.74.0 la versión deseada.

docker run -it mcr.microsoft.com/azure-cli:2.74.0-azurelinux3.0

Actualización de una imagen de Docker

Para actualizar la CLI de Azure al usar Docker, debe extraer la imagen más reciente y volver a crear los contenedores existentes. Debido a este proceso de actualización, evite el uso de contenedores de la CLI de Azure como almacenes de datos persistentes.

Actualice la imagen local mediante el siguiente comando:

docker pull mcr.microsoft.com/azure-cli:latest

Desinstalación de una imagen de Docker

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.

Para quitar la imagen de Docker, detenga primero los contenedores en ejecución y, a continuación, ejecute:

docker rmi mcr.microsoft.com/azure-cli

Pasos siguientes

Ahora que está listo para usar la CLI de Azure en un contenedor de Docker, realice un recorrido rápido por sus características clave y comandos usados habitualmente para empezar.

Introducción a la CLI de Azure