Guide pratique pour exécuter Azure CLI dans un conteneur Docker

Vous pouvez utiliser Docker pour exécuter un conteneur Linux autonome avec Azure CLI préinstallée. Docker vous permet de vous familiariser rapidement avec un environnement isolé pour pouvoir y exécuter l’interface CLI. L’image peut également être utilisée comme base pour vos propres déploiements.

Avertissement

Azure CLI 2.63.0 (publié en août 2024) est la dernière version prise en charge sur l’image Docker Alpine. Microsoft ne fournira pas de mises à jour ou de correctifs de bogues supplémentaires pour cette image. Envisagez de migrer vers l’image Linux Azure pour Azure CLI, qui est entièrement prise en charge.

Pour désactiver les messages d’avertissement, exécutez az config set core.only_show_errors=yes. Pour plus d’informations sur les paramètres de configuration d’Azure CLI, consultez les valeurs de configuration cli et les variables d’environnement.

Démarrer le conteneur Docker avec Azure CLI préinstallé

Ouvrez une invite de commandes et démarrez le conteneur Docker avec Azure CLI préinstallé à l’aide de la commande suivante. Lorsqu’il est utilisé dans un pipeline, il est recommandé d’utiliser un nom de balise déterministe (par exemple cbl-mariner2.0)

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

Remarque

Si vous souhaitez sélectionner les clés SSH à partir de votre environnement utilisateur, utilisez -v ${HOME}/.ssh:/root/.ssh pour monter vos clés SSH dans l’environnement.

docker run -it -v ${HOME}/.ssh:/root/.ssh mcr.microsoft.com/azure-cli:cbl-mariner2.0

L’interface de ligne de commande est installé sur l’image en tant que commande az dans /usr/local/bin.

Exécuter le conteneur Docker avec une version spécifique d’Azure CLI

Vous trouverez les versions disponibles dans Notes de publication Azure CLI.

Pour exécuter une version spécifique d’Azure CLI dans le conteneur Docker, utilisez cette commande. Changez 2.62.0 avec votre version souhaitée.

docker run -it mcr.microsoft.com/azure-cli:2.62.0-cbl-mariner2.0

Mise à jour d’une image Docker

La mise à jour avec Docker nécessite l’extraction de la nouvelle image et la recréation de tous les conteneurs existants. Pour cette raison, évitez d’utiliser un conteneur hébergeant l’interface CLI comme magasin de données.

Mettre à jour votre image locale avec docker pull.

docker pull mcr.microsoft.com/azure-cli:cbl-mariner2.0

Désinstallation d’une image Docker

Si vous décidez de désinstaller l’interface de ligne de commande Azure, nous sommes désolés de vous voir partir. Avant de la désinstaller, utilisez la commande az feedback pour nous dire ce qui pourrait être amélioré ou révisé. Notre objectif est de rendre l’interface Azure CLI conviviale et exempte de bogues. Si vous avez rencontré un bogue, nous vous serions reconnaissants de bien vouloir signaler un problème lié à GitHub.

Après l’arrêt de tous les conteneurs exécutant l’image de l’interface CLI, supprimez-la.

docker rmi mcr.microsoft.com/azure-cli

Étapes suivantes

Maintenant que vous êtes prêt à utiliser Azure CLI dans un conteneur Docker, découvrez ses fonctionnalités et ses commandes courantes.