Sauvegarde - XWiki

Le dépôt est chiffré avec cette phrase secrète. Sans elle, les sauvegardes sont illisibles, même pour leur propriétaire : en conserver une copie dans le gestionnaire de mots de passe, jamais uniquement sur le serveur.

89

90

91

== Restaurer si le serveur principal est perdu ==

92

93

Le dépôt peut s'ouvrir directement sur le Raspberry Pi, où Plakar est aussi installé, avec la phrase secrète récupérée dans le gestionnaire de mots de passe :

94

95

96

sudo plakar at <CHEMIN_DEPOT> ls

97

sudo plakar at <CHEMIN_DEPOT> restore -to /tmp/restore <ID_INSTANTANE>

98

99

100

Plakar demande alors la phrase secrète de façon interactive.

== Script ==

#!/bin/bash

set -euo pipefail

umask 077

# Alertes Telegram

. /root/.backup-telegram

111

notifier() {

112

curl -fsS -m 10 "https://api.telegram.org/bot$TG_TOKEN/sendMessage" \

113

-d chat_id="$TG_CHAT" --data-urlencode text="$1" >/dev/null || true

114

}

115

attention() { echo "ATTENTION: $1" >&2; notifier "⚠️ Sauvegarde : $1"; }

116

trap 'notifier "❌ Sauvegarde interrompue à la ligne $LINENO"' ERR

117

118

REPO="sftp://<UTILISATEUR>@<HOTE_DEPOT>:<CHEMIN_DEPOT>"

119

KEYFILE="<FICHIER_PHRASE_SECRETE>"

120

DUMPS="<APPDATA>/dumps"

121

mkdir -p "$DUMPS"

122

123

# Dumps MariaDB/MySQL

124

for c in xwiki-mariadb-db passbolt-db castopod-test-db; do

125

docker exec "$c" sh -c 'exec mysqldump -uroot -p"${MYSQL_ROOT_PASSWORD:-$MARIADB_ROOT_PASSWORD}" --all-databases' \

126

> "$DUMPS/$c.sql" 2>/dev/null \

127

|| docker exec "$c" sh -c 'exec mariadb-dump -uroot -p"${MYSQL_ROOT_PASSWORD:-$MARIADB_ROOT_PASSWORD}" --all-databases' \

128

> "$DUMPS/$c.sql" 2>/dev/null \

129

|| attention "dump $c échoué"

130

done

131

132

# Nextcloud : dump via l'utilisateur applicatif

133

docker exec "$(docker ps -q -f name=nextcloud_db)" sh -c 'exec mariadb-dump -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" "$MYSQL_DATABASE"' \

134

> "$DUMPS/nextcloud.sql" 2>/dev/null \

135

|| attention "dump nextcloud échoué"

136

137

# Dumps PostgreSQL

138

for c in joplin-db flus-db wallabag-db immich_postgres vikunja-db jellystat-db n8n-postgres dawarich_db; do

139

docker exec "$c" sh -c 'exec pg_dumpall -U "$POSTGRES_USER"' \

140

> "$DUMPS/$c.sql" 2>/dev/null \

141

|| attention "dump $c échoué"

142

done

143

144

# Sauvegarde, sans core dumps, binlogs ni fichiers bruts des bases

145

plakar --concurrency 2 -keyfile "$KEYFILE" at "$REPO" backup \

146

-ignore "**/joplin-app/core.*" \

147

-ignore "**/Nextcloud/DB/**" \

148

-ignore "**/log/mysql/**" \

149

-ignore "**/xwiki/mariadb/**" \

150

-ignore "**/store.bak.*/**" \

151

<APPDATA> \

152

<BIBLIOTHEQUE_IMMICH> \

153

<CONTENU_JOPLIN>

154

155

# Rétention : 30 jours glissants

156

plakar -keyfile "$KEYFILE" at "$REPO" rm -before 30d -apply

157

notifier "✅ Sauvegarde terminée"

Tâche cron, ##/etc/cron.d/backup-plakar## :

162

163

164

30 3 * * * root /root/backup-plakar.sh >> /var/log/backup-plakar.log 2>&1

165

166

167

== Ajouter une base ==

168

169

Ajouter le nom du conteneur dans la boucle MariaDB ou PostgreSQL du script, puis exclure ses fichiers bruts avec un ##-ignore## s'ils se trouvent dans ##<APPDATA>##.

== Vérifier ==

tail -n 50 /var/log/backup-plakar.log

175

grep ATTENTION /var/log/backup-plakar.log

176

sudo plakar -keyfile <FICHIER_PHRASE_SECRETE> at <REPO> ls

== Restaurer ==

Restaurer un instantané complet dans un dossier temporaire :

182

183

184

sudo plakar -keyfile <FICHIER_PHRASE_SECRETE> at <REPO> restore -to /tmp/restore <ID_INSTANTANE>

185

186

187

Réinjecter une base MariaDB :

188

189

190

docker exec -i <CONTENEUR> sh -c 'exec mariadb -uroot -p"$MARIADB_ROOT_PASSWORD"' < /tmp/restore/<CHEMIN>/dumps/<CONTENEUR>.sql

191

192

193

Réinjecter une base PostgreSQL (dump complet de l'instance) :

194

195

196

docker exec -i <CONTENEUR> sh -c 'exec psql -U "$POSTGRES_USER" -d postgres' < /tmp/restore/<CHEMIN>/dumps/<CONTENEUR>.sql

Une sauvegarde qui n'a jamais été restaurée n'est pas une sauvegarde vérifiée. Faire un essai de restauration de temps en temps, dans un dossier temporaire.

201

202

203

== Incidents connus ==

204

205

|=Symptôme|=Cause|=Solution

206

|Verrou restant après une exécution interrompue|Le processus a été coupé en cours|Supprimer le verrou orphelin avant de relancer

207

|Avertissements VFS|Cache local incohérent|Vider ##~~/.cache/plakar## de root

208

|Transfert coupé (EOF SFTP) sur de gros fichiers|Lien Wi-Fi du dépôt instable|Économie d'énergie Wi-Fi désactivée sur le Pi ; passer à ##~-~-concurrency 1## pour une première sauvegarde volumineuse

209

|Déconnexion du SSD pendant la sauvegarde|Pont USB en mode UAS|Voir la configuration SSD sur la page [[Raspberry Pi>>Wiki Batcave John.Infrastructure.RaspberryPi.WebHome]]

Code source wiki de Sauvegarde