forked from coop-cloud/backup-bot-two
		
	Compare commits
	
		
			108 Commits
		
	
	
		
			backupbot_
			...
			main
		
	
	| Author | SHA1 | Date | |
|---|---|---|---|
| e972ca24d8 | |||
| 54e32ab422 | |||
| 4cda3c1018 | |||
| f7f46d7b7b | |||
| c1902b2dbc | |||
| f40eb00435 | |||
| 3eea69ddee | |||
| f1661c04e7 | |||
| 4b4371ed3f | |||
| 1214f59c79 | |||
| 8798e2feb5 | |||
| 119787ed39 | |||
| 141bedb069 | |||
| 14b55bbc79 | |||
| ebcb0d42c5 | |||
| dccc93ac6b | |||
| 826bec925f | |||
| 49dd989302 | |||
| 2f965a93dc | |||
| 4054d3417e | |||
| f8cfcef029 | |||
| 4a49c4a7f0 | |||
| 79cdec6705 | |||
| 2bc9400807 | |||
| 9b141a5185 | |||
| 6ff2312090 | |||
| 8b66b80332 | |||
| c9b04db7a0 | |||
| 333b7ec16d | |||
| aeccd605ee | |||
| f877186a57 | |||
| 9dc239b199 | |||
| 43548273fe | |||
| 5a0467dbdd | |||
| 3aefae61c0 | |||
| ac7c5fb50d | |||
| cc59087b8c | |||
| eb7c35d4cd | |||
| 249772ec03 | |||
| 45af6e8b5e | |||
| f7207cdf36 | |||
| 241fe3ce92 | |||
| b8d61d01cd | |||
| 6ac781c7e6 | |||
| 197cabf564 | |||
| fe35f1ede8 | |||
| f254a365f2 | |||
| 0d15765673 | |||
| e09e1b476c | |||
| 72688dc42c | |||
| 10e460ff2d | |||
| f2d0b92fa3 | |||
| cc049b858b | |||
| b7bc8ed58f | |||
| 68e37f5c23 | |||
| 4d39d84733 | |||
| e5b9bc0446 | |||
| ec4c4509dc | |||
| 26162a9e38 | |||
| bd581fd8d7 | |||
| e77432e3ab | |||
| 001a654e37 | |||
| c5574edc54 | |||
| 50e4d68717 | |||
| c7830ceb6f | |||
| b6f859efbb | |||
| 7f14698824 | |||
| 2a9a98172f | |||
| 282215cf9c | |||
| ae7a14b6f1 | |||
| 8acdb20e5b | |||
| 5582744073 | |||
| 84d606fa80 | |||
| 7865907811 | |||
| dc66c02e23 | |||
| f730c70bfe | |||
| faa7ae3dd1 | |||
| 79eeec428a | |||
| 4164760dc6 | |||
| e644679b8b | |||
| 0c587ac926 | |||
| 65686cd891 | |||
| ac055c932e | |||
| 64328c79b1 | |||
| 15275b2571 | |||
| 4befebba38 | |||
| d2087a441e | |||
| f4d96b0875 | |||
| c73bbe8c0d | |||
| ff2b5a25a2 | |||
| e186813a49 | |||
| 37cb51674f | |||
| 2ea59b4230 | |||
| 354f964e7d | |||
| 2bb27aadc4 | |||
| 66e1c9617d | |||
| 79d19e7ac5 | |||
| 359140781e | |||
| 8750ec1813 | |||
| 8e76ad591e | |||
| a3faa5d51f | |||
| a3f27fa6ba | |||
| fe5d846c5f | |||
| 79b7a01dda | |||
| f8a8547b70 | |||
| 192b1f1d9c | |||
| 4c2304a962 | |||
| 69e7f07978 | 
							
								
								
									
										21
									
								
								.drone.yml
									
									
									
									
									
								
							
							
						
						
									
										21
									
								
								.drone.yml
									
									
									
									
									
								
							| @ -2,11 +2,16 @@ | |||||||
| kind: pipeline | kind: pipeline | ||||||
| name: linters | name: linters | ||||||
| steps: | steps: | ||||||
|   - name: run shellcheck |   - name: publish image | ||||||
|     image: koalaman/shellcheck-alpine |     image: plugins/docker | ||||||
|     commands: |     settings: | ||||||
|       - shellcheck backup.sh |       username: abra-bot | ||||||
|  |       password: | ||||||
| trigger: |         from_secret: git_coopcloud_tech_token_abra_bot | ||||||
|   branch: |       repo: git.coopcloud.tech/coop-cloud/backup-bot-two | ||||||
|     - main |       tags: ${DRONE_SEMVER_BUILD} | ||||||
|  |       registry: git.coopcloud.tech | ||||||
|  |     when: | ||||||
|  |       event: | ||||||
|  |         include: | ||||||
|  |           - tag | ||||||
|  | |||||||
							
								
								
									
										17
									
								
								.env.sample
									
									
									
									
									
								
							
							
						
						
									
										17
									
								
								.env.sample
									
									
									
									
									
								
							| @ -4,10 +4,21 @@ SECRET_RESTIC_PASSWORD_VERSION=v1 | |||||||
|  |  | ||||||
| COMPOSE_FILE=compose.yml | COMPOSE_FILE=compose.yml | ||||||
|  |  | ||||||
| RESTIC_REPO=/backups/restic | RESTIC_REPOSITORY=/backups/restic | ||||||
|  |  | ||||||
| CRON_SCHEDULE='30 3 * * *' | CRON_SCHEDULE='30 3 * * *' | ||||||
|  |  | ||||||
|  | # Push Notifiactions | ||||||
|  | #PUSH_PROMETHEUS_URL=https://pushgateway.example.com/metrics/job/backup | ||||||
|  | # or | ||||||
|  | #PUSH_URL_START=https://status.example.com/api/push/xxxxxxxxxx?status=up&msg=start | ||||||
|  | #PUSH_URL_SUCCESS=https://status.example.com/api/push/xxxxxxxxxx?status=up&msg=OK | ||||||
|  | #PUSH_URL_FAIL=https://status.example.com/api/push/xxxxxxxxxx?status=down&msg=fail | ||||||
|  |  | ||||||
|  | # Push Basic Auth | ||||||
|  | #COMPOSE_FILE="$COMPOSE_FILE:compose.pushbasicauth.yml" | ||||||
|  | #SECRET_PUSH_BASICAUTH=v1 | ||||||
|  |  | ||||||
| # swarm-cronjob, instead of built-in cron | # swarm-cronjob, instead of built-in cron | ||||||
| #COMPOSE_FILE="$COMPOSE_FILE:compose.swarm-cronjob.yml" | #COMPOSE_FILE="$COMPOSE_FILE:compose.swarm-cronjob.yml" | ||||||
|  |  | ||||||
| @ -22,8 +33,8 @@ CRON_SCHEDULE='30 3 * * *' | |||||||
| #COMPOSE_FILE="$COMPOSE_FILE:compose.s3.yml" | #COMPOSE_FILE="$COMPOSE_FILE:compose.s3.yml" | ||||||
|  |  | ||||||
| # Secret restic repository | # Secret restic repository | ||||||
| # use a secret to store the RESTIC_REPO if the repository location contains a secret value | # use a secret to store the RESTIC_REPOSITORY if the repository location contains a secret value | ||||||
| # i.E rest:https://user:SECRET_PASSWORD@host:8000/ | # i.E rest:https://user:SECRET_PASSWORD@host:8000/ | ||||||
| # it overwrites the RESTIC_REPO variable | # it overwrites the RESTIC_REPOSITORY variable | ||||||
| #SECRET_RESTIC_REPO_VERSION=v1 | #SECRET_RESTIC_REPO_VERSION=v1 | ||||||
| #COMPOSE_FILE="$COMPOSE_FILE:compose.secret.yml" | #COMPOSE_FILE="$COMPOSE_FILE:compose.secret.yml" | ||||||
|  | |||||||
							
								
								
									
										2
									
								
								.gitignore
									
									
									
									
										vendored
									
									
								
							
							
						
						
									
										2
									
								
								.gitignore
									
									
									
									
										vendored
									
									
								
							| @ -1 +1 @@ | |||||||
| /testing | .venv | ||||||
|  | |||||||
							
								
								
									
										6
									
								
								CHANGELOG.md
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										6
									
								
								CHANGELOG.md
									
									
									
									
									
										Normal file
									
								
							| @ -0,0 +1,6 @@ | |||||||
