---
date: 2026-04-06
topic: APISIX etcd 통합/분리 과정 (K3s 내부 → 외부 통합 → K3s 내부 복귀)
areas:
  - infra/apisix.md
  - infra/postgresql-ha.md
tags: [history, apisix, etcd, k3s]
---

서울 K3s APISIX의 etcd 백엔드를 K3s 내부 StatefulSet에서 외부 통합 etcd로 이전했다가, 다시 K3s 내부로 복귀한 과정.

## 변경 사항

### 2026-04-06: K3s 내부 → 외부 통합 etcd
- K3s 내부 apisix-etcd StatefulSet 삭제
- 외부 통합 etcd(192.168.9.100, 10.100.2.214, 10.253.101.233)로 이전, prefix `/apisix/seoul`
- 의도: 통합 운영 + 컴포넌트 수 절감

### 2026-04-08: 외부 통합 → K3s 내부 복귀
- Patroni DCS와 같은 etcd 클러스터 공유 시 장애 전파 위험(Patroni 이슈 → APISIX 라우팅 영향)
- K3s 내부 `apisix-etcd` StatefulSet 3 replicas 복구 (Bitnami etcd, Longhorn PVC 5Gi x 3)
- 외부 통합 etcd의 `/apisix/seoul/*` 20개 키 삭제
- ApisixRoute CRD 사용을 위해 ingress controller도 복구

## 교훈

- Patroni DCS와 APISIX etcd는 장애 격리를 위해 분리하는 것이 안전
- helm 한 곳에서 etcd + apisix + ingress controller 관리가 운영 일관성 확보

## 참조

- `infra/apisix.md` — 현재 APISIX 구성
- `infra/postgresql-ha.md` — etcd 사용 현황