Update HOWTO

Dockerfile

@@ -5,9 +5,9 @@ FROM alpine:latest AS final
 # RUN pacman --noconfirm -Syu duplicity python-pip python-pydrive2
 ENV CARGO_NET_GIT_FETCH_WITH_CLI=true
 RUN \
-  apk add py3-pip python3-dev gcc libffi-dev musl-dev openssl-dev pkgconfig duplicity rust cargo git && \
-  pip install --upgrade pip && \
-  pip install pydrive2 && \
+  apk add py3-pip python3-dev gcc libffi-dev musl-dev openssl-dev pkgconfig duplicity rust cargo git curl && \
+  pip install --upgrade pip --break-system-packages && \
+  pip install pydrive2 --break-system-packages && \
   apk del rust musl-dev libffi-dev gcc python3-dev cargo git pkgconfig openssl-dev
 
 WORKDIR /usr/lib/duplicity
@@ -32,3 +32,5 @@ LABEL org.opencontainers.image.authors="Stefano Pigozzi <me@steffo.eu>"
 # Configure duplicity
 ENV DUPLICITY_FULL_IF_OLDER_THAN=1M
 
+ENV NTFY=""
+ENV NTFY_TAGS=""

README.md

@@ -18,10 +18,11 @@ Backup solution for Docker volumes based on Duplicity
 
 ### Backup
 
-1. Create a new volume in Docker with the name `duplicity_credentials`:
+1. Create two new volumes in Docker with the names `duplicity_credentials` and `duplicity_cache`:
 
     ```console
     # docker volume create duplicity_credentials
+    # docker volume create duplicity_cache
     ```
 
 2. Create a new file in the host system with the name `/root/secrets/backup/passphrase.txt`, and enter in it a secure passphrase to use to encrypt files:

backup.sh

@@ -8,8 +8,47 @@ set -e
 export PASSPHRASE=$(cat "${DUPLICITY_PASSPHRASE_FILE}")
 
 echo "Launched in backup mode, performing backup..." >> /dev/stderr
+
+if [ -n "${NTFY}" ]; then
+	echo "Sending ntfy backup start notification..." >> /dev/stderr
+	curl "${NTFY}" \
+		--silent \
+		--header "X-Title: Backup started" \
+		--data "Duplicity is attempting to perform a backup to **${DUPLICITY_TARGET_URL}**..." \
+		--header "X-Priority: min" \
+		--header "X-Tags: arrow_heading_up,${NTFY_TAGS}" \
+		--header "Content-Type: text/markdown"
+fi
+
 duplicity \
 	--allow-source-mismatch \
 	--full-if-older-than "${DUPLICITY_FULL_IF_OLDER_THAN}" \
 	/mnt \
 	"${DUPLICITY_TARGET_URL}"
+
+backup_result=$?
+
+if [ -n "${NTFY}" ]; then
+	case "$backup_result" in
+		0)
+			echo "Sending ntfy backup complete notification..." >> /dev/stderr
+			curl "${NTFY}" \
+				--silent \
+				--header "X-Title: Backup complete" \
+				--data "Duplicity has successfully performed a backup to **${DUPLICITY_TARGET_URL}**!" \
+				--header "X-Priority: low" \
+				--header "X-Tags: white_check_mark,${NTFY_TAGS}" \
+				--header "Content-Type: text/markdown"
+		;;
+		*)
+			echo "Sending ntfy backup failed notification..." >> /dev/stderr
+			curl "${NTFY}" \
+				--silent \
+				--header "X-Title: Backup failed" \
+				--data "Duplicity failed to perform a backup to **${DUPLICITY_TARGET_URL}**, and exited with status code **${backup_result}**." \
+				--header "X-Priority: max" \
+				--header "X-Tags: sos,${NTFY_TAGS}" \
+				--header "Content-Type: text/markdown"
+		;;
+	esac
+fi

gdrive.docker-compose.yml

@@ -7,6 +7,8 @@ secrets:
 volumes:
   duplicity_credentials:
     external: true
+  duplicity_cache:
+    external: true
 
 services:
   duplicity:
@@ -17,11 +19,14 @@ services:
     volumes:
       - "./exampledata:/mnt/example"
       - "duplicity_credentials:/var/lib/duplicity"
+      - "duplicity_cache:/usr/lib/duplicity/.cache/duplicity"
     environment:
       MODE: "backup"
       DUPLICITY_PASSPHRASE_FILE: "/run/secrets/duplicity_passphrase"
       DUPLICITY_TARGET_URL: "pydrive://641079776729-90s4tnli0ao913ajrpv8cp3c4kkk77j5.apps.googleusercontent.com/Duplicity/this"
       GOOGLE_DRIVE_SETTINGS: "/run/secrets/google_client_config"
+      NTFY: "https://ntfy.sh/garasauto"
+      NTFY_TAGS: "garasauto"
     secrets:
       - google_client_config
       - duplicity_passphrase