|  | # Change log | ||||||
|  |  | ||||||
|  | ## 2.0.0 (unreleased) | ||||||
|  |  | ||||||
|  | - Rewrite from Bash to Python | ||||||
|  | - Add support for push notifications (#24) | ||||||
							
								
								
									
										11
									
								
								Dockerfile
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										11
									
								
								Dockerfile
									
									
									
									
									
										Normal file
									
								
							| @ -0,0 +1,11 @@ | |||||||
|  | FROM docker:24.0.7-dind | ||||||
|  |  | ||||||
|  | RUN apk add --upgrade --no-cache restic bash python3 py3-pip py3-click py3-docker-py py3-json-logger curl | ||||||
|  |  | ||||||
|  | # Todo use requirements file with specific versions | ||||||
|  | RUN pip install --break-system-packages resticpy==1.0.2 | ||||||
|  |  | ||||||
|  | COPY backupbot.py /usr/bin/backup | ||||||
|  | COPY entrypoint.sh /entrypoint.sh | ||||||
|  |  | ||||||
|  | ENTRYPOINT /entrypoint.sh | ||||||
							
								
								
									
										165
									
								
								README.md
									
									
									
									
									
								
							
							
						
						
									
										165
									
								
								README.md
									
									
									
									
									
								
							| @ -10,7 +10,7 @@ Automatically take backups from all volumes of running Docker Swarm services and | |||||||
|  |  | ||||||
| * **Category**: Utilities | * **Category**: Utilities | ||||||
| * **Status**: 0, work-in-progress | * **Status**: 0, work-in-progress | ||||||
| * **Image**: [`thecoopcloud/backup-bot-two`](https://hub.docker.com/r/thecoopcloud/backup-bot-two), 4, upstream | * **Image**: [`git.coopcloud.tech/coop-cloud/backup-bot-two`](https://git.coopcloud.tech/coop-cloud/-/packages/container/backup-bot-two), 4, upstream | ||||||
| * **Healthcheck**: No | * **Healthcheck**: No | ||||||
| * **Backups**: N/A | * **Backups**: N/A | ||||||
| * **Email**: N/A | * **Email**: N/A | ||||||
| @ -38,26 +38,26 @@ Backupbot II tries to help, by | |||||||
| * `abra app new backup-bot-two` | * `abra app new backup-bot-two` | ||||||
| * `abra app config <app-name>` | * `abra app config <app-name>` | ||||||
|     - set storage options. Either configure `CRON_SCHEDULE`, or set up `swarm-cronjob` |     - set storage options. Either configure `CRON_SCHEDULE`, or set up `swarm-cronjob` | ||||||
| * `abra app secret generate -a <app_name>` | * `abra app secret generate -a <backupbot_name>` | ||||||
| * `abra app deploy <app-name>` | * `abra app deploy <app-name>` | ||||||
|  |  | ||||||
| ## Configuration | ## Configuration | ||||||
|  |  | ||||||
| Per default Backupbot stores the backups locally in the repository `/backups/restic`, which is accessible as volume at `/var/lib/docker/volumes/<app_name>_backups/_data/restic/` | Per default Backupbot stores the backups locally in the repository `/backups/restic`, which is accessible as volume at `/var/lib/docker/volumes/<backupbot_name>_backups/_data/restic/` | ||||||
|  |  | ||||||
| The backup location can be changed using the `RESTIC_REPO` env variable. | The backup location can be changed using the `RESTIC_REPOSITORY` env variable. | ||||||
|  |  | ||||||
| ### S3 Storage | ### S3 Storage | ||||||
|  |  | ||||||
| To use S3 storage as backup location set the following envs: | To use S3 storage as backup location set the following envs: | ||||||
| ``` | ``` | ||||||
| RESTIC_REPO=s3:<S3-SERVICE-URL>/<BUCKET-NAME> | RESTIC_REPOSITORY=s3:<S3-SERVICE-URL>/<BUCKET-NAME> | ||||||
| SECRET_AWS_SECRET_ACCESS_KEY_VERSION=v1 | SECRET_AWS_SECRET_ACCESS_KEY_VERSION=v1 | ||||||
| AWS_ACCESS_KEY_ID=<MY_ACCESS_KEY> | AWS_ACCESS_KEY_ID=<MY_ACCESS_KEY> | ||||||
| COMPOSE_FILE="$COMPOSE_FILE:compose.s3.yml" | COMPOSE_FILE="$COMPOSE_FILE:compose.s3.yml" | ||||||
| ``` | ``` | ||||||
| and add your `<SECRET_ACCESS_KEY>` as docker secret: | and add your `<SECRET_ACCESS_KEY>` as docker secret: | ||||||
| `abra app secret insert <app_name> aws_secret_access_key v1 <SECRET_ACCESS_KEY>` | `abra app secret insert <backupbot_name> aws_secret_access_key v1 <SECRET_ACCESS_KEY>` | ||||||
|  |  | ||||||
| See [restic s3 docs](https://restic.readthedocs.io/en/latest/030_preparing_a_new_repo.html#amazon-s3) for more information. | See [restic s3 docs](https://restic.readthedocs.io/en/latest/030_preparing_a_new_repo.html#amazon-s3) for more information. | ||||||
|  |  | ||||||
| @ -67,7 +67,7 @@ See [restic s3 docs](https://restic.readthedocs.io/en/latest/030_preparing_a_new | |||||||
|  |  | ||||||
| To use SFTP storage as backup location set the following envs: | To use SFTP storage as backup location set the following envs: | ||||||
| ``` | ``` | ||||||
| RESTIC_REPO=sftp:user@host:/restic-repo-path | RESTIC_REPOSITORY=sftp:user@host:/restic-repo-path | ||||||
| SECRET_SSH_KEY_VERSION=v1 | SECRET_SSH_KEY_VERSION=v1 | ||||||
| SSH_HOST_KEY="hostname ssh-rsa AAAAB3... | SSH_HOST_KEY="hostname ssh-rsa AAAAB3... | ||||||
| COMPOSE_FILE="$COMPOSE_FILE:compose.ssh.yml" | COMPOSE_FILE="$COMPOSE_FILE:compose.ssh.yml" | ||||||
| @ -79,13 +79,14 @@ Add the key to your `authorized_keys`: | |||||||
| `ssh-copy-id -i backupkey <user>@<hostname>` | `ssh-copy-id -i backupkey <user>@<hostname>` | ||||||
| Add your `SSH_KEY` as docker secret: | Add your `SSH_KEY` as docker secret: | ||||||
| ``` | ``` | ||||||
| abra app secret insert <app_name> ssh_key v1 """$(cat backupkey) | abra app secret insert <backupbot_name> ssh_key v1 """$(cat backupkey) | ||||||
| """ | """ | ||||||
| ``` | ``` | ||||||
|  | > Attention: This command needs to be executed exactly as stated above, because it places a trailing newline at the end, if this is missing you will get the following error: `Load key "/run/secrets/ssh_key": error in libcrypto` | ||||||
|  |  | ||||||
| ### Restic REST server Storage | ### Restic REST server Storage | ||||||
|  |  | ||||||
| You can simply set the `RESTIC_REPO` variable to your REST server URL `rest:http://host:8000/`. | You can simply set the `RESTIC_REPOSITORY` variable to your REST server URL `rest:http://host:8000/`. | ||||||
| If you access the REST server with a password `rest:https://user:pass@host:8000/` you should hide the whole URL containing the password inside a secret. | If you access the REST server with a password `rest:https://user:pass@host:8000/` you should hide the whole URL containing the password inside a secret. | ||||||
| Uncomment these lines: | Uncomment these lines: | ||||||
| ``` | ``` | ||||||
| @ -94,82 +95,192 @@ COMPOSE_FILE="$COMPOSE_FILE:compose.secret.yml" | |||||||
| ``` | ``` | ||||||
| Add your REST server url as secret: | Add your REST server url as secret: | ||||||
| ``` | ``` | ||||||
| `abra app secret insert <app_name> restic_repo v1 "rest:https://user:pass@host:8000/"` | abra app secret insert <backupbot_name> restic_repo v1 "rest:https://user:pass@host:8000/" | ||||||
| ``` | ``` | ||||||
| The secret will overwrite the `RESTIC_REPO` variable. | The secret will overwrite the `RESTIC_REPOSITORY` variable. | ||||||
|  |  | ||||||
|  |  | ||||||
| See [restic REST docs](https://restic.readthedocs.io/en/latest/030_preparing_a_new_repo.html#rest-server) for more information. | See [restic REST docs](https://restic.readthedocs.io/en/latest/030_preparing_a_new_repo.html#rest-server) for more information. | ||||||
|  |  | ||||||
|  | ## Push notifications | ||||||
|  |  | ||||||
|  | It is possible to configure three push events, that may trigger on the backup cronjob. Those can be used to detect failures from mointoring systems. | ||||||
|  | The events are: | ||||||
|  | - start | ||||||
|  | - success | ||||||
|  | - fail | ||||||
|  |  | ||||||
|  | ### Using a Prometheus Push Gateway | ||||||
|  |  | ||||||
|  | [A prometheus push gateway](https://git.coopcloud.tech/coop-cloud/monitoring-ng#setup-push-gateway) can be used by setting the following env variables: | ||||||
|  | - `PUSH_PROMETHEUS_URL=pushgateway.example.com/metrics/job/backup` | ||||||
|  |  | ||||||
|  | ### Using custom URLs | ||||||
|  |  | ||||||
|  | The following env variables can be used to setup push notifications for backups. `PUSH_URL_START` is requested just before the backups starts, `PUSH_URL_SUCCESS` is only requested if the backup was successful and if the backup fails `PUSH_URL_FAIL` will be requested. | ||||||
|  | Each variable is optional and independent of the other. | ||||||
|  |  | ||||||
|  | ``` | ||||||
|  | PUSH_URL_START=https://status.example.com/api/push/xxxxxxxxxx?status=up&msg=start | ||||||
|  | PUSH_URL_SUCCESS=https://status.example.com/api/push/xxxxxxxxxx?status=up&msg=OK | ||||||
|  | PUSH_URL_FAIL=https://status.example.com/api/push/xxxxxxxxxx?status=down&msg=fail | ||||||
|  | ``` | ||||||
|  |  | ||||||
|  | ### Push endpoint behind basic auth | ||||||
|  |  | ||||||
|  | Insert the basic auth secret | ||||||
|  | `abra app secret insert <backupbot_name> push_basicauth v1 "user:password"` | ||||||
|  |  | ||||||
|  | Enable basic auth in the env file, by uncommenting the following line: | ||||||
|  | ``` | ||||||
|  | #COMPOSE_FILE="$COMPOSE_FILE:compose.pushbasicauth.yml" | ||||||
|  | #SECRET_PUSH_BASICAUTH=v1 | ||||||
|  | ``` | ||||||
|  |  | ||||||
| ## Usage | ## Usage | ||||||
|  |  | ||||||
|  | Run the cronjob that creates a backup, including the push notifications and docker logging: | ||||||
|  | `abra app cmd <backupbot_name> app run_cron` | ||||||
|  |  | ||||||
| Create a backup of all apps: | Create a backup of all apps: | ||||||
|  |  | ||||||
| `abra app run <app_name> app -- backup create` | `abra app run <backupbot_name> app -- backup create` | ||||||
|  |  | ||||||
| > The apps to backup up need to be deployed | > The apps to backup up need to be deployed | ||||||
|  |  | ||||||
| Create an individual backup: | Create an individual backup: | ||||||
|  |  | ||||||
| `abra app run <app_name> app -- backup --host <target_app_name> create` | `abra app run <backupbot_name> app -- backup --host <target_app_name> create` | ||||||
|  |  | ||||||
| Create a backup to a local repository: | Create a backup to a local repository: | ||||||
|  |  | ||||||
| `abra app run <app_name> app -- backup create -r /backups/restic` | `abra app run <backupbot_name> app -- backup create -r /backups/restic` | ||||||
|  |  | ||||||
| > It is recommended to shutdown/undeploy an app before restoring the data | > It is recommended to shutdown/undeploy an app before restoring the data | ||||||
|  |  | ||||||
| Restore the latest snapshot of all including apps: | Restore the latest snapshot of all including apps: | ||||||
|  |  | ||||||
| `abra app run <app_name> app -- backup restore` | `abra app run <backupbot_name> app -- backup restore` | ||||||
|  |  | ||||||
| Restore a specific snapshot of an individual app: | Restore a specific snapshot of an individual app: | ||||||
|  |  | ||||||
| `abra app run <app_name> app -- backup --host <target_app_name> restore --snapshot <snapshot_id>` | `abra app run <backupbot_name> app -- backup --host <target_app_name> restore --snapshot <snapshot_id>` | ||||||
|  |  | ||||||
| Show all snapshots: | Show all snapshots: | ||||||
|  |  | ||||||
| `abra app run <app_name> app -- backup snapshots` | `abra app run <backupbot_name> app -- backup snapshots` | ||||||
|  |  | ||||||
| Show all snapshots containing a specific app: | Show all snapshots containing a specific app: | ||||||
|  |  | ||||||
| `abra app run <app_name> app -- backup --host <target_app_name> snapshots` | `abra app run <backupbot_name> app -- backup --host <target_app_name> snapshots` | ||||||
|  |  | ||||||
| Show all files inside the latest snapshot (can be very verbose): | Show all files inside the latest snapshot (can be very verbose): | ||||||
|  |  | ||||||
| `abra app run <app_name> app -- backup ls` | `abra app run <backupbot_name> app -- backup ls` | ||||||
|  |  | ||||||
| Show specific files inside a selected snapshot: | Show specific files inside a selected snapshot: | ||||||
|  |  | ||||||
| `abra app run <app_name> app -- backup ls --snapshot <snapshot_id> --path /var/lib/docker/volumes/` | `abra app run <backupbot_name> app -- backup ls --snapshot <snapshot_id> /var/lib/docker/volumes/` | ||||||
|  |  | ||||||
| Download files from a snapshot: | Download files from a snapshot: | ||||||
|  |  | ||||||
| ``` | ``` | ||||||
| filename=$(abra app run <app_name> app -- backup download --snapshot <snapshot_id> --path <absolute_path>) | filename=$(abra app run <backupbot_name> app -- backup download --snapshot <snapshot_id> --path <absolute_path>) | ||||||
| abra app cp <app_name> app:$filename . | abra app cp <backupbot_name> app:$filename . | ||||||
| ``` | ``` | ||||||
|  |  | ||||||
|  | ## Run restic | ||||||
|  |  | ||||||
|  | ``` | ||||||
|  | abra app run <backupbot_name> app bash | ||||||
|  | export AWS_SECRET_ACCESS_KEY=$(cat $AWS_SECRET_ACCESS_KEY_FILE) | ||||||
|  | export RESTIC_PASSWORD=$(cat $RESTIC_PASSWORD_FILE) | ||||||
|  | restic snapshots | ||||||
|  | ``` | ||||||
|  |  | ||||||
| ## Recipe Configuration | ## Recipe Configuration | ||||||
|  |  | ||||||
| Like Traefik, or `swarm-cronjob`, Backupbot II uses access to the Docker socket to read labels from running Docker Swarm services: | Like Traefik, or `swarm-cronjob`, Backupbot II uses access to the Docker socket to read labels from running Docker Swarm services: | ||||||
|  |  | ||||||
|  | 1. Add `ENABLE_BACKUPS=true` to .env.sample | ||||||
|  |  | ||||||
|  | 2. Add backupbot labels to the compose file | ||||||
|  |  | ||||||
| ``` | ``` | ||||||
| services: | services: | ||||||
|   db: |   db: | ||||||
|     deploy: |     deploy: | ||||||
|       labels: |       labels: | ||||||
|         backupbot.backup: ${BACKUP:-"true"}  |         backupbot.backup: "${ENABLE_BACKUPS:-true}" | ||||||
|         backupbot.backup.pre-hook: 'mysqldump -u root -p"$(cat /run/secrets/db_root_password)" -f /volume_path/dump.db' |         backupbot.backup.pre-hook: "/pg_backup.sh backup" | ||||||
|         backupbot.backup.post-hook: "rm -rf /volume_path/dump.db" |         backupbot.backup.volumes.db.path: "backup.sql" | ||||||
|  |         backupbot.restore.post-hook: '/pg_backup.sh restore' | ||||||
|  |         backupbot.backup.volumes.redis: "false" | ||||||
| ``` | ``` | ||||||
|  |  | ||||||
| - `backupbot.backup` -- set to `true` to back up this service (REQUIRED) | - `backupbot.backup` -- set to `true` to back up this service (REQUIRED) | ||||||
| - `backupbot.backup.pre-hook` -- command to run before copying files (optional), save all dumps into the volumes |     - this is the only required backup label, per default it will backup all volumes | ||||||
| - `backupbot.backup.post-hook` -- command to run after copying files (optional) | - `backupbot.backup.volumes.<volume_name>.path` -- only backup the listed relative paths from `<volume_name>` | ||||||
|  | - `backupbot.backup.volumes.<volume_name>: false` -- exclude <volume_name> from the backup | ||||||
|  | - `backupbot.backup.pre-hook` -- command to run before copying files | ||||||
|  |     - i.e. save all database dumps into the volumes | ||||||
|  | - `backupbot.backup.post-hook` -- command to run after copying files | ||||||
|  | - `backupbot.restore.pre-hook` -- command to run before restoring files | ||||||
|  | - `backupbot.restore.post-hook` -- command to run after restoring files | ||||||
|  |     - i.e. read all database dumps from the volumes | ||||||
|  |  | ||||||
|  | 3. (Optional) add backup/restore scripts to the compose file | ||||||
|  |  | ||||||
|  | ``` | ||||||
|  | services: | ||||||
|  |   db: | ||||||
|  |     configs: | ||||||
|  |         - source: pg_backup | ||||||
|  |           target: /pg_backup.sh | ||||||
|  |           mode: 0555 | ||||||
|  |  | ||||||
|  |  | ||||||
|  | configs: | ||||||
|  |   pg_backup: | ||||||
|  |     name: ${STACK_NAME}_pg_backup_${PG_BACKUP_VERSION} | ||||||
|  |     file: pg_backup.sh | ||||||
|  | ``` | ||||||
|  |  | ||||||
|  | Version the config file in `abra.sh`: | ||||||
|  |  | ||||||
|  | ``` | ||||||
|  | export PG_BACKUP_VERSION=v1 | ||||||
|  | ``` | ||||||
|  |  | ||||||
| As in the above example, you can reference Docker Secrets, e.g. for looking up database passwords, by reading the files in `/run/secrets` directly. | As in the above example, you can reference Docker Secrets, e.g. for looking up database passwords, by reading the files in `/run/secrets` directly. | ||||||
|  |  | ||||||
| [abra]: https://git.autonomic.zone/autonomic-cooperative/abra | [abra]: https://git.autonomic.zone/autonomic-cooperative/abra | ||||||
|  |  | ||||||
|  | ## Backupbot Development | ||||||
|  |  | ||||||
|  | 1. Copy modified backupbot.py into the container: | ||||||
|  |  | ||||||
|  | ``` | ||||||
|  | cp backupbot.py /tmp/backupbot.py; git stash; abra app cp <backupbot_name> /tmp/backupbot.py app:/usr/bin/backupbot.py; git checkout main; git stash pop | ||||||
|  | ``` | ||||||
|  |  | ||||||
|  | 2. Testing stuff with the python interpreter inside the container: | ||||||
|  |  | ||||||
|  | ``` | ||||||
|  | abra app run <backupbot_name> app bash | ||||||
|  | cd /usr/bin/ | ||||||
|  | python | ||||||
|  | from backupbot import * | ||||||
|  | ``` | ||||||
|  |  | ||||||
|  | ### Versioning | ||||||
|  |  | ||||||
|  | - App version: changes to `backup.py` (build a new image) | ||||||
|  | - Co-op Cloud package version: changes to recipe. | ||||||
|  |  | ||||||
|  |         For example, starting with 1.0.0+2.0.0: | ||||||
|  |             "patch" change to recipe: 1.0.1+2.0.0 | ||||||
|  |             "patch" change to backup.py: increment both, so 1.1.0+2.0.1 | ||||||
|  |                    because bumping the image version would result in a minor recipe release | ||||||
|  |  | ||||||
|  | https://git.coopcloud.tech/coop-cloud/backup-bot-two/issues/4 | ||||||
|  | |||||||
							
								
								
									
										12
									
								
								abra.sh
									
									
									
									
									
								
							
							
						
						
									
										12
									
								
								abra.sh
									
									
									
									
									
								
							| @ -1,3 +1,11 @@ | |||||||
| export ENTRYPOINT_VERSION=v1 |  | ||||||
| export BACKUPBOT_VERSION=v1 |  | ||||||
| export SSH_CONFIG_VERSION=v1 | export SSH_CONFIG_VERSION=v1 | ||||||
|  | export ENTRYPOINT_VERSION=v17 | ||||||
|  | export CRONJOB_VERSION=v2 | ||||||
|  |  | ||||||
|  | run_cron () { | ||||||
|  |     schedule="$(crontab -l | tr -s " " | cut -d ' ' -f-5)" | ||||||
|  |     rm -f /tmp/backup.log | ||||||
|  |     echo "* * * * *  $(crontab -l | tr -s " " | cut -d ' ' -f6-)" | crontab - | ||||||
|  |     while [ ! -f /tmp/backup.log ]; do sleep 1; done | ||||||
|  |     echo "$schedule $(crontab -l | tr -s " " | cut -d ' ' -f6-)" | crontab - | ||||||
|  | } | ||||||
|  | |||||||
							
								
								
									
										667
									
								
								backupbot.py
									
									
									
									
									
								
							
							
						
						
									
										667
									
								
								backupbot.py
									
									
									
									
									
								
							| @ -1,125 +1,433 @@ | |||||||
| #!/usr/bin/python3 | #!/usr/bin/python3 | ||||||
|  |  | ||||||
| import os | import os | ||||||
|  | import sys | ||||||
| import click | import click | ||||||
| import json | import json | ||||||
| import subprocess | import subprocess | ||||||
| import logging | import logging | ||||||
| import docker | import docker | ||||||
| import restic | import restic | ||||||
|  | import tarfile | ||||||
|  | import io | ||||||
|  | from pythonjsonlogger import jsonlogger | ||||||
| from datetime import datetime, timezone | from datetime import datetime, timezone | ||||||
| from restic.errors import ResticFailedError | from restic.errors import ResticFailedError | ||||||
| from pathlib import Path | from pathlib import Path | ||||||
| from shutil import copyfile, rmtree | from shutil import copyfile, rmtree | ||||||
| # logging.basicConfig(level=logging.INFO) |  | ||||||
|  |  | ||||||
| VOLUME_PATH = "/var/lib/docker/volumes/" | VOLUME_PATH = "/var/lib/docker/volumes/" | ||||||
| SECRET_PATH = '/secrets/' | SECRET_PATH = "/secrets/" | ||||||
| SERVICE = None | SERVICE = "ALL" | ||||||
|  |  | ||||||
|  | logger = logging.getLogger("backupbot") | ||||||
|  | logging.addLevelName(55, "SUMMARY") | ||||||
|  | setattr(logging, "SUMMARY", 55) | ||||||
|  | setattr( | ||||||
|  |     logger, | ||||||
|  |     "summary", | ||||||
|  |     lambda message, *args, **kwargs: logger.log(55, message, *args, **kwargs), | ||||||
|  | ) | ||||||
|  |  | ||||||
|  |  | ||||||
|  | def handle_exception(exc_type, exc_value, exc_traceback): | ||||||
|  |     if issubclass(exc_type, KeyboardInterrupt): | ||||||
|  |         sys.__excepthook__(exc_type, exc_value, exc_traceback) | ||||||
|  |         return | ||||||
|  |     logger.critical("Uncaught exception", exc_info=(exc_type, exc_value, exc_traceback)) | ||||||
|  |  | ||||||
|  |  | ||||||
|  | sys.excepthook = handle_exception | ||||||
|  |  | ||||||
|  |  | ||||||
| @click.group() | @click.group() | ||||||
| @click.option('-l', '--log', 'loglevel') | @click.option("-l", "--log", "loglevel") | ||||||
| @click.option('service', '--host', '-h', envvar='SERVICE') | @click.option( | ||||||
| @click.option('repository', '--repo', '-r', envvar='RESTIC_REPO', required=True) |     "-m", "--machine-logs", "machine_logs", is_flag=True, envvar="MACHINE_LOGS" | ||||||
| def cli(loglevel, service, repository): | ) | ||||||
|  | @click.option("service", "--host", "-h", envvar="SERVICE") | ||||||
|  | @click.option("repository", "--repo", "-r", envvar="RESTIC_REPOSITORY") | ||||||
|  | def cli(loglevel, service, repository, machine_logs): | ||||||
|     global SERVICE |     global SERVICE | ||||||
|     if service: |     if service: | ||||||
|         SERVICE = service.replace('.', '_') |         SERVICE = service.replace(".", "_") | ||||||
|     if repository: |     if repository: | ||||||
|         os.environ['RESTIC_REPO'] = repository |         os.environ["RESTIC_REPOSITORY"] = repository | ||||||
|     if loglevel: |     if loglevel: | ||||||
|         numeric_level = getattr(logging, loglevel.upper(), None) |         numeric_level = getattr(logging, loglevel.upper(), None) | ||||||
|         if not isinstance(numeric_level, int): |         if not isinstance(numeric_level, int): | ||||||
|             raise ValueError('Invalid log level: %s' % loglevel) |             raise ValueError("Invalid log level: %s" % loglevel) | ||||||
|         logging.basicConfig(level=numeric_level) |         logger.setLevel(numeric_level) | ||||||
|  |     logHandler = logging.StreamHandler() | ||||||
|  |     if machine_logs: | ||||||
|  |         formatter = jsonlogger.JsonFormatter( | ||||||
|  |             "%(levelname)s %(filename)s %(lineno)s %(process)d %(message)s", | ||||||
|  |             rename_fields={"levelname": "message_type"}, | ||||||
|  |         ) | ||||||
|  |         logHandler.setFormatter(formatter) | ||||||
|  |     logger.addHandler(logHandler) | ||||||
|  |  | ||||||
|     export_secrets() |     export_secrets() | ||||||
|     init_repo() |     init_repo() | ||||||
|  |  | ||||||
|  |  | ||||||
| def init_repo(): | def init_repo(): | ||||||
|     repo = os.environ['RESTIC_REPO'] |     if repo := os.environ.get("RESTIC_REPOSITORY_FILE"): | ||||||
|     logging.debug(f"set restic repository location: {repo}") |         # RESTIC_REPOSITORY_FILE and RESTIC_REPOSITORY are mutually exclusive | ||||||
|  |         del os.environ["RESTIC_REPOSITORY"] | ||||||
|  |     else: | ||||||
|  |         repo = os.environ["RESTIC_REPOSITORY"] | ||||||
|         restic.repository = repo |         restic.repository = repo | ||||||
|     restic.password_file = '/var/run/secrets/restic_password' |     logger.debug(f"set restic repository location: {repo}") | ||||||
|  |     restic.password_file = "/var/run/secrets/restic_password" | ||||||
|     try: |     try: | ||||||
|         restic.cat.config() |         restic.cat.config() | ||||||
|     except ResticFailedError as error: |     except ResticFailedError as error: | ||||||
|         if 'unable to open config file' in str(error): |         if "unable to open config file" in str(error): | ||||||
|             result = restic.init() |             result = restic.init() | ||||||
|             logging.info(f"Initialized restic repo: {result}") |             logger.info(f"Initialized restic repo: {result}") | ||||||
|         else: |         else: | ||||||
|             raise error |             raise error | ||||||
|  |  | ||||||
|  |  | ||||||
| def export_secrets(): | def export_secrets(): | ||||||
|     for env in os.environ: |     for env in os.environ: | ||||||
|         if env.endswith('FILE') and not "COMPOSE_FILE" in env: |         if env.endswith("FILE") and not "COMPOSE_FILE" in env: | ||||||
|             logging.debug(f"exported secret: {env}") |             logger.debug(f"exported secret: {env}") | ||||||
|             with open(os.environ[env]) as file: |             with open(os.environ[env]) as file: | ||||||
|                 secret = file.read() |                 secret = file.read() | ||||||
|                 os.environ[env.removesuffix('_FILE')] = secret |                 os.environ[env.removesuffix("_FILE")] = secret | ||||||
|                 # logging.debug(f"Read secret value: {secret}") |                 # logger.debug(f"Read secret value: {secret}") | ||||||
|  |  | ||||||
|  |  | ||||||
| @cli.command() | @cli.command() | ||||||
| def create(): | @click.option("retries", "--retries", "-r", envvar="RETRIES", default=1) | ||||||
|     pre_commands, post_commands, backup_paths, apps = get_backup_cmds() | def create(retries): | ||||||
|     copy_secrets(apps) |     app_settings = parse_backup_labels() | ||||||
|     backup_paths.append(SECRET_PATH) |     pre_commands, post_commands, backup_paths, apps_versions = get_backup_details( | ||||||
|  |         app_settings | ||||||
|  |     ) | ||||||
|  |     copy_secrets(apps_versions) | ||||||
|  |     backup_paths.append(Path(SECRET_PATH)) | ||||||
|     run_commands(pre_commands) |     run_commands(pre_commands) | ||||||
|     backup_volumes(backup_paths, apps) |     backup_volumes(backup_paths, apps_versions, int(retries)) | ||||||
|     run_commands(post_commands) |     run_commands(post_commands) | ||||||
|  |  | ||||||
|  |  | ||||||
| def get_backup_cmds(): | @cli.command() | ||||||
|  | @click.option("snapshot_id", "--snapshot", "-s", envvar="SNAPSHOT", default="latest") | ||||||
|  | @click.option("target", "--target", "-t", envvar="TARGET", default="/") | ||||||
|  | @click.option( | ||||||
|  |     "noninteractive", "--noninteractive", envvar="NONINTERACTIVE", is_flag=True | ||||||
|  | ) | ||||||
|  | @click.option("volumes", "--volumes", "-v", envvar="VOLUMES", multiple=True) | ||||||
|  | @click.option("container", "--container", "-c", envvar="CONTAINER", multiple=True) | ||||||
|  | @click.option("no_commands", "--no-commands", envvar="NO_COMMANDS", is_flag=True) | ||||||
|  | def restore(snapshot_id, target, noninteractive, volumes, container, no_commands): | ||||||
|  |     app_settings = parse_backup_labels("restore", container) | ||||||
|  |     if SERVICE != "ALL": | ||||||
|  |         if not app_settings.get(SERVICE): | ||||||
|  |             logger.error( | ||||||
|  |                 f"The app {SERVICE} is not running, use the restore-path argument to restore paths of undeployed apps" | ||||||
|  |             ) | ||||||
|  |             exit(1) | ||||||
|  |         app_settings = {SERVICE: app_settings.get(SERVICE)} | ||||||
|  |     pre_commands, post_commands, backup_paths, apps_versions = get_backup_details( | ||||||
|  |         app_settings, volumes | ||||||
|  |     ) | ||||||
|  |     snapshots = get_snapshots(snapshot_id) | ||||||
|  |     if not snapshots: | ||||||
|  |         logger.error( | ||||||
|  |             f"No Snapshots with ID {snapshot_id} for {apps_versions.keys()} found." | ||||||
|  |         ) | ||||||
|  |         exit(1) | ||||||
|  |     snapshot = snapshots[0] | ||||||
|  |     snapshot_id = snapshot["short_id"] | ||||||
|  |     if not noninteractive: | ||||||
|  |         print(f"Snapshot to restore: \t{snapshot_id}") | ||||||
|  |         restore_app_versions = app_versions_from_tags(snapshot.get("tags")) | ||||||
|  |         print("Apps:") | ||||||
|  |         for app, version in apps_versions.items(): | ||||||
|  |             restore_version = restore_app_versions.get(app) | ||||||
|  |             print(f"\t{app} \t {restore_version}") | ||||||
|  |             if version != restore_version: | ||||||
|  |                 print(f"WARNING!!! The running app is deployed with version {version}") | ||||||
|  |         print("The following volume paths will be restored:") | ||||||
|  |         for p in backup_paths: | ||||||
|  |             print(f"\t{p}") | ||||||
|  |         if not no_commands: | ||||||
|  |             print("The following commands will be executed:") | ||||||
|  |             for container, cmd in list(pre_commands.items()) + list( | ||||||
|  |                 post_commands.items() | ||||||
|  |             ): | ||||||
|  |                 print(f"\t{container.labels['com.docker.swarm.service.name']}:\t{cmd}") | ||||||
|  |         snapshot_date = datetime.fromisoformat(snapshot["time"]) | ||||||
|  |         delta = datetime.now(tz=timezone.utc) - snapshot_date | ||||||
|  |         print(f"This snapshot is {delta} old") | ||||||
|  |         print("\nTHIS COMMAND WILL IRREVERSIBLY OVERWRITES FILES") | ||||||
|  |         prompt = input("Type YES (uppercase) to continue: ") | ||||||
|  |         if prompt != "YES": | ||||||
|  |             logger.error("Restore aborted") | ||||||
|  |             exit(1) | ||||||
|  |     print(f"Restoring Snapshot {snapshot_id} at {target}") | ||||||
|  |     if not no_commands and pre_commands: | ||||||
|  |         print(f"Run pre commands.") | ||||||
|  |         run_commands(pre_commands) | ||||||
|  |     if backup_paths: | ||||||
|  |         result = restic_restore( | ||||||
|  |             snapshot_id=snapshot_id, include=backup_paths, target_dir=target | ||||||
|  |         ) | ||||||
|  |         logger.debug(result) | ||||||
|  |     else: | ||||||
|  |         print("No paths to restore.") | ||||||
|  |     if not no_commands and post_commands: | ||||||
|  |         print(f"Run post commands.") | ||||||
|  |         run_commands(post_commands) | ||||||
|  |  | ||||||
|  |  | ||||||
|  | @cli.command() | ||||||
|  | @click.option("snapshot_id", "--snapshot", "-s", envvar="SNAPSHOT", default="latest") | ||||||
|  | @click.option("target", "--target", "-t", envvar="TARGET", default="/") | ||||||
|  | @click.option( | ||||||
|  |     "noninteractive", "--noninteractive", envvar="NONINTERACTIVE", is_flag=True | ||||||
|  | ) | ||||||
|  | @click.argument("paths", nargs=-1, required=True, envvar="INCLUDE_PATH") | ||||||
|  | def restore_path(snapshot_id, target, noninteractive, paths): | ||||||
|  |     """PATHS: list of paths to restore""" | ||||||
|  |     snapshots = get_snapshots(snapshot_id) | ||||||
|  |     if not snapshots: | ||||||
|  |         logger.error(f"No Snapshots with ID {snapshot_id} for app {SERVICE} found.") | ||||||
|  |         exit(1) | ||||||
|  |     snapshot = snapshots[0] | ||||||
|  |     snapshot_id = snapshot["short_id"] | ||||||
|  |     if not noninteractive: | ||||||
|  |         print(f"Snapshot to restore: \t{snapshot_id}") | ||||||
|  |         restore_app_versions = app_versions_from_tags(snapshot.get("tags")) | ||||||
|  |         print("Apps:") | ||||||
|  |         for app, version in restore_app_versions.items(): | ||||||
|  |             if SERVICE == "ALL" or SERVICE == app: | ||||||
|  |                 print(f"\t{app} \t {version}") | ||||||
|  |         print("The following paths will be restored:") | ||||||
|  |         for p in paths: | ||||||
|  |             print(f"\t{p}") | ||||||
|  |         snapshot_date = datetime.fromisoformat(snapshot["time"]) | ||||||
|  |         delta = datetime.now(tz=timezone.utc) - snapshot_date | ||||||
|  |         print(f"This snapshot is {delta} old") | ||||||
|  |         print("\nTHIS COMMAND WILL IRREVERSIBLY OVERWRITES FILES") | ||||||
|  |         prompt = input("Type YES (uppercase) to continue: ") | ||||||
|  |         if prompt != "YES": | ||||||
|  |             logger.error("Restore aborted") | ||||||
|  |             exit(1) | ||||||
|  |     print(f"Restoring Snapshot {snapshot_id} at {target}") | ||||||
|  |     result = restic_restore(snapshot_id=snapshot_id, include=paths, target_dir=target) | ||||||
|  |     logger.debug(result) | ||||||
|  |  | ||||||
|  |  | ||||||
|  | def restic_restore(snapshot_id, include=[], target_dir=None): | ||||||
|  |     cmd = restic.cat.base_command() + ["restore", snapshot_id] | ||||||
|  |     for path in include: | ||||||
|  |         cmd.extend(["--include", path]) | ||||||
|  |     if target_dir: | ||||||
|  |         cmd.extend(["--target", target_dir]) | ||||||
|  |     return restic.internal.command_executor.execute(cmd) | ||||||
|  |  | ||||||
|  |  | ||||||
|  | def get_snapshots(snapshot_id=None): | ||||||
|  |     if snapshot_id and snapshot_id != "latest": | ||||||
|  |         snapshots = restic.snapshots(snapshot_id=snapshot_id) | ||||||
|  |         if not SERVICE in app_versions_from_tags(snapshots[0].get("tags")): | ||||||
|  |             logger.error(f"Snapshot with ID {snapshot_id} does not contain {SERVICE}") | ||||||
|  |             exit(1) | ||||||
|  |     else: | ||||||
|  |         snapshots = restic.snapshots() | ||||||
|  |         snapshots = list( | ||||||
|  |             filter( | ||||||
|  |                 lambda x: SERVICE in app_versions_from_tags(x.get("tags")), snapshots | ||||||
|  |             ) | ||||||
|  |         ) | ||||||
|  |     if snapshot_id == "latest": | ||||||
|  |         return snapshots[-1:] | ||||||
|  |     else: | ||||||
|  |         return snapshots | ||||||
|  |  | ||||||
|  |  | ||||||
|  | def app_versions_from_tags(tags): | ||||||
|  |     if tags: | ||||||
|  |         app_versions = map(lambda x: x.split(":"), tags) | ||||||
|  |         return {i[0]: i[1] if len(i) > 1 else None for i in app_versions} | ||||||
|  |     else: | ||||||
|  |         return {} | ||||||
|  |  | ||||||
|  |  | ||||||
|  | def str2bool(value: str) -> bool: | ||||||
|  |     return value.lower() in ("yes", "true", "t", "1") | ||||||
|  |  | ||||||
|  |  | ||||||
|  | def parse_backup_labels(hook_type="backup", selected_container=[]): | ||||||
|     client = docker.from_env() |     client = docker.from_env() | ||||||
|     container_by_service = { |     container_by_service = { | ||||||
|         c.labels['com.docker.swarm.service.name']: c for c in client.containers.list()} |         c.labels.get("com.docker.swarm.service.name"): c | ||||||
|     backup_paths = set() |         for c in client.containers.list() | ||||||
|     backup_apps = set() |     } | ||||||
|     pre_commands = {} |  | ||||||
|     post_commands = {} |  | ||||||
|     services = client.services.list() |     services = client.services.list() | ||||||
|  |     app_settings = {} | ||||||
|     for s in services: |     for s in services: | ||||||
|         labels = s.attrs['Spec']['Labels'] |         specs = s.attrs["Spec"] | ||||||
|         if (backup := labels.get('backupbot.backup')) and bool(backup): |         labels = specs["Labels"] | ||||||
|             stack_name = labels['com.docker.stack.namespace'] |         stack_name = labels["com.docker.stack.namespace"] | ||||||
|             if SERVICE and SERVICE != stack_name: |         container_name = s.name.removeprefix(f"{stack_name}_") | ||||||
|  |         version = labels.get(f"coop-cloud.{stack_name}.version") | ||||||
|  |         settings = app_settings[stack_name] = app_settings.get(stack_name) or {} | ||||||
|  |         if (backup := labels.get("backupbot.backup")) and str2bool(backup): | ||||||
|  |             settings["enabled"] = True | ||||||
|  |         if version: | ||||||
|  |             settings["version"] = version | ||||||
|  |         if selected_container and container_name not in selected_container: | ||||||
|  |             logger.debug(f"Skipping {s.name} because it's not a selected container") | ||||||
|             continue |             continue | ||||||
|             backup_apps.add(stack_name) |         if mounts := specs["TaskTemplate"]["ContainerSpec"].get("Mounts"): | ||||||
|             container = container_by_service.get(s.name) |             volumes = parse_volumes(stack_name, mounts) | ||||||
|             if not container: |             volumes.update(settings.get("volumes") or {}) | ||||||
|                 logging.error( |             settings["volumes"] = volumes | ||||||
|                     f"Container {s.name} is not running, hooks can not be executed") |             excluded_volumes, included_volume_paths = parse_excludes_includes(labels) | ||||||
|             if prehook := labels.get('backupbot.backup.pre-hook'): |             settings["excluded_volumes"] = excluded_volumes.union( | ||||||
|                 pre_commands[container] = prehook |                 settings.get("excluded_volumes") or set() | ||||||
|             if posthook := labels.get('backupbot.backup.post-hook'): |             ) | ||||||
|                 post_commands[container] = posthook |             settings["included_volume_paths"] = included_volume_paths.union( | ||||||
|             backup_paths = backup_paths.union( |                 settings.get("included_volume_paths") or set() | ||||||
|                 Path(VOLUME_PATH).glob(f"{stack_name}_*")) |             ) | ||||||
|     return pre_commands, post_commands, list(backup_paths), list(backup_apps) |         if container := container_by_service.get(s.name): | ||||||
|  |             if command := labels.get(f"backupbot.{hook_type}.pre-hook"): | ||||||
|  |                 if not (pre_hooks := settings.get("pre_hooks")): | ||||||
|  |                     pre_hooks = settings["pre_hooks"] = {} | ||||||
|  |                 pre_hooks[container] = command | ||||||
|  |             if command := labels.get(f"backupbot.{hook_type}.post-hook"): | ||||||
|  |                 if not (post_hooks := settings.get("post_hooks")): | ||||||
|  |                     post_hooks = settings["post_hooks"] = {} | ||||||
|  |                 post_hooks[container] = command | ||||||
|  |         else: | ||||||
|  |             logger.debug(f"Container {s.name} is not running.") | ||||||
|  |             if labels.get(f"backupbot.{hook_type}.pre-hook") or labels.get( | ||||||
|  |                 f"backupbot.{hook_type}.post-hook" | ||||||
|  |             ): | ||||||
|  |                 logger.error(f"Container {s.name} contain hooks but it's not running") | ||||||
|  |     return app_settings | ||||||
|  |  | ||||||
|  |  | ||||||
|  | def get_backup_details(app_settings, volumes=[]): | ||||||
|  |     backup_paths = set() | ||||||
|  |     backup_apps_versions = {} | ||||||
|  |     pre_hooks = {} | ||||||
|  |     post_hooks = {} | ||||||
|  |     for app, settings in app_settings.items(): | ||||||
|  |         if settings.get("enabled"): | ||||||
|  |             if SERVICE != "ALL" and SERVICE != app: | ||||||
|  |                 continue | ||||||
|  |             backup_apps_versions[app] = settings.get("version") | ||||||
|  |             add_backup_paths(backup_paths, settings, app, volumes) | ||||||
|  |             if hooks := settings.get("pre_hooks"): | ||||||
|  |                 pre_hooks.update(hooks) | ||||||
|  |             if hooks := settings.get("post_hooks"): | ||||||
|  |                 post_hooks.update(hooks) | ||||||
|  |     return pre_hooks, post_hooks, list(backup_paths), backup_apps_versions | ||||||
|  |  | ||||||
|  |  | ||||||
|  | def add_backup_paths(backup_paths, settings, app, selected_volumes): | ||||||
|  |     if volumes := settings.get("volumes"): | ||||||
|  |         if includes := settings.get("included_volume_paths"): | ||||||
|  |             included_volumes = list(zip(*includes))[0] | ||||||
|  |             for volume, rel_paths in includes: | ||||||
|  |                 if not (volume_path := volumes.get(volume)): | ||||||
|  |                     logger.error( | ||||||
|  |                         f"Can not find volume with the name {volume} for {app}" | ||||||
|  |                     ) | ||||||
|  |                     continue | ||||||
|  |                 if selected_volumes and volume not in selected_volumes: | ||||||
|  |                     logger.debug( | ||||||
|  |                         f"Skipping {volume}:{rel_paths} because the volume is not selected" | ||||||
|  |                     ) | ||||||
|  |                     continue | ||||||
|  |                 for p in rel_paths: | ||||||
|  |                     absolute_path = Path(f"{volume_path}/{p}") | ||||||
|  |                     backup_paths.add(absolute_path) | ||||||
|  |         else: | ||||||
|  |             included_volumes = [] | ||||||
|  |         excluded_volumes = settings.get("excluded_volumes") or [] | ||||||
|  |         for name, path in volumes.items(): | ||||||
|  |             if selected_volumes and name not in selected_volumes: | ||||||
|  |                 logger.debug( | ||||||
|  |                     f"Skipping volume: {name} because the volume is not selected" | ||||||
|  |                 ) | ||||||
|  |                 continue | ||||||
|  |             if name in excluded_volumes: | ||||||
|  |                 logger.debug(f"Skipping volume: {name} because the volume is excluded") | ||||||
|  |                 continue | ||||||
|  |             if name in included_volumes: | ||||||
|  |                 logger.debug(f"Skipping volume: {name} because a path is selected") | ||||||
|  |                 continue | ||||||
|  |             backup_paths.add(path) | ||||||
|  |     else: | ||||||
|  |         logger.warning(f"{app} does not contain any volumes") | ||||||
|  |  | ||||||
|  |  | ||||||
|  | def parse_volumes(stack_name, mounts): | ||||||
|  |     volumes = {} | ||||||
|  |     for m in mounts: | ||||||
|  |         if m["Type"] != "volume": | ||||||
|  |             continue | ||||||
|  |         relative_path = m["Source"] | ||||||
|  |         name = relative_path.removeprefix(stack_name + "_") | ||||||
|  |         absolute_path = Path(f"{VOLUME_PATH}{relative_path}/_data/") | ||||||
|  |         volumes[name] = absolute_path | ||||||
|  |     return volumes | ||||||
|  |  | ||||||
|  |  | ||||||
|  | def parse_excludes_includes(labels): | ||||||
|  |     excluded_volumes = set() | ||||||
|  |     included_volume_paths = set() | ||||||
|  |     for label, value in labels.items(): | ||||||
|  |         if label.startswith("backupbot.backup.volumes."): | ||||||
|  |             volume_name = label.removeprefix("backupbot.backup.volumes.").removesuffix( | ||||||
|  |                 ".path" | ||||||
|  |             ) | ||||||
|  |             if label.endswith("path"): | ||||||
|  |                 relative_paths = tuple(value.split(",")) | ||||||
|  |                 included_volume_paths.add((volume_name, relative_paths)) | ||||||
|  |             elif not str2bool(value): | ||||||
|  |                 excluded_volumes.add(volume_name) | ||||||
|  |     return excluded_volumes, included_volume_paths | ||||||
|  |  | ||||||
|  |  | ||||||
| def copy_secrets(apps): | def copy_secrets(apps): | ||||||
|  |     # TODO: check if it is deployed | ||||||
|     rmtree(SECRET_PATH, ignore_errors=True) |     rmtree(SECRET_PATH, ignore_errors=True) | ||||||
|     os.mkdir(SECRET_PATH) |     os.mkdir(SECRET_PATH) | ||||||
|     client = docker.from_env() |     client = docker.from_env() | ||||||
|     container_by_service = { |     container_by_service = { | ||||||
|         c.labels['com.docker.swarm.service.name']: c for c in client.containers.list()} |         c.labels.get("com.docker.swarm.service.name"): c | ||||||
|  |         for c in client.containers.list() | ||||||
|  |     } | ||||||
|     services = client.services.list() |     services = client.services.list() | ||||||
|     for s in services: |     for s in services: | ||||||
|         app_name = s.attrs['Spec']['Labels']['com.docker.stack.namespace'] |         app_name = s.attrs["Spec"]["Labels"]["com.docker.stack.namespace"] | ||||||
|         if (app_name in apps and |         if app_name in apps and ( | ||||||
|                 (app_secs := s.attrs['Spec']['TaskTemplate']['ContainerSpec'].get('Secrets'))): |             app_secs := s.attrs["Spec"]["TaskTemplate"]["ContainerSpec"].get("Secrets") | ||||||
|  |         ): | ||||||
|             if not container_by_service.get(s.name): |             if not container_by_service.get(s.name): | ||||||
|                 logging.error( |                 logger.warning( | ||||||
|                     f"Container {s.name} is not running, secrets can not be copied.") |                     f"Container {s.name} is not running, secrets can not be copied." | ||||||
|  |                 ) | ||||||
|                 continue |                 continue | ||||||
|             container_id = container_by_service[s.name].id |             container_id = container_by_service[s.name].id | ||||||
|             for sec in app_secs: |             for sec in app_secs: | ||||||
|                 src = f'/var/lib/docker/containers/{container_id}/mounts/secrets/{sec["SecretID"]}' |                 src = f"/var/lib/docker/containers/{container_id}/mounts/secrets/{sec['SecretID']}" | ||||||
|                 dst = SECRET_PATH + sec['SecretName'] |                 if not Path(src).exists(): | ||||||
|  |                     logger.error( | ||||||
|  |                         f"For the secret {sec['SecretName']} the file {src} does not exist for {s.name}" | ||||||
|  |                     ) | ||||||
|  |                     continue | ||||||
|  |                 dst = SECRET_PATH + sec["SecretName"] | ||||||
|  |                 logger.debug(f"Copy Secret {sec['SecretName']}") | ||||||
|                 copyfile(src, dst) |                 copyfile(src, dst) | ||||||
|  |  | ||||||
|  |  | ||||||
| @ -127,148 +435,215 @@ def run_commands(commands): | |||||||
|     for container, command in commands.items(): |     for container, command in commands.items(): | ||||||
|         if not command: |         if not command: | ||||||
|             continue |             continue | ||||||
|  |         # Remove bash/sh wrapping | ||||||
|  |         command = ( | ||||||
|  |             command.removeprefix("bash -c").removeprefix("sh -c").removeprefix(" ") | ||||||
|  |         ) | ||||||
|  |         # Remove quotes surrounding the command | ||||||
|  |         if ( | ||||||
|  |             len(command) >= 2 | ||||||
|  |             and command[0] == command[-1] | ||||||
|  |             and (command[0] == "'" or command[0] == '"') | ||||||
|  |         ): | ||||||
|  |             command = command[1:-1] | ||||||
|         # Use bash's pipefail to return exit codes inside a pipe to prevent silent failure |         # Use bash's pipefail to return exit codes inside a pipe to prevent silent failure | ||||||
|         command = command.removeprefix('bash -c \'').removeprefix('sh -c \'') |  | ||||||
|         command = command.removesuffix('\'') |  | ||||||
|         command = f"bash -c 'set -o pipefail;{command}'" |         command = f"bash -c 'set -o pipefail;{command}'" | ||||||
|  |         logger.info(f"run command in {container.name}:") | ||||||
|  |         logger.info(command) | ||||||
|         result = container.exec_run(command) |         result = container.exec_run(command) | ||||||
|         logging.info(f"run command in {container.name}") |  | ||||||
|         logging.info(command) |  | ||||||
|         if result.exit_code: |         if result.exit_code: | ||||||
|             logging.error( |             logger.error( | ||||||
|                 f"Failed to run command {command} in {container.name}: {result.output.decode()}") |                 f"Failed to run command {command} in {container.name}: {result.output.decode()}" | ||||||
|  |             ) | ||||||
|         else: |         else: | ||||||
|             logging.info(result.output.decode()) |             logger.debug(result.output.decode()) | ||||||
|  |  | ||||||
|  |  | ||||||
| def backup_volumes(backup_paths, apps, dry_run=False): | def backup_volumes(backup_paths, apps_versions, retries, dry_run=False): | ||||||
|     result = restic.backup(backup_paths, dry_run=dry_run, tags=apps) |     while True: | ||||||
|     print(result) |         try: | ||||||
|     logging.info(result) |             logger.info("Backup these paths:") | ||||||
|  |             logger.info("\n".join(map(str, backup_paths))) | ||||||
|  |             backup_paths = list(filter(path_exists, backup_paths)) | ||||||
| @cli.command() |             cmd = restic.cat.base_command() | ||||||
| @click.option('snapshot', '--snapshot', '-s', envvar='SNAPSHOT', default='latest') |             parent = get_snapshots("latest") | ||||||
| @click.option('target', '--target', '-t', envvar='TARGET', default='/') |             if parent: | ||||||
| @click.option('noninteractive', '--noninteractive', envvar='NONINTERACTIVE', default=False) |                 # https://restic.readthedocs.io/en/stable/040_backup.html#file-change-detection | ||||||
| def restore(snapshot, target, noninteractive): |                 cmd.extend(["--parent", parent[0]["short_id"]]) | ||||||
|     # Todo: recommend to shutdown the container |             tags = [f"{app}:{version}" for app, version in apps_versions.items()] | ||||||
|     service_paths = VOLUME_PATH |             if SERVICE == "ALL": | ||||||
|     if SERVICE: |                 tags.append(SERVICE) | ||||||
|         service_paths = service_paths + f'{SERVICE}_*' |             logger.info("Start volume backup") | ||||||
|     snapshots = restic.snapshots(snapshot_id=snapshot) |             result = restic.internal.backup.run( | ||||||
|     if not snapshot: |                 cmd, backup_paths, dry_run=dry_run, tags=tags | ||||||
|         logging.error("No Snapshots with ID {snapshots}") |             ) | ||||||
|  |             logger.summary("backup finished", extra=result) | ||||||
|  |             return | ||||||
|  |         except ResticFailedError as error: | ||||||
|  |             logger.error(f"Backup failed for {SERVICE}.") | ||||||
|  |             logger.error(error, exc_info=True) | ||||||
|  |             if retries > 0: | ||||||
|  |                 retries -= 1 | ||||||
|  |             else: | ||||||
|                 exit(1) |                 exit(1) | ||||||
|     if not noninteractive: |  | ||||||
|         snapshot_date = datetime.fromisoformat(snapshots[0]['time']) |  | ||||||
|         delta = datetime.now(tz=timezone.utc) - snapshot_date | def path_exists(path): | ||||||
|         print(f"You are going to restore Snapshot {snapshot} of {service_paths} at {target}") |     if not path.exists(): | ||||||
|         print(f"This snapshot is {delta} old") |         logger.error(f"{path} does not exist") | ||||||
|         print(f"THIS COMMAND WILL IRREVERSIBLY OVERWRITES {target}{service_paths.removeprefix('/')}") |     return path.exists() | ||||||
|         prompt = input("Type YES (uppercase) to continue: ") |  | ||||||
|         if prompt != 'YES': |  | ||||||
|             logging.error("Restore aborted") |  | ||||||
|             exit(1) |  | ||||||
|     print(f"Restoring Snapshot {snapshot} of {service_paths} at {target}") |  | ||||||
|     result = restic.restore(snapshot_id=snapshot, |  | ||||||
|                             include=service_paths, target_dir=target) |  | ||||||
|     logging.debug(result) |  | ||||||
|  |  | ||||||
|  |  | ||||||
| @cli.command() | @cli.command() | ||||||
| def snapshots(): | def snapshots(): | ||||||
|     snapshots = restic.snapshots() |     snapshots = get_snapshots() | ||||||
|     for snap in snapshots: |     for snap in snapshots: | ||||||
|         if not SERVICE or (tags := snap.get('tags')) and SERVICE in tags: |         output = [snap["time"].split(".")[0], snap["short_id"]] | ||||||
|             print(snap['time'], snap['id']) |         if tags := snap.get("tags"): | ||||||
|  |             app_versions = app_versions_from_tags(tags) | ||||||
|  |             if version := app_versions.get(SERVICE): | ||||||
|  |                 output.append(version) | ||||||
|  |         print(*output) | ||||||
|  |     if not snapshots: | ||||||
|  |         err_msg = "No Snapshots found" | ||||||
|  |         if SERVICE != "ALL": | ||||||
|  |             service_name = SERVICE.replace("_", ".") | ||||||
|  |             err_msg += f" for app {service_name}" | ||||||
|  |         logger.warning(err_msg) | ||||||
|  |  | ||||||
|  |  | ||||||
| @cli.command() | @cli.command() | ||||||
| @click.option('snapshot', '--snapshot', '-s', envvar='SNAPSHOT', default='latest') | @click.option("snapshot", "--snapshot", "-s", envvar="SNAPSHOT", default="latest") | ||||||
| @click.option('path', '--path', '-p', envvar='INCLUDE_PATH') | @click.option("show_all", "--all", "-a", envvar="SHOW_ALL", is_flag=True) | ||||||
| def ls(snapshot, path): | @click.option("timestamps", "--timestamps", "-t", envvar="TIMESTAMPS", is_flag=True) | ||||||
|  | @click.argument( | ||||||
|  |     "path", required=False, default="/var/lib/docker/volumes/", envvar="INCLUDE_PATH" | ||||||
|  | ) | ||||||
|  | def ls(snapshot, show_all, timestamps, path): | ||||||
|  |     if snapshot == "latest": | ||||||
|  |         latest_snapshot = get_snapshots("latest") | ||||||
|  |         if not latest_snapshot: | ||||||
|  |             logger.error(f"There is no latest snapshot for {SERVICE}") | ||||||
|  |             exit(1) | ||||||
|  |         snapshot = latest_snapshot[0]["short_id"] | ||||||
|  |     if show_all: | ||||||
|  |         path = None | ||||||
|     results = list_files(snapshot, path) |     results = list_files(snapshot, path) | ||||||
|     for r in results: |     for r in results: | ||||||
|         if r.get('path'): |         if r.get("path"): | ||||||
|  |             if timestamps: | ||||||
|                 print(f"{r['ctime']}\t{r['path']}") |                 print(f"{r['ctime']}\t{r['path']}") | ||||||
|  |             else: | ||||||
|  |                 print(f"{r['path']}") | ||||||
|  |  | ||||||
|  |  | ||||||
| def list_files(snapshot, path): | def list_files(snapshot, path): | ||||||
|     cmd = restic.cat.base_command() + ['ls'] |     cmd = restic.cat.base_command() + ["ls"] | ||||||
|     if SERVICE: |  | ||||||
|         cmd = cmd + ['--tag', SERVICE] |  | ||||||
|     cmd.append(snapshot) |     cmd.append(snapshot) | ||||||
|     if path: |     if path: | ||||||
|         cmd.append(path) |         cmd.append(path) | ||||||
|  |     try: | ||||||
|         output = restic.internal.command_executor.execute(cmd) |         output = restic.internal.command_executor.execute(cmd) | ||||||
|     output = output.replace('}\n{', '}|{') |     except ResticFailedError as error: | ||||||
|     results = list(map(json.loads, output.split('|'))) |         if "no snapshot found" in str(error): | ||||||
|  |             err_msg = f'There is no snapshot "{snapshot}"' | ||||||
|  |             if SERVICE != "ALL": | ||||||
|  |                 err_msg += f' for the app "{SERVICE}"' | ||||||
|  |             logger.error(err_msg) | ||||||
|  |             exit(1) | ||||||
|  |         else: | ||||||
|  |             raise error | ||||||
|  |     output = output.replace("}\n{", "}|{") | ||||||
|  |     results = list(map(json.loads, output.split("|"))) | ||||||
|     return results |     return results | ||||||
|  |  | ||||||
|  |  | ||||||
| @cli.command() | @cli.command() | ||||||
| @click.option('snapshot', '--snapshot', '-s', envvar='SNAPSHOT', default='latest') | @click.option("snapshot", "--snapshot", "-s", envvar="SNAPSHOT", default="latest") | ||||||
| @click.option('path', '--path', '-p', envvar='INCLUDE_PATH') | @click.option("path", "--path", "-p", envvar="INCLUDE_PATH") | ||||||
| @click.option('volumes', '--volumes', '-v', is_flag=True) | @click.option("volumes", "--volumes", "-v", envvar="VOLUMES") | ||||||
| @click.option('secrets', '--secrets', '-c', is_flag=True) | @click.option("secrets", "--secrets", "-c", is_flag=True, envvar="SECRETS") | ||||||
| def download(snapshot, path, volumes, secrets): | def download(snapshot, path, volumes, secrets): | ||||||
|     if sum(map(bool, [path, volumes, secrets])) != 1: |     file_dumps = [] | ||||||
|         logging.error("Please specify exactly one of '--path', '--volumes', '--secrets'") |     if snapshot == "latest": | ||||||
|  |         latest_snapshot = get_snapshots("latest") | ||||||
|  |         if not latest_snapshot: | ||||||
|  |             logger.error(f"There is no latest snapshot for {SERVICE}") | ||||||
|             exit(1) |             exit(1) | ||||||
|  |         snapshot = latest_snapshot[0]["short_id"] | ||||||
|  |     if not any([path, volumes, secrets]): | ||||||
|  |         volumes = secrets = True | ||||||
|     if path: |     if path: | ||||||
|         path = path.removesuffix('/') |         path = path.removesuffix("/") | ||||||
|  |         binary_output = dump(snapshot, path) | ||||||
|         files = list_files(snapshot, path) |         files = list_files(snapshot, path) | ||||||
|         filetype = [f.get('type') for f in files if f.get('path') == path][0] |         filetype = [f.get("type") for f in files if f.get("path") == path][0] | ||||||
|         filename = "/tmp/" + Path(path).name |         filename = Path(path).name | ||||||
|         if filetype == 'dir': |         if filetype == "dir": | ||||||
|             filename = filename + ".tar" |             filename = filename + ".tar" | ||||||
|         output = dump(snapshot, path) |         tarinfo = tarfile.TarInfo(name=filename) | ||||||
|         with open(filename, "wb") as file: |         tarinfo.size = len(binary_output) | ||||||
|             file.write(output) |         file_dumps.append((binary_output, tarinfo)) | ||||||
|         print(filename) |     if volumes: | ||||||
|     elif volumes: |         if SERVICE == "ALL": | ||||||
|         if not SERVICE: |             logger.error("Please specify '--host' when using '--volumes'") | ||||||
|             logging.error("Please specify '--host' when using '--volumes'") |  | ||||||
|             exit(1) |             exit(1) | ||||||
|         filename = f"/tmp/{SERVICE}.tar" |  | ||||||
|         files = list_files(snapshot, VOLUME_PATH) |         files = list_files(snapshot, VOLUME_PATH) | ||||||
|         for f in files[1:]: |         for f in files[1:]: | ||||||
|             path = f[ 'path' ] |             path = f["path"] | ||||||
|             if SERVICE in path and f['type'] == 'dir': |             if Path(path).name.startswith(SERVICE) and f["type"] == "dir": | ||||||
|                 content = dump(snapshot, path) |                 binary_output = dump(snapshot, path) | ||||||
|                 # Concatenate tar files (extract with tar -xi) |                 filename = f"{Path(path).name}.tar" | ||||||
|                 with open(filename, "ab") as file: |                 tarinfo = tarfile.TarInfo(name=filename) | ||||||
|                     file.write(content) |                 tarinfo.size = len(binary_output) | ||||||
|     elif secrets: |                 file_dumps.append((binary_output, tarinfo)) | ||||||
|         if not SERVICE: |     if secrets: | ||||||
|             logging.error("Please specify '--host' when using '--secrets'") |         if SERVICE == "ALL": | ||||||
|  |             logger.error("Please specify '--host' when using '--secrets'") | ||||||
|             exit(1) |             exit(1) | ||||||
|         filename = f"/tmp/SECRETS_{SERVICE}.json" |         filename = f"{SERVICE}.json" | ||||||
|         files = list_files(snapshot, SECRET_PATH) |         files = list_files(snapshot, SECRET_PATH) | ||||||
|         secrets = {} |         secrets = {} | ||||||
|         for f in files[1:]: |         for f in files[1:]: | ||||||
|             path = f[ 'path' ] |             path = f["path"] | ||||||
|             if SERVICE in path and f['type'] == 'file': |             if Path(path).name.startswith(SERVICE) and f["type"] == "file": | ||||||
|                 secret = dump(snapshot, path).decode() |                 secret = dump(snapshot, path).decode() | ||||||
|                 secret_name = path.removeprefix(f'{SECRET_PATH}{SERVICE}_') |                 secret_name = path.removeprefix(f"{SECRET_PATH}{SERVICE}_") | ||||||
|                 secrets[secret_name] = secret |                 secrets[secret_name] = secret | ||||||
|         with open(filename, "w") as file: |         binary_output = json.dumps(secrets).encode() | ||||||
|             json.dump(secrets, file) |         tarinfo = tarfile.TarInfo(name=filename) | ||||||
|         print(filename) |         tarinfo.size = len(binary_output) | ||||||
|  |         file_dumps.append((binary_output, tarinfo)) | ||||||
|  |     with tarfile.open("/tmp/backup.tar.gz", "w:gz") as tar: | ||||||
|  |         print(f"Writing files to /tmp/backup.tar.gz...") | ||||||
|  |         for binary_output, tarinfo in file_dumps: | ||||||
|  |             tar.addfile(tarinfo, fileobj=io.BytesIO(binary_output)) | ||||||
|  |     size = get_formatted_size("/tmp/backup.tar.gz") | ||||||
|  |     print(f"Backup has been written to /tmp/backup.tar.gz with a size of {size}") | ||||||
|  |  | ||||||
|  |  | ||||||
|  | def get_formatted_size(file_path): | ||||||
|  |     file_size = os.path.getsize(file_path) | ||||||
|  |     units = ["Bytes", "KB", "MB", "GB", "TB"] | ||||||
|  |     for unit in units: | ||||||
|  |         if file_size < 1024: | ||||||
|  |             return f"{round(file_size, 3)} {unit}" | ||||||
|  |         file_size /= 1024 | ||||||
|  |     return f"{round(file_size, 3)} {units[-1]}" | ||||||
|  |  | ||||||
|  |  | ||||||
| def dump(snapshot, path): | def dump(snapshot, path): | ||||||
|     cmd = restic.cat.base_command() + ['dump'] |     cmd = restic.cat.base_command() + ["dump"] | ||||||
|     if SERVICE: |  | ||||||
|         cmd = cmd + ['--tag', SERVICE] |  | ||||||
|     cmd = cmd + [snapshot, path] |     cmd = cmd + [snapshot, path] | ||||||
|     logging.debug(f"Dumping {path} from snapshot '{snapshot}'") |     print(f"Dumping {path} from snapshot '{snapshot}'") | ||||||
|     output = subprocess.run(cmd, capture_output=True) |     output = subprocess.run(cmd, capture_output=True) | ||||||
|     if output.returncode: |     if output.returncode: | ||||||
|         logging.error(f"error while dumping {path} from snapshot '{snapshot}': {output.stderr}") |         logger.error( | ||||||
|  |             f"error while dumping {path} from snapshot '{snapshot}': {output.stderr}" | ||||||
|  |         ) | ||||||
|         exit(1) |         exit(1) | ||||||
|     return output.stdout |     return output.stdout | ||||||
|  |  | ||||||
|  |  | ||||||
| if __name__ == '__main__': | if __name__ == "__main__": | ||||||
|     cli() |     cli() | ||||||
|  | |||||||
							
								
								
									
										11
									
								
								compose.pushbasicauth.yml
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										11
									
								
								compose.pushbasicauth.yml
									
									
									
									
									
										Normal file
									
								
							| @ -0,0 +1,11 @@ | |||||||
|  | --- | ||||||
|  | version: "3.8" | ||||||
|  | services: | ||||||
|  |   app: | ||||||
|  |     secrets: | ||||||
|  |       - push_basicauth | ||||||
|  |  | ||||||
|  | secrets: | ||||||
|  |   push_basicauth: | ||||||
|  |     external: true | ||||||
|  |     name: ${STACK_NAME}_push_basicauth_${SECRET_PUSH_BASICAUTH} | ||||||
| @ -3,7 +3,7 @@ version: "3.8" | |||||||
| services: | services: | ||||||
|   app: |   app: | ||||||
|     environment: |     environment: | ||||||
|       - RESTIC_REPO_FILE=/run/secrets/restic_repo |       - RESTIC_REPOSITORY_FILE=/run/secrets/restic_repo | ||||||
|     secrets: |     secrets: | ||||||
|       - restic_repo |       - restic_repo | ||||||
|  |  | ||||||
|  | |||||||
							
								
								
									
										36
									
								
								compose.yml
									
									
									
									
									
								
							
							
						
						
									
										36
									
								
								compose.yml
									
									
									
									
									
								
							| @ -2,7 +2,7 @@ | |||||||
| version: "3.8" | version: "3.8" | ||||||
| services: | services: | ||||||
|   app: |   app: | ||||||
|     image: docker:24.0.2-dind |     image: git.coopcloud.tech/coop-cloud/backup-bot-two:2.3.0-beta | ||||||
|     volumes: |     volumes: | ||||||
|       - "/var/run/docker.sock:/var/run/docker.sock" |       - "/var/run/docker.sock:/var/run/docker.sock" | ||||||
|       - "/var/lib/docker/volumes/:/var/lib/docker/volumes/" |       - "/var/lib/docker/volumes/:/var/lib/docker/volumes/" | ||||||
| @ -10,23 +10,23 @@ services: | |||||||
|       - backups:/backups |       - backups:/backups | ||||||
|     environment: |     environment: | ||||||
|       - CRON_SCHEDULE |       - CRON_SCHEDULE | ||||||
|       - RESTIC_REPO |       - RESTIC_REPOSITORY | ||||||
|       - RESTIC_PASSWORD_FILE=/run/secrets/restic_password |       - RESTIC_PASSWORD_FILE=/run/secrets/restic_password | ||||||
|     secrets: |     secrets: | ||||||
|       - restic_password |       - restic_password | ||||||
|     deploy: |  | ||||||
|       labels: |  | ||||||
|         - coop-cloud.${STACK_NAME}.version=0.1.0+latest |  | ||||||
|         - coop-cloud.${STACK_NAME}.timeout=${TIMEOUT:-300} |  | ||||||
|         - coop-cloud.backupbot.enabled=true |  | ||||||
|     configs: |     configs: | ||||||
|       - source: entrypoint |       - source: entrypoint | ||||||
|         target: /entrypoint.sh |         target: /entrypoint.sh | ||||||
|         mode: 0555 |         mode: 666 | ||||||
|       - source: backupbot |       - source: cronjob | ||||||
|         target: /usr/bin/backup |         target: /cronjob.sh | ||||||
|         mode: 0555 |         mode: 666 | ||||||
|     entrypoint: ['/entrypoint.sh'] |     deploy: | ||||||
|  |       labels: | ||||||
|  |         - coop-cloud.${STACK_NAME}.version=2.3.0+2.3.0-beta | ||||||
|  |         - coop-cloud.${STACK_NAME}.timeout=${TIMEOUT:-300} | ||||||
|  |         - coop-cloud.backupbot.enabled=true | ||||||
|  |     #entrypoint: ['tail', '-f','/dev/null'] | ||||||
|     healthcheck: |     healthcheck: | ||||||
|       test: "pgrep crond" |       test: "pgrep crond" | ||||||
|       interval: 30s |       interval: 30s | ||||||
| @ -39,13 +39,13 @@ secrets: | |||||||
|     external: true |     external: true | ||||||
|     name: ${STACK_NAME}_restic_password_${SECRET_RESTIC_PASSWORD_VERSION} |     name: ${STACK_NAME}_restic_password_${SECRET_RESTIC_PASSWORD_VERSION} | ||||||
|  |  | ||||||
| volumes: |  | ||||||
|   backups: |  | ||||||
|  |  | ||||||
| configs: | configs: | ||||||
|   entrypoint: |   entrypoint: | ||||||
|     name: ${STACK_NAME}_entrypoint_${ENTRYPOINT_VERSION} |     name: ${STACK_NAME}_entrypoint_${ENTRYPOINT_VERSION} | ||||||
|     file: entrypoint.sh |     file: entrypoint.sh | ||||||
|   backupbot: |   cronjob: | ||||||
|     name: ${STACK_NAME}_backupbot_${BACKUPBOT_VERSION} |     name: ${STACK_NAME}_cronjob_${CRONJOB_VERSION} | ||||||
|     file: backupbot.py |     file: cronjob.sh | ||||||
|  |  | ||||||
|  | volumes: | ||||||
|  |   backups: | ||||||
|  | |||||||
							
								
								
									
										40
									
								
								cronjob.sh
									
									
									
									
									
										Executable file
									
								
							
							
						
						
									
										40
									
								
								cronjob.sh
									
									
									
									
									
										Executable file
									
								
							| @ -0,0 +1,40 @@ | |||||||
|  | #!/bin/sh | ||||||
|  |  | ||||||
|  | set -e | ||||||
|  |  | ||||||
|  | CURL_OPTS="-s" | ||||||
|  | # Check for basic auth | ||||||
|  | if [ -n "$(cat /run/secrets/push_basicauth)" ] | ||||||
|  | then | ||||||
|  |     CURL_OPTS="$CURL_OPTS -u $(cat /run/secrets/push_basicauth)" | ||||||
|  | fi | ||||||
|  |  | ||||||
|  | if [ -n "$PUSH_PROMETHEUS_URL" ] | ||||||
|  | then | ||||||
|  |     push_start_notification="(echo 'backup 1' | curl $CURL_OPTS --data-binary @- $PUSH_PROMETHEUS_URL)" | ||||||
|  |     push_success_notification="(echo 'backup 0' | curl $CURL_OPTS --data-binary @- $PUSH_PROMETHEUS_URL)" | ||||||
|  |     push_fail_notification="(echo 'backup -1' | curl $CURL_OPTS --data-binary @- $PUSH_PROMETHEUS_URL)" | ||||||
|  | else | ||||||
|  |     if [ -n "$PUSH_URL_START" ] | ||||||
|  |     then | ||||||
|  |         push_start_notification="curl $CURL_OPTS '$PUSH_URL_START'" | ||||||
|  |     fi | ||||||
|  |  | ||||||
|  |     if [ -n "$PUSH_URL_FAIL" ] | ||||||
|  |     then | ||||||
|  |         push_fail_notification="curl $CURL_OPTS '$PUSH_URL_FAIL'" | ||||||
|  |     fi | ||||||
|  |  | ||||||
|  |     if [ -n "$PUSH_URL_SUCCESS" ] | ||||||
|  |     then | ||||||
|  |         push_success_notification="curl $CURL_OPTS '$PUSH_URL_SUCCESS'" | ||||||
|  |     fi | ||||||
|  | fi | ||||||
|  |  | ||||||
|  | eval "$push_start_notification" | ||||||
|  | if [ "$(backup --machine-logs create  2>&1 | tee /tmp/backup.log && (grep -q 'backup finished' /tmp/backup.log))" ] | ||||||
|  | then | ||||||
|  |     eval "$push_success_notification" | ||||||
|  | else | ||||||
|  |     eval "$push_fail_notification" | ||||||
|  | fi | ||||||
							
								
								
									
										9
									
								
								entrypoint.sh
									
									
									
									
									
										
										
										Normal file → Executable file
									
								
							
							
						
						
									
										9
									
								
								entrypoint.sh
									
									
									
									
									
										
										
										Normal file → Executable file
									
								
							| @ -1,11 +1,6 @@ | |||||||
| #!/bin/sh | #!/bin/sh | ||||||
|  |  | ||||||
| set -e -o pipefail | set -e | ||||||
|  |  | ||||||
| apk add --upgrade --no-cache restic bash python3 py3-pip |  | ||||||
|  |  | ||||||
| # Todo use requirements file with specific versions |  | ||||||
| pip install click==8.1.7 docker==6.1.3 resticpy==1.0.2 |  | ||||||
|  |  | ||||||
| if [ -n "$SSH_HOST_KEY" ] | if [ -n "$SSH_HOST_KEY" ] | ||||||
| then | then | ||||||
| @ -14,7 +9,7 @@ fi | |||||||
|  |  | ||||||
| cron_schedule="${CRON_SCHEDULE:?CRON_SCHEDULE not set}" | cron_schedule="${CRON_SCHEDULE:?CRON_SCHEDULE not set}" | ||||||
|  |  | ||||||
| echo "$cron_schedule backup create" | crontab - | echo "$cron_schedule /cronjob.sh" | crontab - | ||||||
| crontab -l | crontab -l | ||||||
|  |  | ||||||
| crond -f -d8 -L /dev/stdout | crond -f -d8 -L /dev/stdout | ||||||
|  | |||||||
							
								
								
									
										34
									
								
								pg_backup.sh
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										34
									
								
								pg_backup.sh
									
									
									
									
									
										Normal file
									
								
							| @ -0,0 +1,34 @@ | |||||||
|  | #!/bin/bash | ||||||
|  |  | ||||||
|  | set -e | ||||||
|  |  | ||||||
|  | BACKUP_FILE='/var/lib/postgresql/data/backup.sql' | ||||||
|  |  | ||||||
|  | function backup { | ||||||
|  |   export PGPASSWORD=$(cat $POSTGRES_PASSWORD_FILE) | ||||||
|  |   pg_dump -U ${POSTGRES_USER} ${POSTGRES_DB} > $BACKUP_FILE | ||||||
|  | } | ||||||
|  |  | ||||||
|  | function restore { | ||||||
|  |     cd /var/lib/postgresql/data/ | ||||||
|  |     restore_config(){ | ||||||
|  |         # Restore allowed connections | ||||||
|  |         cat pg_hba.conf.bak > pg_hba.conf | ||||||
|  |         su postgres -c 'pg_ctl reload' | ||||||
|  |     } | ||||||
|  |     # Don't allow any other connections than local | ||||||
|  |     cp pg_hba.conf pg_hba.conf.bak | ||||||
|  |     echo "local all all trust" > pg_hba.conf | ||||||
|  |     su postgres -c 'pg_ctl reload' | ||||||
|  |     trap restore_config EXIT INT TERM | ||||||
|  |  | ||||||
|  |     # Recreate Database | ||||||
|  |     psql -U ${POSTGRES_USER} -d postgres -c "DROP DATABASE ${POSTGRES_DB} WITH (FORCE);"  | ||||||
|  |     createdb -U ${POSTGRES_USER} ${POSTGRES_DB} | ||||||
|  |     psql -U ${POSTGRES_USER} -d ${POSTGRES_DB} -1 -f $BACKUP_FILE | ||||||
|  |  | ||||||
|  |     trap - EXIT INT TERM | ||||||
|  |     restore_config | ||||||
|  | } | ||||||
|  |  | ||||||
|  | $@ | ||||||
							
								
								
									
										1
									
								
								release/1.0.0+2.0.0-beta
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										1
									
								
								release/1.0.0+2.0.0-beta
									
									
									
									
									
										Normal file
									
								
							| @ -0,0 +1 @@ | |||||||
|  | This is the first beta release of the new backup-bot-two rewrite in python. Be aware when updating, it can break. Please read the readme and update your config according to it. | ||||||
| @ -1,3 +1,3 @@ | |||||||
| Breaking Change: the variables `SERVER_NAME` and `RESTIC_HOST` are merged into `RESTIC_REPO`. The format can be looked up here: https://restic.readthedocs.io/en/stable/030_preparing_a_new_repo.html | Breaking Change: the variables `SERVER_NAME` and `RESTIC_HOST` are merged into `RESTIC_REPOSITORY`. The format can be looked up here: https://restic.readthedocs.io/en/stable/030_preparing_a_new_repo.html | ||||||
| ssh/sftp: `sftp:user@host:/repo-path` | ssh/sftp: `sftp:user@host:/repo-path` | ||||||
| S3:  `s3:https://s3.example.com/bucket_name` | S3:  `s3:https://s3.example.com/bucket_name` | ||||||
|  | |||||||
		Reference in New Issue
	
	Block a user