DOCS/troubleshooting/250926_happybell80_gateway_redis_integration.md
happybell80 8ce2d19396 docs: Gateway Redis 통합 및 문서 업데이트
- 250809_happybell80_robing-gateway구현.md 수정
  - UserCache(메모리)와 Redis(rate limiting) 구분 명시
- 250926_happybell80_gateway_redis_integration.md 신규
  - Stats API 슬래시 문제 해결
  - auth-redis 연결 설정

🤖 Generated with Claude Code

Co-Authored-By: Claude <noreply@anthropic.com>
2025-09-26 11:19:45 +09:00

1.3 KiB

Gateway Redis 통합 및 Stats API 수정

날짜: 2025-09-26

작성자: happybell80

관련 서비스: robeing-gateway

상태: 해결 완료


1. 문제 발생

Stats API URL 이중 슬래시

  • 증상: Gateway → Monitor 요청 시 ///api/stats//rb8001
  • 원인: MONITOR_URL과 MONITOR_STATUS_URI 연결 시 슬래시 중복
  • 위치: robeing-gateway/app/main.py:290

헬스체크 실패

  • 증상: Actions에서 localhost:8100/healthz 연결 거부
  • 원인: 컨테이너 시작 지연

2. 해결 방법

Stats API 수정

서버 .env 수정:

MONITOR_STATUS_URI=/api/stats  # 앞 슬래시만 유지

Redis 연결 설정

서버 .env 추가:

REDIS_HOST=auth-redis  # auth-server의 Redis 컨테이너 공유
REDIS_PORT=6379

3. 아키텍처

캐시 구조

  • UserCache: 사용자-로빙 매핑 (메모리, 30분 TTL)
  • Redis: Rate limiting (auth-redis 컨테이너)

네트워크

  • 모든 컨테이너가 appnet 네트워크 공유
  • auth-redis:6379로 직접 통신 가능

4. 확인 방법

docker inspect robeing-gateway auth-redis | grep -A2 "Networks"

5. 결과

  • Stats API 정상 작동
  • Redis 연결 성공 (rate limiting)
  • 헬스체크 통과