Mettre à jour les conteneurs dans Azure Container Instances

Article
10/15/2024

Lors du fonctionnement normal de vos instances de conteneur, vous devrez peut-être mettre à jour les conteneurs en cours d'exécution dans un groupe de conteneurs. Par exemple, vous pouvez mettre à jour une propriété telle qu’une version d’image, un nom DNS ou une variable d’environnement, ou actualiser une propriété dans un conteneur dont l’application s’est bloquée.

Pour mettre à jour les conteneurs d’un groupe de conteneurs en cours d’exécution, redéployez un groupe existant en ayant modifié au moins une propriété. Lorsque vous mettez à jour un groupe de conteneurs, tous les conteneurs en cours d’exécution sont redémarrés sur place, en général sur le même hôte conteneur sous-jacent.

Notes

Les groupes de conteneurs terminés ou supprimés ne peuvent pas être mis à jour. Une fois qu’un groupe de conteneurs s’est arrêté (dans un état de réussite ou d’échec) ou a été supprimé, le groupe doit être déployé en tant que nouveau groupe. Consultez les autres limitations.

Mettre à jour un groupe de conteneurs

Pour mettre à jour un groupe de conteneurs existant

Émettez la commande create (ou utilisez le portail Azure) et spécifiez le nom d’un groupe existant.
Modifiez ou ajoutez au moins une propriété du groupe qui prend en charge la mise à jour quand vous redéployez. Certaines propriétés ne prennent pas en charge les mises à jour.
Définissez d’autres propriétés avec les valeurs que vous avez fournies précédemment. Si vous ne définissez pas de valeur pour une propriété, elle reprend sa valeur par défaut.

Remarque

Si vous définissez toutes les propriétés sur les valeurs que vous avez fournies précédemment et que vous n'en modifiez ni n'en ajoutez aucune, le conteneur redémarrera en réponse à la commande create.

Conseil

Un fichier YAML permet de conserver la configuration de déploiement d’un groupe de conteneurs et fournit un point de départ pour déployer un groupe mis à jour. Si vous avez appliqué une autre méthode pour créer le groupe, vous pouvez exporter la configuration vers YAML à l’aide d’az container export.

Exemple

L’exemple Azure CLI suivant met à jour un groupe de conteneurs avec une nouvelle étiquette de nom DNS. Étant donné que la propriété d’étiquette de nom DNS du groupe est celui qui peut être mis à jour, le groupe de conteneurs est redéployé et ses conteneurs sont redémarrés.

Déploiement initial avec l’étiquette de nom DNS myapplication-staging :

# Create container group
az container create --resource-group myResourceGroup --name mycontainer \
    --image nginx:alpine --dns-name-label myapplication-staging

Mettez à jour le groupe de conteneurs avec une nouvelle étiquette de nom DNS, application, et définissez les propriétés restantes avec les valeurs utilisées précédemment :

# Update DNS name label (restarts container), leave other properties unchanged
az container create --resource-group myResourceGroup --name mycontainer \
    --image nginx:alpine --dns-name-label myapplication

Avantages de la mise à jour

Lorsque vous mettez à jour un groupe de conteneurs existant, le déploiement est plus rapide. Lorsque vous redéployez un groupe de conteneurs existant, ses couches d’images conteneur sont extraites des couches mises en cache par le déploiement précédent. Au lieu de tirer tous les calques d’image récents provenant du Registre, comme c’est le cas avec les nouveaux déploiements, seuls les calques modifiés (s’il en existe) sont tirés.

Lorsque vous mettez à jour un groupe existant au lieu d’en déployer un nouveau, les applications basées sur des images conteneur volumineuses (par exemple, Windows Server Core) peuvent être déployées beaucoup plus rapidement.

Limites

Certaines propriétés de groupe de conteneurs ne peuvent pas être mises à jour. Pour modifier certaines propriétés d’un groupe de conteneurs, vous devez d’abord supprimer, puis redéployer le groupe. Consultez Propriétés qui nécessitent la suppression du conteneur.
Tous les conteneurs d’un groupe de conteneurs sont redémarrés lorsque vous mettez à jour ce groupe. Vous ne pouvez pas effectuer une mise à jour ou un redémarrage sur place pour un seul conteneur du groupe.
L’adresse IP d’un groupe de conteneurs est généralement conservée entre les mises à jour, mais il n’est pas garanti qu’elle reste la même. Tant que le groupe de conteneurs est déployé sur le même hôte sous-jacent, le groupe de conteneurs conserve son adresse IP. Bien que rares, certains événements internes Azure peuvent entraîner un redéploiement sur un hôte différent. Pour atténuer ce problème, nous vous recommandons d’utiliser une étiquette de nom DNS pour vos instances de conteneur.
Les groupes de conteneurs terminés ou supprimés ne peuvent pas être mis à jour. Une fois qu’un groupe de conteneurs est arrêté (à l’état Arrêté) ou supprimé, le groupe est déployé en tant que nouveau groupe.

Notes

La commande de mise à jour peut ne pas fonctionner si le groupe de conteneurs Azure est attaché à un profil Stockage Azure.

Propriétés qui nécessitent la suppression du conteneur

Certaines propriétés de groupe de conteneurs ne peuvent pas être mises à jour. Par exemple, pour modifier la stratégie de redémarrage d’un conteneur, vous devez d’abord supprimer le groupe de conteneurs, puis le recréer.

Les modifications apportées à ces propriétés nécessitent la suppression d’un groupe de conteneurs avant le redéploiement :

Type de système d’exploitation
Ressources processeur, mémoire ou GPU
Stratégie de redémarrage
Profil réseau
Zone de disponibilité

Important

Les profils réseau ont été retirés depuis la version 2021-07-01 de l’API. Si vous utilisez cette version ou une version plus récente, ignorez les étapes et actions relatives aux profils réseau.

Lorsque vous supprimez, puis recréez un groupe de conteneurs, celui-ci n’est pas redéployé, mais recréé, comme un nouveau groupe. Toutes les couches d’image sont extraites du Registre, et non à partir de couches mises en cache par un déploiement précédent. L’adresse IP du conteneur peut également changer si celui-ci est déployé sur un autre hôte sous-jacent.

Étapes suivantes

Cet article mentionne groupes de conteneurs plusieurs fois. Chaque conteneur d’Azure Container Instances est déployé dans un groupe de conteneurs, et chaque groupe de conteneurs peut contenir plusieurs conteneurs. Les articles suivants fournissent plus d’informations sur les groupes de conteneurs :

Partage via