obsidian/infra/postgresql-ha.md at 862ca9bae84f0e4b4cd99c9ebe38ddfb71f8f9af

Files

kaffa 862ca9bae8 sandbox-tokyo: Debian → NixOS 25.05 전환 (Linode zlambda)

- 새 노트 infra/sandbox-tokyo-nixos.md 작성 (설치 과정, configuration, 후속 작업)
- infra-hosts: 호스트 항목 NixOS 베이스로 갱신, Tailscale IP 100.79.87.48 → 100.78.51.18, vault-prod/wg-easy 항목 제거
- netbis: NixOS 전환으로 APISIX/etcd 컨테이너 모두 제거된 상태 표기, DR 미가동
- searxng: tlsproxy/microsocks 중단, 새 IP 반영
- vault: SSH CA에서 sandbox-tokyo 재등록 필요 표기
- postgresql-ha: /apisix/tokyo prefix 미사용 표기

2026-04-08 14:27:03 +09:00

4.7 KiB

Raw Blame History

title, updated, tags

title

updated

개요

PostgreSQL 3노드 HA 클러스터. Patroni가 자동 failover를 관리하고, etcd를 DCS(Distributed Consensus Store)로 사용.

K3s의 kine 데이터스토어로 사용 중. Supabase Free tier에서 로컬로 이전 완료 (2026-04-05).

PostgreSQL 클러스터

노드	호스트	IP	역할
postgres-1	incus-hp2	10.100.2.5	Replica 또는 Leader
postgres-2	incus-kr1	10.100.3.185	Replica 또는 Leader
postgres-3	incus-kr2	10.100.1.83	Replica 또는 Leader

PostgreSQL 17.9, Patroni 4.1.0
Patroni 설정: /etc/patroni.yml
Patroni 서비스: /etc/systemd/system/patroni.service (ExecStart: /opt/patroni/bin/patroni /etc/patroni.yml)
클러스터 이름: nocodb-cluster
레플리케이션: async streaming
Patroni REST API: 각 노드 8008 포트
컨테이너 메모리 제한: 2GiB (limits.memory)
shared_buffers: 512MB, effective_cache_size: 1536MB, work_mem: 8MB, maintenance_work_mem: 128MB, wal_buffers: 16MB

DB 목록

DB	용도
kine	K3s 데이터스토어 (kine)
nocodb	NocoDB
n8n	n8n 워크플로
outline	Outline 위키

Patroni 명령어

# 클러스터 상태 확인
incus exec postgres-1 -- /opt/patroni/bin/patronictl -c /etc/patroni.yml list

# 수동 switchover
incus exec postgres-1 -- /opt/patroni/bin/patronictl -c /etc/patroni.yml switchover

# Replica reinitialize
incus exec postgres-1 -- /opt/patroni/bin/patronictl -c /etc/patroni.yml reinit nocodb-cluster postgres-3 --force

etcd 클러스터 (Patroni DCS)

노드	위치	IP	방식
etcd-nas	Synology NAS (서울)	192.168.9.100	Docker (`quay.io/coreos/etcd:v3.5.21`)
etcd-hp2	Incus 컨테이너 hp2 (서울)	10.100.2.214	Alpine + `apk add etcd` (v3.5.16)
etcd-jp1	Incus 컨테이너 jp1 (도쿄)	10.253.101.233	Alpine + `apk add etcd` (v3.5.16)

NAS: 데이터 /volume1/docker/etcd/data, --restart=always
hp2/jp1: openrc 서비스 (/etc/init.d/etcd), command_background=true
Patroni etcd namespace: /patroni

etcd 확인 명령어

# 클러스터 멤버 확인
incus exec postgres-1 -- etcdctl --endpoints=http://192.168.9.100:2379 member list -w table

# 엔드포인트 상태
incus exec postgres-1 -- etcdctl --endpoints=http://192.168.9.100:2379,http://10.100.2.214:2379,http://10.253.101.233:2379 endpoint status -w table

etcd에 저장된 데이터

prefix	용도
`/patroni`	Patroni DCS (Leader election, 설정)
`/apisix/osaka`	APISIX 오사카 라우팅 설정
`/apisix/tokyo`	APISIX sandbox-tokyo 라우팅 설정 (2026-04-08 NixOS 전환 후 미사용, 데이터는 보존)
`/apisix/seoul`	APISIX 서울 K3s 라우팅 설정

K3s kine 연결

K3s → HAProxy(OpenWrt 192.168.9.1:5432) → Patroni Leader PostgreSQL

K3s config

# /etc/rancher/k3s/config.yaml (kr1, kr2)
datastore-endpoint: "postgres://kine:kine@192.168.9.1:5432/kine"

HAProxy (OpenWrt)

/etc/haproxy.cfg에 PostgreSQL backend 설정. Patroni REST API(/primary 엔드포인트)로 Leader를 자동 감지.

frontend ft_postgres
    bind :5432
    default_backend bk_postgres_primary

backend bk_postgres_primary
    option httpchk GET /primary
    http-check expect status 200
    default-server inter 3s fall 3 rise 2 on-marked-down shutdown-sessions
    server postgres-1 10.100.2.5:5432 check port 8008
    server postgres-2 10.100.3.185:5432 check port 8008
    server postgres-3 10.100.1.83:5432 check port 8008

Patroni failover 시 HAProxy가 자동으로 새 Leader를 감지 (~3초)
K3s config 변경 없이 Leader 전환 대응

APISIX etcd 통합 (2026-04-06)

기존 각 사이트별 독립 etcd를 통합 etcd 클러스터로 이전.

사이트	기존 etcd	이전 후	prefix
osaka	Docker waf-etcd (로컬)	통합 클러스터 (192.168.9.100)	`/apisix/osaka`
sandbox-tokyo	Docker apisix-etcd (로컬)	통합 클러스터 (10.253.101.233)	`/apisix/tokyo` (2026-04-08 NixOS 전환으로 sandbox-tokyo APISIX 자체가 미가동)
서울 K3s	StatefulSet 3노드 (K3s 내부)	통합 클러스터 (192.168.9.100)	`/apisix/seoul`

데이터 이전: etcdctl make-mirror --prefix /apisix/ --dest-prefix /apisix-{site}/
K3s 내 apisix-etcd StatefulSet + PVC 삭제 완료

4.7 KiB Raw Blame History

개요