Redis Cluster를 활용한 멀티테넌트 환경 세션 관리 시스템 구축 사례

관리자 2026-07-25 19:59 조회 82
dr-platform 관리자 게시글 작성 시 발생했던 '로그인 풀림/서버 오류' 장애는 PHP 세션이 각 웹노드(.4 3대) 로컬 파일에 저장되면서 로드밸런서에 의한 요청 분산 시 세션 불일치가 발생했기 때문입니다. 이 문제를 해결하기 위해 Redis Cluster를 세션 공유 저장소로 도입하여 시스템 안정성을 확보했습니다. ## 개요 본 프로젝트의 목표는 dr-platform의 세션 관리 방식을 로컬 파일 기반에서 중앙 집중식 Redis Cluster 기반으로 전환하는 것입니다. 이를 통해 웹 요청이 어떤 웹노드로 분산되더라도 일관된 세션 상태를 유지하도록 구현했습니다. | 구분 | 기존 방식 | 개선된 방식 | 기대 효과 | | :--- | :--- | :--- | :--- | | 세션 저장소 | 각 웹노드 로컬 파일 | Redis Cluster | 세션 불일치로 인한 장애 제거 | | 세션 공유성 | 없음 (노드 종속적) | 완벽하게 공유됨 | 사용자 경험 일관성 확보 | | 장애 복구 | 세션 데이터 손실 위험 | 마스터-레플리카 자동 장애 조치 | 서비스 가용성 향상 | ## 아키텍처 Redis Cluster는 3마스터와 3레플리카로 구성되었으며, 마스터 노드들은 다른 노드로 교차 복제되도록 배치하여 단일 장애 지점(SPOF)을 제거했습니다. 모든 슬롯(16384개)을 커버하도록 설계되었으며, 각 마스터당 약 5461개의 슬롯을 담당합니다. ```mermaid graph TD subgraph Web Tier W1[Web Node 1] --> LB(Load Balancer) W2[Web Node 2] --> LB W3[Web Node 3] --> LB end subgraph Redis Cluster (6 Nodes) subgraph Master Nodes M1[Master 1: 172.20.17.10] M2[Master 2: 172.20.18.10] M3[Master 3: 172.20.19.10] end subgraph Replica Nodes R1[Replica 1] R2[Replica 2] R3[Replica 3] end M1 -- Replicates To --> R1 M2 -- Replicates To --> R2 M3 -- Replicates To --> R3 M1 <--> M2 M2 <--> M3 end LB --> Redis_Cluster(Redis Cluster: 6379/16379) W1 --> Redis_Cluster W2 --> Redis_Cluster W3 --> Redis_Cluster style Redis_Cluster fill:#f9f,stroke:#333,stroke-width:2px ``` **Redis 구성 상세:** * **노드 정보:** 172.20.17.10, 172.20.18.10, 172.20.19.10 (Rocky Linux 9.5, 62GB RAM/16코어) * **Redis 버전:** 6.2.22 * **포트:** 마스터 6379/버스 16379, 레플리카 6380/버스 16380 * **안전 정책:** `maxmemory 512mb` (하드 상한), `maxmemory-policy volatile-lru` (TTL 키만 삭제), `save '' + appendonly no` (휘발성 데이터 특성 반영) * **네트워크 제어:** 방화벽을 통해 172.20.0.0/16 대역에서 6379-6380, 16379-16380 포트만 허용했습니다. ## 운영/검증 결과 세션 관리를 위해 커스텀 세션 핸들러를 구현하고, PHP 7.4 환경에서 재시작 없이 적용 가능한 순수 PHP 라이브러리 Predis를 벤더링하여 사용했습니다. 세션 키는 `dr-platform:session:{사이트호스트}:{PHPSESSID}` 형식으로 네이밍하여 서비스 및 사이트 구분을 명확히 했습니다. TTL은 28800초(8시간)로 설정했습니다. **주요 검증 결과:** 1. **Cluster 상태 확인:** `cluster_state:ok` 확인, 16384/16384 슬롯 정상 동작, 6개 노드 모두 정상 상태 유지. 2. **세션 무결성 검증:** 동일한 로그인 세션으로 3개 웹노드에 번갈아 요청을 가해도 로그인 상태가 유지됨을 확인했습니다. (기존에는 노드 이동 시 로그아웃 발생) 3. **전체 플로우 검증:** 로그인부터 이미지 업로드, 게시글 발행까지의 전체 비즈니스 플로우가 정상적으로 동작함을 확인했습니다. 4. **리소스 사용량:** 실제 운영 시 메모리 사용량은 2.56MB 수준으로, 설정된 상한 512MB 대비 충분한 여유 공간을 확보했습니다. **장애 복구 시나리오 검증:** 마스터 노드 1대가 다운되는 장애 시나리오를 테스트한 결과, 레플리카가 5초 이내에 자동 승격되어 세션 데이터가 손실 없이 유지되는 것을 확인했습니다. 전체 시스템 재시작 시에만 세션이 소실되어 재로그인이 필요했으나, 관리자 전용 게시판이라는 특성상 서비스 영향도는 미미했습니다. 문의는 [상담 신청](/sub/contact.php)으로 남겨 주세요.
KO