Code : MO-PLT-007 | Version : 1.3 | Date : 26 juin 2026 | Auteur : C. Legrand
¶ Gérer les conteneurs via Portainer
¶ Objet
Ce mode opératoire décrit les opérations courantes de gestion des conteneurs Docker à travers l'interface web Portainer : consultation de l'état, des logs, des statistiques, et redémarrage des services.
Pour la procédure de connexion à Portainer, se référer au MO-PLT-011.
¶ Prérequis
- Être connecté au réseau du lycée ou via VPN WireGuard
- Être connecté à Portainer (cf. MO-PLT-011)
¶ Consulter la liste des conteneurs
Depuis le menu latéral, cliquer sur Containers. La liste affiche l'ensemble des conteneurs avec leur état, image, ports et statut de santé.
Les conteneurs en vert sont actifs, ceux en rouge sont arrêtés. La colonne Status indique le résultat du healthcheck (healthy, unhealthy, starting).
¶ Consulter les détails d'un conteneur
Cliquer sur le nom d'un conteneur pour afficher sa fiche détaillée.
Informations disponibles :
- Container details : identifiant, image, commande, politique de redémarrage
- Ports : correspondance entre ports internes et ports exposés
- Network : réseau Docker, adresse IP interne
- Volumes : points de montage et données persistantes
- Environment : variables de configuration
¶ Consulter les logs
Depuis la fiche d'un conteneur, cliquer sur l'onglet Logs.
Les logs affichent la sortie standard et les erreurs du conteneur en temps réel. Utiliser la barre de recherche pour filtrer et le bouton de téléchargement pour exporter.
Les logs sont particulièrement utiles pour diagnostiquer un conteneur qui redémarre en boucle ou qui échoue à démarrer.
¶ Consulter les statistiques
Depuis la fiche d'un conteneur, cliquer sur l'onglet Stats.
Les graphiques montrent en temps réel :
- CPU usage : pourcentage d'utilisation processeur
- Memory usage : consommation mémoire RAM
- Network I/O : volume de données échangées
Pour un historique des métriques avec alertes, utiliser Grafana et Prometheus (cf. MO-PLT-014, MO-PLT-015).
¶ Redémarrer un conteneur
Depuis la liste des conteneurs, cocher la case du conteneur concerné puis cliquer sur Restart.
Le même bouton est disponible directement sur la fiche détaillée du conteneur.
Le redémarrage provoque une brève interruption du service. Prévenir les utilisateurs si nécessaire. Netbox peut mettre 1 à 2 minutes à redevenir opérationnel après redémarrage.
¶ Arrêter et démarrer un conteneur
- Stop : arrêt propre (signal SIGTERM, puis SIGKILL après délai)
- Kill : arrêt immédiat (SIGKILL) — à utiliser uniquement si Stop échoue
¶ Vérification
- La liste des conteneurs affiche 17 services en vert
- La fiche détaillée d'un conteneur montre ses ports et volumes
- Les logs s'affichent en temps réel
- Les statistiques CPU/RAM sont visibles
- Un redémarrage de conteneur se termine avec le statut healthy
¶ Dépannage
| Problème | Solution |
|---|---|
| Conteneur en rouge | Consulter les logs pour identifier l'erreur de démarrage |
| Healthcheck unhealthy | Le service met du temps à démarrer — patienter puis vérifier les logs |
| Netbox indisponible après restart | Normal — attendre 1-2 min pour les migrations de base de données |
| Stats non disponibles | Le conteneur vient de démarrer — rafraîchir après quelques secondes |
| Impossible de se connecter | Vérifier les identifiants dans Vaultwarden (collection Virtualisation) |
¶ Voir aussi
- MO-PLT-011 — Connexion à Portainer — accès rapide à l'interface de gestion des conteneurs
- MO-PLT-010 — Portail des services — point d'entrée centralisé vers les services
- MO-PLT-008 — Dashboards Grafana — supervision des métriques des conteneurs gérés
- MO-PLT-016 — Sauvegardes ProxMox — sauvegarde du CT hébergeant les conteneurs Docker