Installation conteneurisée standard sur tas

Installation conteneurisée standard sur tas

Règle à retenir

Pour toute nouvelle installation, privilégier :

• des images Podman
• gérées par des services
• et mises à jour régulièrement

Objectifs :

• démarrage automatique
• exploitation claire
• mises à jour traçables
• rollback plus simple

Modèle recommandé

1. Service applicatif

• un conteneur principal par application
• un port local dédié
• un volume persistant pour les données

2. Dépendances séparées

• base de données dans un conteneur dédié
• cache/recherche dans des conteneurs dédiés si nécessaire
• volumes séparés pour faciliter la sauvegarde

3. Exposition réseau

• application exposée localement sur un port local dédié
• publication externe via Caddy
• URL publique stable sous la forme https://lololand.hopto.org:<port>

4. Mises à jour

• utiliser des images maintenues
• éviter les bricolages non versionnés dans les conteneurs
• préférer une configuration ré-écrivable depuis des fichiers

Configuration Caddy à ajouter

Pour un service local sur le port 8098 exposé publiquement sur 25698 :

# MediaWiki
https://lololand.hopto.org:25698 {
    import common_acme
    reverse_proxy 127.0.0.1:8098
}

État actuel

Cette route existe déjà actuellement dans /etc/caddy/Caddyfile.

Carte Homepage correspondante

- MediaWiki:
    id: mediawiki
    icon: mediawiki.png
    href: https://lololand.hopto.org:25698
    description: Wiki collaboratif
    siteMonitor: http://10.8.0.1:8098

Recommandations d'installation

• faire un backup avant modification des fichiers critiques
• documenter les ports locaux et publics
• nommer clairement les conteneurs
• stocker la stack dans un dossier dédié
• conserver un fichier .env lisible
• documenter les extensions/plugins ajoutés

Exemple appliqué : MediaWiki

• Local : http://10.8.0.1:8098
• Public : https://lololand.hopto.org:25698
• Conteneurs : mediawiki-app, mediawiki-db
• Dossier : /home/loic/mediawiki\n\n== Règles d'exploitation actuelles — 2026-07-25 ==

Runtime

• Les conteneurs persistants sont définis dans /home/loic/.config/containers/systemd/.
• Un fichier *.container devient une unité *.service via Quadlet.
• Les réseaux dédiés sont définis par des fichiers *.network.
• Après modification : systemctl --user daemon-reload, puis relancer uniquement l'unité concernée.
• Vérifier avec systemctl --user status SERVICE.service et podman ps.

Mise à jour

• Les unités utilisant AutoUpdate=registry suivent le registre configuré.
• Pour une mise à jour contrôlée, préférer un tag versionné et conserver une copie du Quadlet avant modification.
• Après mise à jour, tester le service local puis le domaine Caddy.

Ports réservés

• Ne pas publier de conteneur sur les ports hôte 8080 ou 8081.
• Dependency-Track utilise désormais 8103:8080 pour le frontend et 8092:8080 pour l'API.
• MediaWiki utilise 8098:80 et Immich 8088:2283.