자체 개발 웹 엔진 nginx-drsoft로 수백 개 도메인 무중단 운영하기

관리자 2026-07-25 21:33 조회 261
디알소프트는 하나의 플랫폼에서 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 호출 몇 번으로 끝나고, 배포 중 다운타임은 사라졌습니다. 수백 개 도메인을 소수 인력으로 안정적으로 운영하는 기반이 되었습니다.
KO