Stufe 0: Grundgerüst mit Rechenkern, Datenbank, Oberfläche und Docker-Betrieb

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01AmyPfuNc4sCRfaF3oURXZz
This commit is contained in:
Claude
2026-10-17 16:37:54 +00:00
commit 92d26baa4b
45 changed files with 6143 additions and 0 deletions

15
deploy/.env.beispiel Normal file
View File

@@ -0,0 +1,15 @@
# Kopieren nach .env und ausfüllen. Die Datei bleibt nur auf dem Server.
IMAGE=ghcr.io/besitzer/betrieb
APP_VERSION=1.0.0
TEST_VERSION=1.0.0
DOMAIN=betrieb.example.de
TEST_DOMAIN=test.betrieb.example.de
DB_PASSWORT=bitte-lang-und-zufaellig
APP_BENUTZER=henning
# Erzeugen mit: docker run --rm caddy:2-alpine caddy hash-password --plaintext 'geheim'
# In .env jedes $ verdoppeln ($$), sonst liest Compose es als Variable.
APP_PASSWORT_HASH=
BACKUP_UHRZEIT=02:30
NEXTCLOUD_URL=https://cloud.example.de/remote.php/dav/files/henning/Sicherungen/betrieb
NEXTCLOUD_BENUTZER=henning
NEXTCLOUD_PASSWORT=app-passwort-aus-nextcloud

24
deploy/Caddyfile Normal file
View File

@@ -0,0 +1,24 @@
# HTTPS mit automatischem Zertifikat für Produktion und Testumgebung.
# Bis zur eigenen Benutzerverwaltung (Modul 16) schützt eine Anmeldung am Proxy
# das Programm; der Name geht als X-Benutzer an die App und ins Änderungsprotokoll.
(anmeldung) {
basic_auth {
{$APP_BENUTZER} {$APP_PASSWORT_HASH}
}
}
{$DOMAIN} {
encode gzip
import anmeldung
reverse_proxy app:3000 {
header_up X-Benutzer {http.auth.user.id}
}
}
{$TEST_DOMAIN} {
encode gzip
import anmeldung
reverse_proxy app-test:3000 {
header_up X-Benutzer {http.auth.user.id}
}
}

102
deploy/docker-compose.yml Normal file
View File

@@ -0,0 +1,102 @@
# Betrieb auf dem Server: Produktion und Testumgebung nebeneinander,
# jede mit eigener Datenbank und eigener Sicherung, davor ein gemeinsamer Proxy.
# Start: docker compose up -d (Werte aus .env, Vorlage .env.beispiel)
x-app: &app
restart: unless-stopped
networks: [intern]
x-db: &db
image: postgres:16-alpine
restart: unless-stopped
environment:
POSTGRES_USER: betrieb
POSTGRES_PASSWORD: ${DB_PASSWORT}
POSTGRES_DB: betrieb
healthcheck:
test: ["CMD", "pg_isready", "-U", "betrieb"]
interval: 5s
retries: 20
networks: [intern]
x-backup: &backup
build: ../backup
image: betrieb-backup
restart: unless-stopped
networks: [intern]
x-backup-env: &backup-env
PGUSER: betrieb
PGPASSWORD: ${DB_PASSWORT}
PGDATABASE: betrieb
AUFBEWAHREN_TAGE: "30"
UHRZEIT: ${BACKUP_UHRZEIT:-02:30}
NEXTCLOUD_URL: ${NEXTCLOUD_URL:-}
NEXTCLOUD_BENUTZER: ${NEXTCLOUD_BENUTZER:-}
NEXTCLOUD_PASSWORT: ${NEXTCLOUD_PASSWORT:-}
services:
app:
<<: *app
image: ${IMAGE}:${APP_VERSION}
environment:
DATABASE_URL: postgres://betrieb:${DB_PASSWORT}@db:5432/betrieb
depends_on:
db: { condition: service_healthy }
db:
<<: *db
volumes: [db:/var/lib/postgresql/data]
backup:
<<: *backup
environment:
<<: *backup-env
PGHOST: db
NAME: produktion
volumes: [sicherungen:/sicherungen]
depends_on:
db: { condition: service_healthy }
app-test:
<<: *app
image: ${IMAGE}:${TEST_VERSION}
environment:
DATABASE_URL: postgres://betrieb:${DB_PASSWORT}@db-test:5432/betrieb
depends_on:
db-test: { condition: service_healthy }
db-test:
<<: *db
volumes: [db-test:/var/lib/postgresql/data]
backup-test:
<<: *backup
environment:
<<: *backup-env
PGHOST: db-test
NAME: test
NEXTCLOUD_URL: ""
volumes: [sicherungen-test:/sicherungen]
depends_on:
db-test: { condition: service_healthy }
proxy:
image: caddy:2-alpine
restart: unless-stopped
ports: ["80:80", "443:443"]
environment:
DOMAIN: ${DOMAIN}
TEST_DOMAIN: ${TEST_DOMAIN}
APP_BENUTZER: ${APP_BENUTZER}
APP_PASSWORT_HASH: ${APP_PASSWORT_HASH}
volumes:
- ./Caddyfile:/etc/caddy/Caddyfile:ro
- caddy:/data
networks: [intern]
volumes:
db:
db-test:
sicherungen:
sicherungen-test:
caddy:
networks:
intern:

22
deploy/update.sh Executable file
View File

@@ -0,0 +1,22 @@
#!/bin/sh
# Neue Version einspielen: erst Sicherung, dann neues Image starten.
# Migrationen laufen beim Start der App automatisch.
# ./update.sh test 1.1.0 Testumgebung
# ./update.sh produktion 1.1.0 Produktion (erst nach Freigabe in der Testumgebung)
set -eu
cd "$(dirname "$0")"
umgebung="$1"
version="$2"
case "$umgebung" in
test) app=app-test; backup=backup-test; variable=TEST_VERSION ;;
produktion) app=app; backup=backup; variable=APP_VERSION ;;
*) echo "Umgebung: test oder produktion" >&2; exit 1 ;;
esac
alt=$(grep "^$variable=" .env | cut -d= -f2)
echo "$umgebung: Update von $alt auf $version"
docker compose exec -T "$backup" sicherung vor-update
echo "$alt" > ".vorige-version-$umgebung"
sed -i "s/^$variable=.*/$variable=$version/" .env
docker compose pull "$app"
docker compose up -d "$app"
echo "Fertig. Zurück mit: ./zurueck.sh $umgebung"

19
deploy/zurueck.sh Executable file
View File

@@ -0,0 +1,19 @@
#!/bin/sh
# Rückkehr zur vorigen Version und zur Sicherung vor dem letzten Update.
# ./zurueck.sh produktion
set -eu
cd "$(dirname "$0")"
umgebung="$1"
case "$umgebung" in
test) app=app-test; backup=backup-test; variable=TEST_VERSION ;;
produktion) app=app; backup=backup; variable=APP_VERSION ;;
*) echo "Umgebung: test oder produktion" >&2; exit 1 ;;
esac
vorige=$(cat ".vorige-version-$umgebung")
sicherung=$(docker compose exec -T "$backup" sh -c 'ls -t /sicherungen/*_vor-update.dump | head -1' | tr -d '\r')
echo "$umgebung: zurück auf $vorige mit Sicherung $sicherung"
docker compose stop "$app"
docker compose exec -T "$backup" pg_restore --clean --if-exists --no-owner -d betrieb "$sicherung"
sed -i "s/^$variable=.*/$variable=$vorige/" .env
docker compose up -d "$app"
echo "Fertig."