Différences

Ci-dessous, les différences entre deux révisions de la page.

--- amipo_documentation_backup [2020/01/27 14:14] – bigMax
+++ amipo_documentation_backup [2020/01/27 14:45] – bigMax
@@ Ligne 1: / Ligne 1: @@
 <markdown>
-# Documentation des Backup AMIPO
+# Documentation des Sauvegardes AMIPO
-## Scripts de backup
+## Réalisation des Sauvegardes
-Les scripts de backups sont entreposés ici : https://framagit.org/amipo/amipo-admin-code/tree/master/backups
-Actuellement il y a 2 scripts :
-*  backup_nextcloud.sh : effectue le backup de l'instance nextcloud de prod
-*  restore_nextcloud_maintenance.sh : s'assure que l'instance nextcloud de prod n'est plus en mode maintenance
-## Choses backupés
+### Fichiers sauvegardées
 *  Le schéma de la base de données
 *  Les données de la base de données
@@ Ligne 18: / Ligne 14: @@
+### Scripts de Sauvegarde
+Les scripts de backups sont entreposés ici : https://framagit.org/amipo/amipo-admin-code/tree/master/backups
+Actuellement il y a 2 scripts :
+*  backup_nextcloud.sh : effectue le backup de l'instance nextcloud de prod
+*  restore_nextcloud_maintenance.sh : s'assure que l'instance nextcloud de prod n'est plus en mode maintenance
-## Automatisation du Backup
-## Todo Dump
+### Principes de la Sauvegarde
-* Changer le schema de nextcloud (ne pas laisser dans public)
+-  Création d'un nouveau dossier pour recueillir les fichiers à sauvegardées dans le dossier conteneur de backups (/backups/nextcloud sur le FS / pour profiter de ses 20 GB que l'on ne peut pas réduire)
-* Ne dumper que le schema nextcloud
+-  Mise en mode maintenance de l'instance Nextcloud (mode maintenance ON)
-* Dumper le schema au format text et les data au format custom ?
+-  Création du dump de la BD (schéma et data)
-* Changer le tar : faire un cd avant le tar pour ne pas archiver les chemins absolus
+-  Copie du système de fichier "data" de Nextcloud
+-  Remise en route de l'instance Nextcloud (mode maintenance OFF)
+-  Copie des autres systèmes de fichiers (exécutables, logs, config, ...)
+-  Création d'une archive compréssée au format tar.gz à partir du nouveau dossier créé à l'étape 1.
+-  Suppression du dossier créé à l'étape 1.
+-  Vérification et Suppression des anciennes archives vieilles de plus de 7 jours.
-``` psql
-set search_path to public,nextcloud;
-alter schema public rename to nextcloud;
-create schema public;
-alter role nextcloud set search_path to nextcloud;
-```
-``` bash
+### Sécuritées
-pg_dump --username=nextcloud_backup -d nextcloud -h localhost --schema-only -n nextcloud | gzip > $BACKUP_DIR/schema-nextcloud-dump.psql.gz
+-  Actuellement, la suppression des archives n'est effectué que pour les archives vieilles de plus de 7 jours, et si il existe au moins 7 fichiers présent dans le dossier contenant les archives.
-pg_dump --username=nextcloud_backup -d nextcloud -h localhost --data-only -n nextcloud -Fc > $BACKUP_DIR/data-nextcloud-dump.custom
+-  Le script de backup ne plante pas en cas d'erreur de copie de fichiers pour tenter de backup le plus possibles de données. Pour chaque plantage durant une copie, un compteur est incrémenté pour indiquer le nombre d'erreur de copie dans le nom de l'archive et ainsi indiquer la "qualité" du backup.
+-  Si le script de backup vient à planter, on execute alors le script restore_nextcloud_maintenance.sh pour ne pas laisser l'instance nextcloud en mode maintenance.
+-  Un rapport est envoyé par email après chaque déroulement des backups. Ce rapport contient les logs des scripts, et un état du dossier contenant les ancienes archives (nombre d'archives et espace disque restant).
+### Automatisation de la Sauvegarde
+*  Le backup est automatisé par un cronjob de l'utilisateur www-data. Pour le voir : `crontab -l -u www-data`. Cela devrait être :
+``` cron
+# Nextcloud backup
+  2  *  *  * ( export PGPASSWORD="XXXXX"; /var/amipo-admin-code/backups/backup_nextcloud.sh 2>&1 || /var/amipo-admin-code/backups/restore_nextcloud_maintenance.sh 2>&1 ) | mailx -s "[AMIPO Admin] Sorties de backup nocturne de Gits." admin
 ```
+*  Le cronjob est exécuté chaque nuit à 02h00.
+*  Les sorties d'erreur et standard du backup sont envoyés par email à l'alias admin qui est configuré dans /etc/aliases
+### Sauvegarde de la base de données
+*  Les sauvegardes de la base de données sont séparées en 2 fichiers : la structure et les données.
+*  La sauvegarde de la structure des données est sauvegardé au format texte compressé (.psql.gz).
+*  Les données sont sauvegardé au format custom postgres déjà compréssé (.custom), cela permet une restauration plus rapide.
+*  On ne sauvegarde que le contenu du schéma "nextcloud".
+*  Un utilisateur spécifique dans la BD réalise les sauvegardes : "nextcloud_backup" avec des privilèges minimaux.
-## Restauration d'un backup
+## Restauration d'une Sauvegarde
 ### Création de la BD dans lequel sera effectué la restauration