Aller au contenu
← Tous les articles
Présentation du projet

DasherControl : un tableau de bord homelab organisé en espaces de travail

Écouter en version balado

DasherControl : un seul tableau de bord pour son homelab · 2:03 · voix synthétiques, script rédigé avec l’IA

Transcription

Sylvie : Douze onglets ouverts, un par service du homelab, et impossible de retrouver le bon. C'est pour ça qu'Antoine a créé DasherControl.

Thierry : Un tableau de bord, donc ?

Sylvie : Un tableau de bord organisé en espaces de travail. Un espace, c'est comme un bureau : on y dispose des applets, c'est-à-dire des favoris et des applications intégrées, avec quelques commandes Docker à portée de main.

Thierry : Il est fait avec quoi ?

Sylvie : Vue côté interface, et Rust avec Rocket et Diesel côté serveur. Derrière le tableau de bord, il y a deux parcours bien séparés. Sauvegarder une disposition passe par les routes des espaces vers la base de données.

Thierry : Et le deuxième ?

Sylvie : Les actions sur les conteneurs. Quand on redémarre un conteneur, la demande passe par un adaptateur nommé Shiplift jusqu'à Docker. La base de données n'exécute jamais d'action Docker, et une applet n'est pas un conteneur. Cette séparation rend la conception facile à comprendre.

Thierry : Comment un espace sait-il à qui il appartient ?

Sylvie : Chaque espace a un propriétaire. La route lit l'identifiant du compte dans un jeton, liste les espaces de cette personne, et vérifie le propriétaire avant de renvoyer les applets. Une disposition sauvegardée appartient donc à un utilisateur, et chaque applet à un espace.

Thierry : Et côté Docker ?

Sylvie : Un fichier regroupe les appels Shiplift : lister les conteneurs et les images, télécharger des images, créer, arrêter ou redémarrer des conteneurs. Les opérations Docker restent ainsi à part du modèle des espaces.

Thierry : On peut intégrer n'importe quelle application web dans une applet ?

Sylvie : Beaucoup, via des iframes. Certaines applications limitent l'intégration, alors un simple lien externe est prévu à côté.

Thierry : Il y a une démo ?

Sylvie : Oui. La page propose une capture et l'enregistrement d'origine avec les espaces et les applets en action. La note d'architecture et le code sont liés dans l'article.

Capture du tableau de bord DasherControl issue du dépôt du projet
Table des matières

J’ai commencé DasherControl parce que mes services homelab finissaient dispersés dans mes onglets. L’idée était de regrouper des applets dans un espace de travail : favoris et applications intégrées au tableau de bord, avec quelques commandes Docker à proximité.

1. Deux parcours derrière le même tableau de bord

flowchart LR
  Dashboard["Tableau de bord"] --> Workspace["Enregistrer un espace"]
  Workspace --> Database[("Données des espaces")]
  Dashboard --> Action["Action sur un conteneur"]
  Action --> Docker["Docker via Shiplift"]

Sauvegarder une disposition passe par les routes des espaces et les données persistantes. Redémarrer un conteneur passe par l’adaptateur Shiplift vers Docker. PostgreSQL n’exécute pas l’action Docker et une applet n’est pas un conteneur. Cette séparation aide à comprendre les permissions et les erreurs.

Suivre les routes et la frontière Docker dans la note d’architecture.

2. Un espace de travail a un propriétaire

Le frontend utilise Vue et le backend repose sur Rust, Rocket et Diesel. Dans src/workspaces/handler.rs[1], la liste des espaces utilise l’identifiant du compte présent dans un jeton. La route qui retourne les applets vérifie le propriétaire de l’espace avant de renvoyer son contenu.

La création d’un espace avec ses applets récupère également cet identifiant depuis le jeton. C’est le modèle prévu : une disposition sauvegardée appartient à un utilisateur, et chaque applet appartient à un espace.

Le fichier contient aussi d’anciennes routes de création et de suppression avec des vérifications différentes. Il faudrait revoir les autorisations de chaque opération avant d’en faire un service partagé. Cet article décrit une expérience, sans constituer un audit d’un système déployé.

3. Docker a sa propre interface

src/containers/docker.rs[2] regroupe les appels Shiplift pour lister les conteneurs et les images, télécharger des images, créer des conteneurs, les arrêter ou les redémarrer. Les opérations Docker restent ainsi séparées du modèle des espaces de travail.

Le code révèle aussi un problème d’interface : les fonctions de liste retournent un vecteur vide après une erreur Docker. Un écran vide peut donc signifier qu’aucun conteneur n’existe ou que le service est inaccessible. Dans une nouvelle version, je distinguerais ces deux états à l’écran.

4. Ce que le navigateur accepte d’intégrer

Le README mentionne des échecs de connexion dans les iframes. Certaines applications interdisent l’intégration, et l’authentification dans un cadre peut différer de celle d’un onglet normal. Le tableau de bord doit proposer un lien externe pour ces services.

Ce projet est ancien. La capture et le GIF optionnel conservent son interface d’époque ; ils ne démontrent pas sa compatibilité avec les dépendances actuelles.

Lire le GIF de démonstration d’origineEnregistrement de DasherControl montrant les espaces de travail et les applets

Voir le code et le README d’origine[3]. Les deux illustrations viennent de son dossier images.

Références

  1. antoinebou12. (). src/workspaces/handler.rs. [Source file or documentation] github.com.
  2. antoinebou12. (). src/containers/docker.rs. [Source file or documentation] github.com.
  3. antoinebou12. (). DasherControl. [Software repository] github.com.

Les références utilisent la date de publication de cet article.