117 lines
4.7 KiB
Markdown
117 lines
4.7 KiB
Markdown
# BorgBackup
|
|
<div align="center">
|
|
<img src="https://asciinema.org/a/133292.svg" />
|
|
</div>
|
|
|
|
## Utilizzo
|
|
[Sito ufficiale](https://www.borgbackup.org/) - [Repo (Github)](https://github.com/borgbackup/borg) - [Demo (Video)](https://asciinema.org/a/133292)
|
|
|
|
BorgBackup è un software per effettuare backup da terminale ([e non solo](https://github.com/borgbackup/community#graphical-front-ends)):
|
|
- [Deduplicazione](https://en.wikipedia.org/wiki/Data_deduplication) dei file invece del classico *"copia/incolla"*
|
|
- Possibilità di crittografia (AES 256-bit) e verifica dei dati (HMAC-SHA256)
|
|
- Possibilità di offuscare i dati, in modo da rendere i backup più *"sicuri"*
|
|
- Possibilità di comprimere i dati usando gli algoritmi più conosciuti (LZ4, zlib, LZMA, zstd)
|
|
- Possibilità di personalizzare il numero di backup da mantenere (giornalieri, settimanali, mensili, annuali)
|
|
- Ottimo supporto della [comnunità](https://github.com/borgbackup/community)
|
|
|
|
## Struttura file e cartelle
|
|
```
|
|
/home/
|
|
├── borg/
|
|
│ ├── docker_backup/
|
|
│ ├── borg_backup.sh
|
|
│ └── borg_backup.log
|
|
│
|
|
└── docker/
|
|
├── container #1
|
|
├── container #2
|
|
├── ...
|
|
```
|
|
|
|
* `docker_backup` - cartella dove vengono salvati i backup da borg
|
|
* `borg_backup.sh` - bash script per effettuare i backup
|
|
* `borg_backup.log` - file di log con le date dei backup
|
|
|
|
**N.B. Tutti i file e le cartelle devono essere creati a mano.**
|
|
|
|
## Setup
|
|
### Installare BorgBackup
|
|
Normalmente si trova già in molti [package manager](https://borgbackup.readthedocs.io/en/latest/installation.html#distribution-package) delle distro linux/unix più usate.
|
|
|
|
### Creare e inizializzare una nuova cartella per i backup
|
|
1. `mkdir /home/borg`</br>
|
|
2. `borg init --encryption=none /home/borg/docker_backup`
|
|
|
|
Notare l'assenza dell'uso del comando `sudo`. In caso di problemi con i permessi di scrittura/lettura usatelo.
|
|
|
|
### Bash script
|
|
Lo script deve avere la flag **executable (eseguibile)**, nel caso lanciate il comando `chmod +x borg_backup.sh` tanto è indolore.
|
|
|
|
`borg_backup.sh`
|
|
```bash
|
|
#!/bin/bash
|
|
|
|
# LO SCRIPT MANTIENE IL SEGUENTE NUMERO DI BACKUP:
|
|
# GIORNALIERI = 7 aka 1 settimana
|
|
# SETTIMANALI = 4 aka 1 mese
|
|
# MENSILI = 6 aka 6 mesi
|
|
# ANNUALI = 0
|
|
|
|
# -----------------------------------------------
|
|
|
|
DIRECTORIES='/home/docker'
|
|
BACKUP='/home/borg/docker_backup'
|
|
LOGFILE='/home/borg/borg_backup.log'
|
|
|
|
NOW=$(date +"%Y-%m-%d | %H:%M | ")
|
|
echo "$NOW - Avvio del Backup e della Pulizia" >> $LOGFILE
|
|
|
|
# CREA NUOVI BACKUP NELLA CARTELLA IMPOSTATA
|
|
borg create \
|
|
$BACKUP::'{now:%s}' \
|
|
$DIRECTORIES \
|
|
\
|
|
--compression zstd \
|
|
--one-file-system \
|
|
--exclude-caches \
|
|
--exclude-if-present '.nobackup' \
|
|
|
|
# CANCELLA I VECCHI BACKUP, SE NECESSARIO
|
|
borg prune -v --list $BACKUP \
|
|
--keep-daily=7 \
|
|
--keep-weekly=4 \
|
|
--keep-monthly=6 \
|
|
--keep-yearly=0 \
|
|
|
|
echo "$NOW Done" >> $LOGFILE
|
|
echo '------------------------------' >> $LOGFILE
|
|
|
|
```
|
|
|
|
### Avvio manuale
|
|
1. lanciate il seguente comando `sh ./borg_backup.sh`
|
|
2. alla domanda: `Attempting to access a previously unknown unencrypted repository`
|
|
3. rispondete con `yes`
|
|
|
|
### Avvio automatizzato
|
|
Il metodo migliore è usare [cron](https://en.wikipedia.org/wiki/Cron), che sicuramente è già pre-installato nella vostra distro linux.
|
|
|
|
Create un cronjob che faccia partire lo script [alle 03:00 di notte](https://crontab.guru/#0_03_*_*_*):
|
|
1. lanciate il seguente comando `crontab -e`
|
|
2. poi scrivere quanto segue `0 3 * * * /home/borg/borg_backup.sh`
|
|
|
|
Comandi utili:
|
|
* `systemctl status cron` - controlla se il servizio è attivo e/o installato
|
|
* `crontab -l` - lista degli attuali cronjob
|
|
* `journalctl -u cron` - cronologia di cron
|
|
|
|
## Controllare la cartella dei backup
|
|
1. entrare nella cartella dei backup `cd /home/borg/docker_backup/`
|
|
2. scrivere `borg list .` per ottenere la lista dei backup effettuati
|
|
3. scegliere il backup che vi interessa usando una [data epoch](https://en.wikipedia.org/wiki/Unix_time), esempio 1588986941
|
|
4. montare il backup su una cartella temporanea `borg mount .::1588986941 /mnt/temp`
|
|
5. controllare il contenuto della cartella e fate quello necessario
|
|
6. smontare la cartella temporanea del backup `borg umount /mnt/temp`
|
|
|
|
**N.B. Di tanto in tanto, controllare i backup effettuati per evitare brutte sorprese!!!**
|