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 ==

{{code language="bash"}}#!/bin/bash

set -euo pipefail

umask 077

# Alertes Telegram

. /root/.backup-telegram

110

notifier() {

111

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

112

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

113

}

114

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

115

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

116

117

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

118

KEYFILE="<FICHIER_PHRASE_SECRETE>"

119

DUMPS="<APPDATA>/dumps"

120

mkdir -p "$DUMPS"

121

122

# Dumps MariaDB/MySQL

123

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

124

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

125

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

126

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

127

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

128

|| attention "dump $c échoué"

129

done

130

131

# Nextcloud : dump via l'utilisateur applicatif

132

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

133

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

134

|| attention "dump nextcloud échoué"

135

136

# Dumps PostgreSQL

137

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

138

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

139

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

140

|| attention "dump $c échoué"

141

done

142

143

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

144

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

145

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

146

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

147

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

148

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

149

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

150

<APPDATA> \

151

<BIBLIOTHEQUE_IMMICH> \

152

<CONTENU_JOPLIN>

153

154

# Rétention : 30 jours glissants

155

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

156

notifier "✅ Sauvegarde terminée"{{/code}}

157

~{~{/code}}

158

159

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

160

161

162

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

== Alertes ==

Le script envoie un message Telegram à chaque exécution :

168

169

|=Message|=Signification

170

|✅ Sauvegarde terminée|Tout s'est bien passé

171

|⚠️ Sauvegarde : dump … échoué|Un dump de base a échoué, la sauvegarde a continué sans lui

172

|❌ Sauvegarde interrompue à la ligne …|Erreur bloquante, la sauvegarde n'a pas eu lieu

173

174

Si aucun message n'arrive un matin, le script n'a pas démarré (serveur éteint, tâche cron cassée).

175

176

Jeton du bot et identifiant du groupe dans ##/root/.backup-telegram##, lisible par root seul :

177

178

179

TG_TOKEN="<JETON_BOT>"

180

TG_CHAT="<ID_GROUPE>"

Dans le script, chaque ligne continuée doit se terminer par ##\## sans rien après, pas même un espace. Une barre oblique inverse suivie d'un espace ne continue plus la ligne : c'est ce qui a interrompu plusieurs sauvegardes en septembre 2026. Contrôle après toute modification : ##sudo bash -n /root/backup-plakar.sh##, et ##cat -A## pour voir les caractères invisibles en fin de ligne.

185

186

187

== Ajouter une base ==

188

189

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

195

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

196

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

== Restaurer ==

Restaurer un instantané complet dans un dossier temporaire :

202

203

204

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

205

206

207

Réinjecter une base MariaDB :

208

209

210

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

211

212

213

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

214

215

216

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.

221

222

223

== Incidents connus ==

224

225

|=Symptôme|=Cause|=Solution

226

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

227

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

228

|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

229

|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

Applications

Navigation

FluxRSS

Besoin d'aide ?