Aller au contenu

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

De Loic Wiki
Phase 3 : sauvegarde, restauration et persistance
Daneel (discussion | contributions)
Documentation maintenance conteneurs enrichie: dépendances, volumes, relance et paramètres
 
Ligne 12 : Ligne 12 :


== Exécution / runtime ==
== Exécution / runtime ==
Quadlets systemd user : nextcloud.container, nextcloud-db.container, nextcloud-redis.container ; conteneurs systemd-nextcloud, nextcloud-db, nextcloud-redis
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 ==
== Chemins de configuration ==
Ligne 18 : Ligne 23 :
* /home/loic/.config/containers/systemd/nextcloud-db.container
* /home/loic/.config/containers/systemd/nextcloud-db.container
* /home/loic/.config/containers/systemd/nextcloud-redis.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 ==
== Volumes / persistance ==
* nextcloud-html:/var/www/html
* `nextcloud-html:/var/www/html`
* nextcloud-data:/var/www/html/data
  * code applicatif et fichiers web Nextcloud
* nextcloud-db:/var/lib/mysql
* `nextcloud-data:/var/www/html/data`
  * données utilisateurs
* `nextcloud-db:/var/lib/mysql`
  * base MariaDB


== Dépendances ==
== Dépendances ==
Ligne 29 : Ligne 39 :
* réseau nextcloud-net
* réseau nextcloud-net
* Caddy 25696 -> 8096
* 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 ==
== Remarques ==
Trusted domains configurés pour localhost, 127.0.0.1 et lololand.hopto.org. PHP_MEMORY_LIMIT et PHP_UPLOAD_LIMIT à 1024M.
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 ==
== Données / emplacements à sauvegarder ==
Ligne 38 : Ligne 65 :
* Données utilisateurs : volume nextcloud-data
* Données utilisateurs : volume nextcloud-data
* Base MariaDB : volume nextcloud-db
* Base MariaDB : volume nextcloud-db
* Quadlets : nextcloud.container, nextcloud-db.container, nextcloud-redis.container


== Sauvegarde ==
== Sauvegarde ==
* Sauvegarder les volumes nextcloud-html, nextcloud-data et nextcloud-db.
* Sauvegarder les volumes nextcloud-html, nextcloud-data et nextcloud-db.
* Exporter les quadlets nextcloud.container, nextcloud-db.container et nextcloud-redis.container.
* 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 ==
== Restauration ==
* Restaurer les volumes nextcloud-html, nextcloud-data et nextcloud-db.
* 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.
* 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 ==
== Maintenance documentaire ==
Lors d'un changement de base, redis, volumes ou trusted domains, mettre à jour cette page et la trace centrale.
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 ==
== Trace documentaire ==
Cette page fait partie de [[Trace install tas]].
Cette page fait partie de [[Trace install tas]].

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

Trace install tas - Nextcloud

Rôle

Stockage de fichiers et groupware.

Accès

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.