Trace install tas - Hugo
Trace install tas - Hugo
Rôle
Site statique de documentation Hugo servi sur tas via un conteneur Nginx.
Accès
- Local : http://127.0.0.1:8100
- Public : https://hugo.lololand.org/
Ports
8100 local, 443 public via domaine dédié
Exécution / runtime
Quadlet systemd user : hugo-docs.container ; conteneur hugo-docs ; unité générée : hugo-docs.service
Chemins de configuration
- /home/loic/.config/containers/systemd/hugo-docs.container
- /home/loic/sites/hugo-docs/hugo.toml
- /home/loic/sites/hugo-docs/publish.sh
- /etc/caddy/Caddyfile
Volumes / persistance
- /home/loic/sites/hugo-docs/public:/usr/share/nginx/html:ro
Dépendances
- network-online.target
- Caddy sur le domaine `hugo.lololand.org`
- publication statique générée dans `/home/loic/sites/hugo-docs/public`
Installation
- Image de service : docker.io/library/nginx:alpine
- Déploiement rootless via Quadlet Podman
- Publication locale : 8100 -> 80 dans le conteneur
- Service actif : hugo-docs.service
- Build du site via `publish.sh`, qui lance `docker.io/klakegg/hugo:ext-alpine` dans un conteneur Podman et génère le contenu dans `./public`
Configuration Hugo
- baseURL = https://hugo.lololand.org/
- languageCode = fr-fr
- title = Hugo Docs Tas
- enableRobotsTXT = true
Vérifications post-installation
- `systemctl --user status hugo-docs.service`
- `curl -I http://127.0.0.1:8100`
- vérifier le domaine public `https://hugo.lololand.org/`
Supervision
Le service est déjà supervisé par Uptime Kuma, comme montré par les requêtes User-Agent `Uptime-Kuma/2.2.1` dans les logs du conteneur.
Données / emplacements à sauvegarder
- Sources Hugo : /home/loic/sites/hugo-docs
- Statique publié : /home/loic/sites/hugo-docs/public
- Quadlet : /home/loic/.config/containers/systemd/hugo-docs.container
Sauvegarde
- Sauvegarder /home/loic/sites/hugo-docs
- Sauvegarder le quadlet hugo-docs.container
- Sauvegarder la configuration Caddy associée au domaine `hugo.lololand.org`
Restauration
- Restaurer /home/loic/sites/hugo-docs
- Restaurer le quadlet hugo-docs.container
- Regénérer le site si nécessaire via `publish.sh`
- Relancer `systemctl --user daemon-reload` puis `systemctl --user start hugo-docs.service`
Maintenance documentaire
Lors d'un changement d'image, de domaine, de port, de chemin de build ou de mode de publication, mettre à jour cette page et la trace centrale.
Trace documentaire
Cette page fait partie de Trace install tas.