v1.3.3Version stable

Version stable v1.3.3

Interface terminal (Textual / curses)

Consultez conteneurs, mesures et journal dans le terminal avec la commande explicite tui. Cette interface est en lecture seule ; cron et les autres commandes restent non interactifs.

Interface Textual

python -m pip install 'monit-docker[textual]'
monit-docker tui --ui textual

La barre latérale permet de passer des conteneurs au journal, / lance une recherche et le panneau de détail présente la ligne sélectionnée. L’interface reste en lecture seule. Les raccourcis historiques ci-dessous concernent l’interface curses.

La console Textual utilise une palette bleu acier avec DWho 0.3.66 ou une version ultérieure. Les libellés d’état conservent leurs couleurs communes : bleu pour les requêtes acceptées, violet pour le travail en cours, vert pour le succès, ambre pour les avertissements ou l’incertitude, et rouge pour les échecs.

Lancer l’interface

monit-docker tui
monit-docker --name 'web-*' tui --refresh 30
monit-docker -c /etc/monit-docker/monit-docker.yml \
  --audit-file /var/lib/monit-docker/audit/events.jsonl tui

Les options globales précèdent tui. Aucun serveur HTTP n’est nécessaire. L’intervalle va de 5 à 3600 secondes, avec 30 secondes par défaut après chaque collecte. Les contrôles optionnels conservent leurs prérequis. Le socket Docker conserve ses privilèges habituels.

Flèches pour sélectionner, Entrée pour les détails, Tab pour basculer conteneurs/journal, q ou Échap pour revenir/quitter. c et j ouvrent directement chaque vue. Les détails sont un instantané ; revenez à la liste pour actualiser. Le redimensionnement est pris en charge ; les libellés restent en anglais.

Le journal nécessite un chemin explicite avec --audit-file ou sa variable d’environnement. Seule une page récente bornée est affichée. Utilisez audit-export pour l’historique complet. Aucune règle ni action manuelle n’est exécutée par cette interface.

CLI et automatisation

Aucune détection de terminal ne lance curses automatiquement. Seul tui l’importe. Sans TTY, sans TERM ou sans support curses, la commande échoue avec le code 2 avant de créer un client Docker. Ctrl-C retourne 130 ; SIGHUP et SIGTERM restaurent le terminal puis retournent 129 et 143. SIGKILL ne permet aucun nettoyage.

Captures et validation

Ces captures utilisent la véritable interface Textual avec des données synthétiques. Cliquez sur une capture pour ouvrir la galerie. Utilisez les flèches pour naviguer et Échap pour fermer.

Les tests Docker/PTY couvrent navigation, redimensionnement, journal, sortie et restauration du terminal. L’acceptation réelle par SSH de la 1.0.0 a réussi le 28 septembre 2026 : sortie normale, Ctrl-C, refus des pipes et conteneurs protégés inchangés. Une coupure réseau brutale et les sessions interactives prolongées ne sont pas certifiées. Voir la feuille de route.