« Trace install tas - Homepage » : différence entre les versions
Phase 3 : sauvegarde, restauration et persistance |
Ajout procédure d'ajout de carte |
||
| Ligne 49 : | Ligne 49 : | ||
== Trace documentaire == | == Trace documentaire == | ||
Cette page fait partie de [[Trace install tas]]. | Cette page fait partie de [[Trace install tas]]. | ||
== Procédure d'ajout d'une carte (avec double lien HTTPS / Interne) == | |||
Pour ajouter un nouveau service au tableau de bord avec les boutons de liens distincts (externe et interne), il faut modifier deux fichiers : | |||
1. '''Déclarer le service''' dans <code>/home/loic/homepage-config/services.yaml</code> : | |||
Ajouter la carte sous le groupe désiré (ex: Infrastructure). Il est indispensable de définir l'attribut <code>id</code>, car c'est lui qui sert de repère au script d'injection. | |||
<pre> | |||
- Mon Service: | |||
id: mon-service | |||
icon: icone.png | |||
href: https://lololand.hopto.org:PORT_EXT | |||
description: Description (Port interne PORT_INT) | |||
siteMonitor: http://10.8.0.1:PORT_INT | |||
</pre> | |||
2. '''Configurer les liens doubles''' dans <code>/home/loic/homepage-config/custom.js</code> : | |||
Éditer le dictionnaire <code>links</code> au début du fichier en y ajoutant la correspondance entre l'<code>id</code> de la carte et ses deux URLs : | |||
<pre> | |||
'mon-service': { external: 'https://lololand.hopto.org:PORT_EXT', internal: 'http://10.8.0.1:PORT_INT' }, | |||
</pre> | |||
3. '''Appliquer les modifications''' : | |||
Redémarrer le conteneur pour que la configuration YAML soit rechargée (le JS et le CSS sont rechargés automatiquement au rafraîchissement de la page par le navigateur) : | |||
<pre> | |||
systemctl --user restart homepage | |||
</pre> | |||
''Note : L'apparence des boutons est gérée globalement par les classes CSS personnalisées (.oc-dual-link, .oc-external, .oc-internal) définies dans <code>/home/loic/homepage-config/custom.css</code>.'' | |||
Version du 22 mars 2026 à 17:07
Trace install tas - Homepage
Rôle
Tableau de bord des services.
Accès
- Local : http://10.8.0.1:8097
- Public : https://lololand.hopto.org:25697
Ports
8097 local, 25697 public via Caddy
Exécution / runtime
Quadlet systemd user : /home/loic/.config/containers/systemd/homepage.container ; conteneur systemd-homepage
Chemins de configuration
- /home/loic/.config/containers/systemd/homepage.container
- /home/loic/homepage-config/services.yaml
- /home/loic/homepage-config/settings.yaml
- /home/loic/homepage-config/custom.js
- /home/loic/homepage-config/custom.css
Volumes / persistance
- /home/loic/homepage-config -> /app/config
Dépendances
- Caddy pour l'exposition publique
- liste des services documentée dans services.yaml
Remarques
Image ghcr.io/gethomepage/homepage:latest avec AutoUpdate=registry. HOMEPAGE_ALLOWED_HOSTS configuré. Le dashboard porte les liens publics et internes des services.
Données / emplacements à sauvegarder
- Configuration dans /home/loic/homepage-config
- Pas de base de données applicative dédiée documentée
Sauvegarde
- Sauvegarder /home/loic/homepage-config (services.yaml, settings.yaml, custom.js, custom.css).
- Exporter aussi le quadlet /home/loic/.config/containers/systemd/homepage.container.
Restauration
- Restaurer /home/loic/homepage-config.
- Relancer le service utilisateur associé à homepage si nécessaire.
Maintenance documentaire
Lors d'un changement de carte, port, lien public/interne ou custom.js/custom.css, mettre à jour cette page et la page centrale trace install tas.
Trace documentaire
Cette page fait partie de Trace install tas.
Procédure d'ajout d'une carte (avec double lien HTTPS / Interne)
Pour ajouter un nouveau service au tableau de bord avec les boutons de liens distincts (externe et interne), il faut modifier deux fichiers :
1. Déclarer le service dans /home/loic/homepage-config/services.yaml :
Ajouter la carte sous le groupe désiré (ex: Infrastructure). Il est indispensable de définir l'attribut id, car c'est lui qui sert de repère au script d'injection.
- Mon Service:
id: mon-service
icon: icone.png
href: https://lololand.hopto.org:PORT_EXT
description: Description (Port interne PORT_INT)
siteMonitor: http://10.8.0.1:PORT_INT
2. Configurer les liens doubles dans /home/loic/homepage-config/custom.js :
Éditer le dictionnaire links au début du fichier en y ajoutant la correspondance entre l'id de la carte et ses deux URLs :
'mon-service': { external: 'https://lololand.hopto.org:PORT_EXT', internal: 'http://10.8.0.1:PORT_INT' },
3. Appliquer les modifications : Redémarrer le conteneur pour que la configuration YAML soit rechargée (le JS et le CSS sont rechargés automatiquement au rafraîchissement de la page par le navigateur) :
systemctl --user restart homepage
Note : L'apparence des boutons est gérée globalement par les classes CSS personnalisées (.oc-dual-link, .oc-external, .oc-internal) définies dans /home/loic/homepage-config/custom.css.