Aller au contenu

« Trace install tas - Homepage » : différence entre les versions

De Loic Wiki
← Modification précédente
Daneel (discussion | contributions)
10 modifications
VisuelWikicode
Ajout procédure d'ajout de carte
Daneel (discussion | contributions)
10 modifications
Documentation maintenance conteneurs enrichie: dépendances, volumes, relance et paramètres
 
(Une version intermédiaire par un autre utilisateur non affichée)
Ligne 12 : Ligne 12 :


== Exécution / runtime ==
== Exécution / runtime ==
Quadlet systemd user : /home/loic/.config/containers/systemd/homepage.container ; conteneur systemd-homepage
Quadlet systemd user : /home/loic/.config/containers/systemd/homepage.container ; conteneur systemd-homepage.
 
Paramètres importants à expliquer :
* `Image=ghcr.io/gethomepage/homepage:latest` : image du dashboard
* `AutoUpdate=registry` : activation des mises à jour automatiques via podman auto-update
* montage de `/home/loic/homepage-config` vers `/app/config` : la configuration affichée par Homepage vient de ce dossier hôte
* port local 8097 : point d'écoute local du service derrière Caddy


== Chemins de configuration ==
== Chemins de configuration ==
Ligne 20 : Ligne 26 :
* /home/loic/homepage-config/custom.js
* /home/loic/homepage-config/custom.js
* /home/loic/homepage-config/custom.css
* /home/loic/homepage-config/custom.css
Rôle des fichiers :
* `services.yaml` : cartes, liens, groupes et cibles de supervision / navigation
* `settings.yaml` : options globales de Homepage
* `custom.js` : comportements ou intégrations frontend spécifiques
* `custom.css` : surcharge visuelle locale


== Volumes / persistance ==
== Volumes / persistance ==
* /home/loic/homepage-config -> /app/config
* /home/loic/homepage-config -> /app/config
  * ce bind mount est la source de vérité de la configuration affichée
* pas de base de données dédiée documentée


== Dépendances ==
== Dépendances ==
* Caddy pour l'exposition publique
* Caddy pour l'exposition publique
* liste des services documentée dans services.yaml
* liste des services documentée dans services.yaml
== Procédure de relance / diagnostic ==
Relance standard :
* `systemctl --user restart homepage.service`
Vérifications utiles :
* `systemctl --user status homepage.service --no-pager -l`
* `systemctl --user cat homepage.service`
* `curl -I http://127.0.0.1:8097/`
* vérifier le rendu des cartes après modification de services.yaml
Explication des commandes :
* `systemctl --user cat` : montre l'unité réellement générée par Quadlet.
* `curl -I` : vérifie rapidement la disponibilité HTTP.
* `status --no-pager -l` : utile pour repérer un souci d'image, de bind mount ou de port.


== Remarques ==
== Remarques ==
Image ghcr.io/gethomepage/homepage:latest avec AutoUpdate=registry. HOMEPAGE_ALLOWED_HOSTS configuré. Le dashboard porte les liens publics et internes des services.
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 ==
== Données / emplacements à sauvegarder ==
* Configuration dans /home/loic/homepage-config
* Configuration dans /home/loic/homepage-config
* Pas de base de données applicative dédiée documentée
* quadlet /home/loic/.config/containers/systemd/homepage.container
* pas de base de données applicative dédiée documentée


== Sauvegarde ==
== Sauvegarde ==
Ligne 41 : Ligne 70 :


== Restauration ==
== Restauration ==
* Restaurer /home/loic/homepage-config.
* Restaurer /home/loic/homepage-config et le quadlet homepage.container.
* Relancer le service utilisateur associé à homepage si nécessaire.
* Recharger systemd user si nécessaire puis relancer le service.
* Vérifier ensuite l'accès local/public et la cohérence des liens vers les autres services.


== Maintenance documentaire ==
== 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.
Lors d'un changement de carte, port, image, lien public/interne, HOMEPAGE_ALLOWED_HOSTS ou custom.js/custom.css, mettre à jour cette page et la page centrale trace install tas.


== 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>.''

Dernière version du 12 avril 2026 à 19:02

Trace install tas - Homepage

Rôle

Tableau de bord des services.

Accès

Ports

8097 local, 25697 public via Caddy

Exécution / runtime

Quadlet systemd user : /home/loic/.config/containers/systemd/homepage.container ; conteneur systemd-homepage.

Paramètres importants à expliquer :

  • `Image=ghcr.io/gethomepage/homepage:latest` : image du dashboard
  • `AutoUpdate=registry` : activation des mises à jour automatiques via podman auto-update
  • montage de `/home/loic/homepage-config` vers `/app/config` : la configuration affichée par Homepage vient de ce dossier hôte
  • port local 8097 : point d'écoute local du service derrière Caddy

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

Rôle des fichiers :

  • `services.yaml` : cartes, liens, groupes et cibles de supervision / navigation
  • `settings.yaml` : options globales de Homepage
  • `custom.js` : comportements ou intégrations frontend spécifiques
  • `custom.css` : surcharge visuelle locale

Volumes / persistance

  • /home/loic/homepage-config -> /app/config
 * ce bind mount est la source de vérité de la configuration affichée
  • pas de base de données dédiée documentée

Dépendances

  • Caddy pour l'exposition publique
  • liste des services documentée dans services.yaml

Procédure de relance / diagnostic

Relance standard :

  • `systemctl --user restart homepage.service`

Vérifications utiles :

  • `systemctl --user status homepage.service --no-pager -l`
  • `systemctl --user cat homepage.service`
  • `curl -I http://127.0.0.1:8097/`
  • vérifier le rendu des cartes après modification de services.yaml

Explication des commandes :

  • `systemctl --user cat` : montre l'unité réellement générée par Quadlet.
  • `curl -I` : vérifie rapidement la disponibilité HTTP.
  • `status --no-pager -l` : utile pour repérer un souci d'image, de bind mount ou de port.

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
  • quadlet /home/loic/.config/containers/systemd/homepage.container
  • 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 et le quadlet homepage.container.
  • Recharger systemd user si nécessaire puis relancer le service.
  • Vérifier ensuite l'accès local/public et la cohérence des liens vers les autres services.

Maintenance documentaire

Lors d'un changement de carte, port, image, lien public/interne, HOMEPAGE_ALLOWED_HOSTS 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.

Récupérée de "https://wiki.lololand.org/index.php?title=Trace_install_tas_-_Homepage&oldid=175"