Michael Schiemer
77abc65cd7
Some checks failed
Deploy Application / deploy (push) Has been cancelled
115 lines
2.4 KiB
Markdown
115 lines
2.4 KiB
Markdown
# PostgreSQL Stack
|
|
|
|
Shared PostgreSQL-Datenbank für Application-Stacks (Staging und Production).
|
|
|
|
## Features
|
|
|
|
- PostgreSQL 16 für Application-Datenbank
|
|
- Automatische Backups (täglich um 2 Uhr)
|
|
- Backup-Retention (7 Tage)
|
|
- Health Checks
|
|
- Optimierte Performance-Konfiguration
|
|
|
|
## Voraussetzungen
|
|
|
|
- Infrastructure Network muss existieren
|
|
- App-Internal Network wird von diesem Stack erstellt
|
|
|
|
## Setup
|
|
|
|
### 1. Infrastructure Network erstellen
|
|
|
|
```bash
|
|
docker network create infrastructure
|
|
```
|
|
|
|
### 2. Secrets erstellen
|
|
|
|
```bash
|
|
# PostgreSQL Passwort
|
|
openssl rand -base64 32 > secrets/postgres_password.txt
|
|
chmod 600 secrets/postgres_password.txt
|
|
```
|
|
|
|
### 3. Stack deployen
|
|
|
|
```bash
|
|
docker compose up -d
|
|
```
|
|
|
|
### 4. Datenbanken erstellen
|
|
|
|
```bash
|
|
# Staging-Datenbank erstellen
|
|
docker compose exec postgres psql -U postgres -c "CREATE DATABASE michaelschiemer_staging;"
|
|
|
|
# Production-Datenbank existiert bereits (michaelschiemer)
|
|
```
|
|
|
|
## Networks
|
|
|
|
**infrastructure:**
|
|
- Externes Network (muss vorher erstellt werden)
|
|
- Für interne Infrastruktur-Kommunikation
|
|
|
|
**app-internal:**
|
|
- Wird von diesem Stack erstellt
|
|
- Wird von Application-Stacks genutzt
|
|
- Für Application ↔ PostgreSQL Kommunikation
|
|
|
|
## Volumes
|
|
|
|
- `postgres-data` - PostgreSQL-Daten (persistent)
|
|
- `postgres-backups` - Automatische Backups
|
|
|
|
## Datenbanken
|
|
|
|
- `michaelschiemer` - Production-Datenbank
|
|
- `michaelschiemer_staging` - Staging-Datenbank (muss manuell erstellt werden)
|
|
|
|
## Backups
|
|
|
|
Backups werden automatisch täglich um 2 Uhr erstellt und in `/backups` gespeichert.
|
|
|
|
**Manuelles Backup:**
|
|
```bash
|
|
docker compose exec postgres-backup sh -c "PGPASSWORD=\$(cat /run/secrets/postgres_password) pg_dump -h postgres -U postgres -d michaelschiemer -F c -f /backups/manual_backup_$(date +%Y%m%d_%H%M%S).dump"
|
|
```
|
|
|
|
**Backup wiederherstellen:**
|
|
```bash
|
|
docker compose exec -T postgres psql -U postgres -d michaelschiemer < backup_file.sql
|
|
```
|
|
|
|
## Troubleshooting
|
|
|
|
### PostgreSQL startet nicht
|
|
|
|
```bash
|
|
# Logs prüfen
|
|
docker compose logs -f postgres
|
|
|
|
# Volume-Berechtigungen prüfen
|
|
docker compose exec postgres ls -la /var/lib/postgresql/data
|
|
```
|
|
|
|
### Verbindungsprobleme von Application
|
|
|
|
1. Prüfe, ob Application im `app-internal` Network ist
|
|
2. Prüfe PostgreSQL-Logs
|
|
3. Prüfe Network-Verbindung:
|
|
```bash
|
|
docker network inspect app-internal
|
|
```
|
|
|
|
### Backup-Probleme
|
|
|
|
```bash
|
|
# Backup-Logs prüfen
|
|
docker compose logs -f postgres-backup
|
|
|
|
# Backup-Verzeichnis prüfen
|
|
docker compose exec postgres-backup ls -la /backups
|
|
```
|
|
|