initial move to resticprofile

This commit is contained in:
John Lancaster
2024-06-15 14:12:15 -05:00
parent 08e02d12db
commit 18b53fe103
5 changed files with 88 additions and 17 deletions

3
.gitignore vendored
View File

@@ -1,3 +1,6 @@
__pycache__ __pycache__
*.egg-info *.egg-info
build/ build/
.env
key

View File

@@ -5,17 +5,32 @@ Purpose:
- Wrap `restic` with the ability to start/stop Docker containers - Wrap `restic` with the ability to start/stop Docker containers
- Send updates to Loki server - Send updates to Loki server
## Environment Variables ## Installation
Recommended to put these in the relevant `~/.bashrc` file ### Environment Variables
| Env Variable | Description | Put these in `./restic-scripts/.env`, which is on the `.gitignore` list.
|---------------------|--------------------------------------------------------------------------------------------|
| `HOSTNAME` | Network hostname of where the backup is running. Used to tag the backups in restic | | Env Variable | Description |
| `BACKUP_DIR` | Directory to back up | | ------------------- | --------------------------------------------------------------------------------------- |
| `RESTIC_REPOSITORY` | Directory for the restic repository. This is usually on a mount point made from Proxmox | | `BACKUP_DIR` | Directory to back up |
| `RESTIC_PASSWORD` | Password for the restic repository | | `RESTIC_REPOSITORY` | Directory for the restic repository. This is usually on a mount point made from Proxmox |
| `LOKI_URL` | Push URL for Loki. Should include the port and end with something like `/loki/api/v1/push` | | `TZ` | Set to modify the timezone shown in the scheduler |
### Include in Repo
From a parent repo, add this one as a submodule:
```shell
git submodule add https://gitea.john-stream.com/john/restic-scripts
```
Then add this to the `docker-compose.yml` file of the parent.
```yaml
include:
- restic-scripts/docker-compose.yml
```
## Loki Updates ## Loki Updates
@@ -28,16 +43,14 @@ Updates sent to Loki will have the following labels:
## Usage ## Usage
```shell Check snapshots
python -m restic.snapshots
```
To stop docker containers before the backup and start them again afterwards, use the `--project` and `--services` flags.
```shell ```shell
python -m restic.backup --tag manual --project joplin --services app,db docker compose exec backup resticprofile snapshots
``` ```
Dry-run a backup
```shell ```shell
python -m restic.prune docker compose exec backup resticprofile --dry-run backup
``` ```

16
docker-compose.yml Normal file
View File

@@ -0,0 +1,16 @@
services:
backup:
image: creativeprojects/resticprofile
entrypoint: '/bin/sh'
command:
- -c
- 'crond && resticprofile-schedule.sh && inotifyd resticprofile-schedule.sh /etc/resticprofile:w'
env_file:
- .env
hostname: ${HOSTNAME}
volumes:
- ./restic-profile.yaml:/etc/resticprofile/profiles.yaml:ro
- ./resticprofile-schedule.sh:/usr/local/bin/resticprofile-schedule.sh:ro
- ./key:/etc/resticprofile/key:ro
- ${BACKUP_DIR}:${BACKUP_DIR}:ro
- ${RESTIC_REPOSITORY}:${RESTIC_REPOSITORY}:rw

30
restic-profile.yaml Normal file
View File

@@ -0,0 +1,30 @@
global:
scheduler: crond
default:
base-dir: ${BACKUP_DIR}
repository: local:${RESTIC_REPOSITORY}
password-file: key
initialize: true
backup:
source: ./
exclude-caches: true
one-file-system: true
schedule: "*:00"
schedule-permission: system
check-before: true
tag:
- resticprofile
retention:
after-backup: true
before-backup: false
prune: true
tag:
- resticprofile
keep-within: 3h
keep-hourly: 72
keep-daily: 14
keep-weekly: 8
keep-monthly: 6

9
resticprofile-schedule.sh Executable file
View File

@@ -0,0 +1,9 @@
#!/bin/sh
set -e
resticprofile unschedule
resticprofile schedule --all
echo "Scheduled all restic profiles"