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.