자체 개발 웹 엔진 nginx-drsoft로 수백 개 도메인 무중단 운영하기
디알소프트는 하나의 플랫폼에서 200개 이상의 도메인을 서빙합니다. 초기에는 NGINX Unit을 사용했지만, 도메인 추가·설정 변경 시의 제약과 세밀한 제어의 한계로 인해 NGINX 본체에 자체 모듈을 결합한 **nginx-drsoft** 웹 엔진으로 전환했습니다. 이 글에서는 그 아키텍처와 무중단 운영 노하우를 정리합니다.
## 배경
멀티테넌트 환경에서 수백 개 도메인을 운영하다 보면 다음 요구가 반복됩니다.
- 새 도메인·앱을 **서비스 중단 없이** 추가해야 한다
- 도메인마다 정적 캐싱·업스트림 정책이 다르다
- 특정 노드만 설정이 어긋나면 응답이 달라진다
## 아키텍처
nginx-drsoft는 웹 노드 3대에 배치되어 이중화되어 있습니다. 데이터플레인은 `:80`, 관리 REST API는 `:9092`(NGINX Unit 호환 JSON)로 분리했습니다.
```mermaid
graph LR
U[사용자 · 수백 도메인] --> E1[Web Engine AP01]
U --> E2[Web Engine AP02]
U --> E3[Web Engine AP03]
E1 --> P[PHP 앱 · 멀티테넌트]
E1 --> UP[업스트림 풀]
API[제어 REST API :9092] -. graceful reload .-> E1
```
설정 변경 흐름은 다음과 같습니다.
1. 제어 API에 부분 PUT(`/config/...`)
2. `state.json`(단일 원천) 갱신
3. `conf_gen`이 vhost 설정 자동 생성
4. **graceful reload**로 기존 연결을 유지한 채 무중단 반영
## 무중단 설정 변경
| 작업 | 방식 | 순단 |
| :--- | :--- | :--- |
| 도메인 추가 | routes 배열 GET → append → PUT | 없음 |
| 업스트림 서버 추가 | shared memory 반영 | **0ms** |
| 정적 캐싱 정책 | static_cache_max_age 필드 | 없음 |
특히 업스트림 서버 추가/제거는 shared memory에 반영되어 **reload 없이 즉시** 적용됩니다. 트래픽 급증 시 백엔드를 실시간으로 늘릴 수 있습니다.
## 운영 원칙
- 모든 설정 변경 전 3대 config를 **백업**한다
- `routes` 인덱스 PUT은 교체(REPLACE)이므로 반드시 **전체 배열**로 다룬다
- 3대에 **동일하게** 적용해 노드 간 응답 일관성을 보장한다
## 마무리
자체 웹 엔진으로 전환한 뒤 도메인 온보딩은 API 호출 몇 번으로 끝나고, 배포 중 다운타임은 사라졌습니다. 수백 개 도메인을 소수 인력으로 안정적으로 운영하는 기반이 되었습니다.