Files

Nicolay Braetter c31d596b78 Initial commit: Vollständige Homelab-Dokumentation (Stand 2026-04-15)

- Proxmox Host pve-braetter (Hardware, Storage, Bridges)
- 14x LXC Container (CT 100-303) vollständig dokumentiert
- 8x VMs (103-201) vollständig dokumentiert
- Netzwerk-Übersicht mit komplettem IP-Belegungsplan
- Dienste-Übersicht aller Web-Interfaces, DBs, Monitoring
- PostgreSQL 16 HA Cluster (Patroni/etcd) detailliert

2026-04-15 09:57:15 +02:00

3.8 KiB

Raw Blame History

CT 300–302 — PostgreSQL 16 HA Cluster + CT 303 pgAdmin

Cluster-Übersicht

VMID	Hostname	IP	Rolle	Status
300	sql1	192.168.0.220	Leader (Primary)	running
301	sql2	192.168.0.221	Replica (Streaming)	running
302	sql3	192.168.0.222	Replica (Streaming)	running
303	pgadmin	192.168.0.223	pgAdmin4 Web	running

CT 300 — sql1 (Leader)

Eigenschaft	Wert
VMID	300
IP	192.168.0.220/24
OS	Ubuntu 24.04 LTS
CPU	2 vCores
RAM	2048 MB
Disk	osdisk:300/vm-300-disk-0.raw, 20 GB
Autostart	nein

CT 301 — sql2 (Replica)

Eigenschaft	Wert
VMID	301
IP	192.168.0.221/24
OS	Ubuntu 24.04 LTS
CPU	2 vCores
RAM	2048 MB
Disk	osdisk:301/vm-301-disk-0.raw, 20 GB
Autostart	nein

CT 302 — sql3 (Replica)

Eigenschaft	Wert
VMID	302
IP	192.168.0.222/24
OS	Ubuntu 24.04 LTS
CPU	2 vCores
RAM	2048 MB
Disk	osdisk:302/vm-302-disk-0.raw, 20 GB
Autostart	nein

Dienste (alle DB-Nodes)

Dienst	Port	Beschreibung
postgresql 16	5432	Datenbank
patroni	8008	HA-Manager REST API
etcd	2379 (client), 2380 (peer)	Distributed Key-Value Store (DCS)
apache2	80	Nur sql1: pgAdmin4 Webserver

Patroni Konfiguration

Scope: pg-cluster
Namespace: /db/
Datenverzeichnis: /var/lib/postgresql/16/patroni
Config: /etc/patroni/patroni.yml
Systemd: patroni.service

etcd Konfiguration

Cluster-Token: pg-etcd-cluster
Config: /etc/default/etcd
Datenverzeichnis: /var/lib/etcd/default

Datenbanken & Benutzer

Datenbank	Eigentümer
nicolay	nicolay
testdb	nicolay
postgres	postgres

Benutzer	Passwort	Rechte
nicolay	N17b011975	Login
postgres	postgres_pass	Superuser
replicator	replicator_pass	Replikation
admin	admin	createdb, createrole

Zugriff

# PostgreSQL (immer Leader)
psql -h 192.168.0.220 -U nicolay -d nicolay

# Cluster-Status
pct exec 300 -- /usr/local/bin/patronictl -c /etc/patroni/patroni.yml list

# Patroni REST API
curl http://192.168.0.220:8008/leader
curl http://192.168.0.221:8008/replica

# etcd
etcdctl --endpoints=http://192.168.0.220:2379 endpoint health

Manueller Failover

pct exec 300 -- /usr/local/bin/patronictl -c /etc/patroni/patroni.yml failover pg-cluster

Verhalten bei Ausfall

Szenario	Verhalten
sql1 fällt aus	Patroni wählt sql2 oder sql3 als neuen Leader (30–60s)
sql2 oder sql3 fällt aus	Kein Ausfall, Leader läuft weiter
2 Nodes fallen aus	Kein Quorum → Cluster read-only

CT 303 — pgadmin

Eigenschaft	Wert
VMID	303
Hostname	pgadmin
IP	192.168.0.223/24
OS	Ubuntu 24.04 LTS
CPU	2 vCores
RAM	1024 MB
Disk	osdisk:303/vm-303-disk-0.raw, 10 GB
Autostart	nein

pgAdmin4 Zugriff

URL: http://192.168.0.223/pgadmin4/
Login: nicolay.braetter@googlemail.com / N17b011975
Vorkonfigurierte Server: sql1, sql2, sql3 (alle als "pg-cluster" Gruppe)

Hinweis Redundanz

pgAdmin läuft auf einem separaten LXC, unabhängig von den Datenbank-Nodes. Bei Ausfall von sql1 bleibt pgAdmin erreichbar. Die Server-Verbindungen in pgAdmin zeigen direkt auf die jeweiligen Node-IPs.

Install-Script

Vollständiges Installations-Script für den kompletten Cluster:
/home/claude/postgres-ha-install.sh auf pve-braetter
Gitea: (kein separates Repo — im aqualog-Repo enthalten)

3.8 KiB Raw Blame History Unescape Escape