Experimental backupbot support

Reviewed-on: #23

.drone.yml

@@ -10,7 +10,7 @@ steps:
         from_secret: drone_abra-bot_token
       fork: true
       repositories:
-        - coop-cloud/auto-recipes-catalogue-json
+        - toolshed/auto-recipes-catalogue-json
 
 trigger:
   event: tag

.env.sample

@@ -31,6 +31,9 @@ TRAEFIK_STACK_NAME=traefik_example_com
 # OPTIONAL SETTINGS                                                           #
 ###############################################################################
 
+# Uncomment this to reënable STARTTLS, although beware the health warnings here: https://nostarttls.secvuln.info/
+#PORTS=25,80,443,465,993,995,4190,110,143,587
+
 # Name of the instance, displayed in the web UI
 SITENAME=mymail
 

README.md

@@ -25,11 +25,28 @@ host.
 4. `abra app config YOURAPPDOMAIN` - be sure to change `$WEB_DOMAIN` to something that resolves to
    your Docker swarm box
 5. `abra app deploy YOURAPPDOMAIN`
-9. Create initial user:
+6. Create initial user:
 ```
 abra app run YOURDOMAIN admin flask mailu admin admin YOURDOMAIN YOURPASSWORD
 ```
 
+## Upgrading the recipe
+
+**NOTE** This section is only intended for [recipe maintainers][maintainers]
+
+Minor/patch updates usually work OK with `abra recipe upgrade` and friends. 
+
+For major updates:
+
+1. Go to https://setup.mailu.io/ and generate a new config
+2. Download the new config and compare it to `compose.yml`. Pay attention to:
+  - New / removed services
+  - Added/removed config options
+  - Changes to networking
+3. Test upgrading from the previous version to the new version
+4. `abra recipe sync` / `abra recipe release` as normal
+
 [Mailu]: https://mailu.io/
 [abra]: https://git.autonomic.zone/autonomic-cooperative/abra
 [compose-traefik]: https://git.autonomic.zone/coop-cloud/traefik
+[maintainers]: https://docs.coopcloud.tech/maintainers/

abra.sh

@@ -1,3 +1,4 @@
 export CERTDUMPER_POST_VERSION=v1
 export POSTFIX_OVERRIDE_VERSION=v17
 export SENDER_LOGIN_VERSIONS=v2
+export PG_BACKUP_VERSION=v1

compose.yml

@@ -51,10 +51,11 @@ x-environment:
   - WELCOME_BODY
   - WELCOME_SUBJECT
   - TZ
+  - PORTS
 
 services:
   app:
-    image: ghcr.io/mailu/nginx:2.0.34
+    image: ghcr.io/mailu/nginx:2024.06.66
     logging:
       driver: json-file
     networks:
@@ -95,15 +96,25 @@ services:
         - "traefik.http.routers.${STACK_NAME}.rule=Host(`${DOMAIN}`)"
         - "traefik.http.routers.${STACK_NAME}.tls.certresolver=${LETS_ENCRYPT_ENV}"
         - "traefik.http.routers.${STACK_NAME}.entrypoints=web-secure"
-        - "coop-cloud.${STACK_NAME}.version=1.1.0+2.0.34"
+        - "backupbot.backup=true"
+        - "coop-cloud.${STACK_NAME}.version=3.2.1+2024.06.66"
   
   db:
-    image: redis:7.2.3-alpine
+    image: redis:8.10.2-alpine
     volumes:
       - "redis:/data"
+    deploy:
+      labels:
+        backupbot.backup.pre-hook: "/pg_backup.sh backup"
+        backupbot.backup.volumes.postgres.path: "backup.sql"
+        backupbot.backup.post-hook: "/pg_backup.sh restore"
+    configs:
+      - source: pg_backup
+        target: /pg_backup.sh
+        mode: 0555
 
   admin:
-    image: ghcr.io/mailu/admin:2.0.34
+    image: ghcr.io/mailu/admin:2024.06.66
     environment: *default-env
     healthcheck:
       disable: true
@@ -114,9 +125,12 @@ services:
       - "mailu:/data"
     networks:
       - default
+    deploy:
+      labels:
+        - "backupbot.backup=true"
 
   imap:
-    image: ghcr.io/mailu/dovecot:2.0.34
+    image: ghcr.io/mailu/dovecot:2024.06.66
     environment: *default-env
     secrets:
       - secret_key
@@ -130,7 +144,7 @@ services:
       - default
 
   smtp:
-    image: ghcr.io/mailu/postfix:2.0.34
+    image: ghcr.io/mailu/postfix:2024.06.66
     environment: *default-env
     secrets:
       - secret_key
@@ -142,7 +156,7 @@ services:
       - app
 
   antispam:
-    image: ghcr.io/mailu/rspamd:2.0.34
+    image: ghcr.io/mailu/rspamd:2024.06.66
     environment: *default-env
     secrets:
       - secret_key
@@ -153,7 +167,8 @@ services:
       disable: true
 
   webmail:
-    image: ghcr.io/mailu/webmail:2.0.34
+    image: ghcr.io/mailu/webmail:2024.06.66
+    # entrypoint: "tail -f /dev/null"
     environment: *default-env
     networks:
       - default
@@ -167,7 +182,7 @@ services:
       disable: true
 
   certdumper:
-    image: ldez/traefik-certs-dumper:v2.8.1
+    image: ldez/traefik-certs-dumper:v2.11.4
     entrypoint: sh -c '
       apk add jq
       ; while ! [ -e /traefik/${ACME_JSON} ]
@@ -219,6 +234,9 @@ configs:
   certdumper_post:
     name: ${STACK_NAME}_certdumper_post_${CERTDUMPER_POST_VERSION}
     file: certdumper_post.sh
+  pg_backup:
+    name: ${STACK_NAME}_pg_backup_${PG_BACKUP_VERSION}
+    file: pg_backup.sh
 
 secrets:
   secret_key:

pg_backup.sh

@@ -0,0 +1,36 @@
+#!/bin/bash
+
+set -e
+
+BACKUP_FILE='/var/lib/postgresql/data/backup.sql'
+
+# TODO: this recipe doesn't have a db_password secret.
+function backup {
+  export PGPASSWORD=$(cat /run/secrets/db_password)
+  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
+}
+
+$@
+

release/3.0.0+2024.06.27

@@ -0,0 +1,3 @@
+ALERTA! 🚨 Mailu has dropped support for STARTTLS by default – see details here: https://mailu.io/2024.06/releases.html#starttls-ports-disabled-by-default
+
+If you are relying on STARTTLS, e.g. SMTP port 587, please copy the example `PORTS` variable from `~/.abra/recipes/mailu/.env.example` BEFORE deploying.

release/3.2.0+2024.06.61

@@ -0,0 +1 @@
+Contains mitigation measures for php2shell

release/3.2.1+2024.06.66

@@ -0,0 +1 @@
+Actual mitigation for php2shell pending further alpine image upgrades

renovate.json

@@ -0,0 +1,6 @@
+{
+  "$schema": "https://docs.renovatebot.com/renovate-schema.json",
+  "extends": [
+    "config:recommended"
+  ]
+}