kine pgx multi-host 직결: HAProxy 의존 제거, API 다운타임 <1s

history/2026-04-16-kine-multihost-migration.md

@@ -0,0 +1,58 @@
+---
+date: 2026-04-16
+topic: kine pgx multi-host 직결 (HAProxy 의존 제거)
+areas:
+  - infra/postgresql-ha.md
+tags: [history, k3s, kine, pgx, patroni, postgresql, migration]
+---
+
+K3s kine 의 `datastore-endpoint` 를 HAProxy `192.168.9.1:5432` 에서 Patroni 3노드 pgx multi-host 로 전환. API 다운타임 <1초.
+
+## 변경 사항
+
+### K3s config (`/etc/rancher/k3s/config.yaml`, kr1 + kr2)
+
+before:
+```yaml
+datastore-endpoint: "postgres://kine:kine@192.168.9.1:5432/kine"
+```
+
+after:
+```yaml
+datastore-endpoint: "postgres://kine:kine@10.100.2.5:5432,10.100.3.185:5432,10.100.1.83:5432/kine?target_session_attrs=read-write&sslmode=disable"
+```
+
+### 실행 순서
+
+1. **kr2** (init server): config backup → sed 치환 → `systemctl restart k3s` → kubectl get nodes 확인 (5초 내 Ready)
+2. **kr1** (secondary server): 동일 → 10초 내 Ready
+3. 4노드 전체 Ready 확인 (hp1, hp2, kr1, kr2), API 응답 시간 ~200ms
+
+### Patroni switchover 테스트
+
+`patronictl switchover --leader postgres-1 --candidate postgres-3 --force` (TL12→13):
+
+- switchover 커맨드 반환: 4.8초
+- kubectl get nodes 첫 응답: **t+2ms** (즉시) — `incus-hp1 Ready`
+- API 정상 응답 시간: 231ms
+- **API 다운타임: <1초**
+
+kine 의 pgx `target_session_attrs=read-write` 가 자동으로 새 primary (postgres-3, 10.100.1.83) 에 재연결.
+
+비교: HAProxy 경유 시 health check `inter 3s fall 3` = 최대 9초 감지 지연. pgx multi-host 방식은 connection-level 에서 즉시 재시도.
+
+## 롤백
+
+```bash
+sudo cp /tmp/config.yaml-backup-20260416 /etc/rancher/k3s/config.yaml
+sudo systemctl restart k3s
+```
+
+## HAProxy :5432 상태
+
+kine + pgpool(NocoDB/n8n/Outline) 전환 완료로 HAProxy postgres 프론트엔드 (`ft_postgres` + `bk_postgres_primary`) 는 더 이상 트래픽 없음. 1주 관측 후 제거.
+
+## 참조
+
+- `infra/postgresql-ha.md` — 「K3s kine 연결」 갱신
+- kine pgx 지원 확인: `k3s-io/kine` go.mod `github.com/jackc/pgx/v5`