Trace install tas - Nextcloud

Trace install tas - Nextcloud

Rôle

Stockage de fichiers et groupware.

Accès

• Local : http://10.8.0.1:8096
• Public : https://lololand.hopto.org:25696

Ports

8096 local, 25696 public

Exécution / runtime

Quadlets systemd user : nextcloud.container, nextcloud-db.container, nextcloud-redis.container ; conteneurs systemd-nextcloud, nextcloud-db, nextcloud-redis.

Rôle des services :

• `nextcloud.service` : application Nextcloud / PHP / Apache ou équivalent selon l'image retenue
• `nextcloud-db.service` : MariaDB de l'instance
• `nextcloud-redis.service` : cache / verrouillage / broker léger pour améliorer la stabilité applicative

Chemins de configuration

• /home/loic/.config/containers/systemd/nextcloud.container
• /home/loic/.config/containers/systemd/nextcloud-db.container
• /home/loic/.config/containers/systemd/nextcloud-redis.container

Ce sont les sources de vérité de lancement. Toute évolution de ports, volumes, réseau ou variables doit passer par ces fichiers.

Volumes / persistance

• `nextcloud-html:/var/www/html`

 * code applicatif et fichiers web Nextcloud

• `nextcloud-data:/var/www/html/data`

 * données utilisateurs

• `nextcloud-db:/var/lib/mysql`

 * base MariaDB

Dépendances

• nextcloud-db.service
• nextcloud-redis.service
• réseau nextcloud-net
• Caddy 25696 -> 8096

Procédure de relance / diagnostic

Ordre recommandé :

• base MariaDB
• redis
• application Nextcloud

Commandes utiles :

• `systemctl --user restart nextcloud-db.service`
• `systemctl --user restart nextcloud-redis.service`
• `systemctl --user restart nextcloud.service`
• `systemctl --user status nextcloud.service --no-pager -l`
• `curl -I http://127.0.0.1:8096/`

Explication :

• relancer la base avant l'application évite une partie des faux diagnostics applicatifs
• `status --no-pager -l` permet de voir rapidement si le problème vient d'un volume, d'une image ou d'une dépendance non disponible
• `curl -I` permet de distinguer une panne HTTP d'un simple souci de proxy public

Remarques

Trusted domains configurés pour localhost, 127.0.0.1 et lololand.hopto.org. PHP_MEMORY_LIMIT et PHP_UPLOAD_LIMIT à 1024M.

Données / emplacements à sauvegarder

• HTML applicatif : volume nextcloud-html
• Données utilisateurs : volume nextcloud-data
• Base MariaDB : volume nextcloud-db
• Quadlets : nextcloud.container, nextcloud-db.container, nextcloud-redis.container

Sauvegarde

• Sauvegarder les volumes nextcloud-html, nextcloud-data et nextcloud-db.
• Exporter les quadlets nextcloud.container, nextcloud-db.container et nextcloud-redis.container.
• Conserver une trace des trusted domains et des limites PHP si elles sont définies dans les quadlets ou variables d'environnement.

Restauration

• Restaurer les volumes nextcloud-html, nextcloud-data et nextcloud-db.
• Restaurer les quadlets.
• Recharger systemd user si nécessaire.
• Redémarrer les services nextcloud-db, nextcloud-redis puis nextcloud.
• Vérifier ensuite l'accès HTTP local, la connexion DB et les trusted domains.

Maintenance documentaire

Lors d'un changement de base, redis, volumes, réseau, trusted domains, limites PHP ou image, mettre à jour cette page et la trace centrale.

Trace documentaire

Cette page fait partie de Trace install tas.