Intégrations

Mises à jour des conteneurs (What's Up Docker)

Voir quels conteneurs ont une image plus récente, avec What's Up Docker.

Le widget Mises à jour des conteneurs liste les conteneurs dont l’image a une version plus récente, de l’étiquette actuelle à la nouvelle, les plus grands sauts d’abord (majeure, mineure, correctif), et les conteneurs reconstruits sous la même étiquette (un nouveau digest). Le nom du conteneur mène à ses notes de version quand le registre les donne.

NasDash lit ce que What's Up Docker (WUD) a trouvé ; un administrateur peut lancer une mise à jour depuis le widget, par WUD.

Le connecter

  1. Lancez What's Up Docker à côté de vos conteneurs ; son API écoute sur le port 3000.
  2. Dans NasDash, ouvrez Paramètres → Intégrations → Mises à jour des conteneurs → What's Up Docker.
  3. Saisissez son adresse, par exemple http://nas.example.com:3000. Si l’authentification basique de WUD est activée, choisissez Utilisateur et mot de passe et saisissez-les.
  4. Enregistrez et testez la connexion, puis ajoutez le widget Mises à jour des conteneurs et choisissez la connexion.

Ce qu’il lit

GET /api/containers, toutes les cinq minutes, partagé par tous les widgets de la connexion. Le widget indique combien de conteneurs WUD surveille, les mises à jour, et combien de conteneurs WUD n’a pas pu vérifier (un registre privé sans identifiants, par exemple). Seuls les liens http et https sont gardés.

Mettre à jour depuis le widget

Les administrateurs disposent d’un bouton de mise à jour sur chaque conteneur, et de Tout mettre à jour quand plusieurs peuvent l’être. Il fait ce que fait le bouton de WUD : il lance le déclencheur Docker ou Docker Compose du conteneur, qui télécharge la nouvelle image et recrée le conteneur, puis demande à WUD de le vérifier à nouveau. La mise à jour tourne en arrière-plan ; le widget affiche Mise à jour…, puis À jour pendant deux minutes, ou Échec avec la raison.

  • WUD doit avoir un déclencheur docker ou dockercompose pour le conteneur (WUD_TRIGGER_DOCKER_… ou WUD_TRIGGER_DOCKERCOMPOSE_…). Sans lui, aucun bouton n’est proposé.
  • Si l’authentification de WUD est activée, le compte doit avoir le rôle rw ou admin ; un compte en lecture seule liste seulement les mises à jour.
  • Une confirmation, active par défaut, indique la version qui sera téléchargée et prévient pour les versions majeures. Demander avant de mettre à jour, dans les réglages du widget, la désactive.
  • Le conteneur s’arrête un instant pendant qu’il est recréé. Mettre à jour NasDash ou WUD eux-mêmes depuis le widget redémarre ce qui les fait tourner.

Affichage et accès

Le nombre de conteneurs affichés (3 à 40) se règle au curseur dans les réglages du widget ; la ligne sous la liste affiche les autres, puis les masque à nouveau. Les images reconstruites (même étiquette, nouveau digest) et les icônes des applications peuvent être masquées ; les icônes viennent de la collection dashboard-icons, chargée par le navigateur. Les lecteurs ont besoin de la permission Conteneurs Docker, comme pour la liste des conteneurs. La démo publique montre des mises à jour fictives.