Tutoriel 📝 Résoudre les problèmes de déploiement de conteneurs Windows Server

[Sylvain*]

Résoudre les problèmes de déploiement de conteneurs Windows Server

Introduction

La gestion des conteneurs Windows Server peut s'avérer complexe, notamment lors de leur déploiement ou de leur administration sur des hôtes Windows. Les différences entre Windows Server Containers et Hyper-V Containers, les dépendances d'images, et les incompatibilités de versions peuvent entraîner de nombreux dysfonctionnements. Ce tutoriel fournit plusieurs approches pour diagnostiquer et corriger les problèmes les plus fréquents.

---

Prérequis

• Connaissances générales des conteneurs Docker sous Windows

• Familiarité avec PowerShell et la ligne de commande Docker

• Accès administrateur sur le serveur hôte Windows Server 2019/2022

---

Différentes Approches

• Approche #1 : CMD – Vérification des services et redémarrage de Docker

• Approche #2 : PowerShell – Gestion, suppression et redéploiement des conteneurs

• Approche #3 : Script .PS1 – Réinitialisation complète de l’environnement Docker

---

Niveau de difficulté

• Approche #1 : Facile

• Approche #2 : Intermédiaire

• Approche #3 : Avancé

---

Les Avantages

• Approche #1 : Rapide et sans impact sur les données

• Approche #2 : Permet un contrôle granulaire sur les images et les conteneurs

• Approche #3 : Restauration d’un environnement sain en cas de corruption

---

Les Inconvénients

• Approche #1 : Limitée si les images ou conteneurs sont corrompus

• Approche #2 : Peut nécessiter la suppression manuelle de ressources

• Approche #3 : Risque de suppression de toutes les données Docker

---

Approche #1

Ouvrir une invite CMD en administrateur

Vérifier que le service Docker est actif

sc query com.docker.service

Redémarrer le service Docker

net stop com.docker.service && net start com.docker.service

Vérifier que les conteneurs fonctionnent à nouveau

docker ps -a

---

Approche #2

Ouvrir PowerShell en mode administrateur

Lister les conteneurs en erreur

docker ps -a --filter "status=exited"

Supprimer les conteneurs défectueux

docker rm $(docker ps -a -q --filter "status=exited")

Supprimer les images inutilisées

docker image prune -a -f

Retélécharger une image Windows officielle

docker pull mcr.microsoft.com/windows/servercore:ltsc2022
[br][/br]
[hr][/hr]
[br][/br]
⚙️ [b]Approche #3[/b]
[br][/br]
1️⃣ Créer un script [b].ps1[/b] nommé [b]Reset-Containers.ps1[/b]
[br][/br]
2️⃣ Contenu du script
[br][/br]
[code]
Stop-Service com.docker.service
docker stop $(docker ps -q)
docker rm -f $(docker ps -aq)
docker rmi -f $(docker images -q)
Start-Service com.docker.service

Exécuter le script avec PowerShell en administrateur

.\Reset-Containers.ps1

---

Astuce

Utilisez une image Nano Server ou Server Core compatible avec la version exacte du noyau Windows de l’hôte.

---

Mise en garde

Des incompatibilités entre l’image du conteneur et la version de l’hôte Windows sont fréquentes. Vérifiez toujours la compatibilité via docker info et docker version.

---

Conseil

Commentez les scripts PowerShell pour qu’ils soient compréhensibles à long terme.

---

Solution alternative

Vous pouvez également utiliser des interfaces de gestion visuelle pour Docker sur Windows Server :

• Portainer Community Edition

• Rancher Desktop

---

Références

• Support Microsoft

• Microsoft Learn

• Recherche Google

• Recherche Github

---

Conclusion

La gestion des conteneurs sur Windows Server nécessite une bonne compréhension de l’environnement Docker ainsi que de la compatibilité des images Windows. Les méthodes proposées permettent de diagnostiquer rapidement l’état des services et des conteneurs, de réinitialiser l’environnement, ou encore de restaurer un état fonctionnel. Pour des environnements de production, il est recommandé d’automatiser les vérifications avec des scripts PowerShell fiables et documentés.