docs: Embedded Redis 반영 가이드 업데이트 + auth guard 경고 수정
- 설치가이드_OnPremise.pdf: Redis를 선택 사항으로 변경, Embedded Redis 안내 - 개발자가이드.pdf: Docker/Redis 필수 → 선택, Embedded Redis 자동 구동 안내 - 개발환경_사전설치_가이드.txt: Docker/Redis 섹션 Embedded Redis 기반으로 수정 - regenerate_pdfs.py: PDF 재생성 스크립트 추가 - auth.guard.ts: Vue Router deprecated next() 콜백 → return 방식으로 수정 Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
이 Commit은 다음에 포함되어 있습니다:
@@ -81,9 +81,10 @@
|
||||
2. 선택 소프트웨어 (권장)
|
||||
--------------------------------------------------------------------------------
|
||||
|
||||
[2-1] Docker Desktop
|
||||
[2-1] Docker Desktop (선택 — DB 컨테이너 사용 시에만 필요)
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
용도: 로컬 개발용 DB(MySQL/PostgreSQL) + Redis를 컨테이너로 실행
|
||||
용도: 로컬 개발용 DB(MySQL/PostgreSQL)를 컨테이너로 실행
|
||||
※ Redis는 Embedded Redis가 자동 구동되므로 Docker 불필요
|
||||
|
||||
* Windows
|
||||
winget install --id Docker.DockerDesktop
|
||||
@@ -119,19 +120,19 @@
|
||||
GRANT ALL ON mos.* TO 'jsh'@'%';
|
||||
|
||||
|
||||
[2-3] Redis
|
||||
[2-3] Redis (설치 불필요)
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
용도: 캐시, 세션 저장소
|
||||
|
||||
* Windows (Docker 권장, 네이티브 미지원)
|
||||
docker run -d -p 6379:6379 redis:7-alpine
|
||||
※ WBX Spring Framework에 Embedded Redis가 내장되어 있어 별도 설치가
|
||||
필요하지 않습니다. 앱 시작 시 다음 순서로 자동 동작합니다:
|
||||
|
||||
* macOS
|
||||
brew install redis && brew services start redis
|
||||
1) 외부 Redis 감지 → 그대로 사용 (운영 환경)
|
||||
2) 외부 Redis 없음 → Embedded Redis 자동 시작 (개발 환경)
|
||||
3) Embedded Redis 실패 → 인메모리 캐시 전환 (최후 안전장치)
|
||||
|
||||
* Linux
|
||||
sudo apt install -y redis-server (Ubuntu)
|
||||
sudo yum install -y redis (RHEL)
|
||||
운영 환경에서 외부 Redis를 사용하려면 .env에 설정:
|
||||
SPRING_DATA_REDIS_HOST=redis.company.com
|
||||
|
||||
|
||||
--------------------------------------------------------------------------------
|
||||
@@ -151,7 +152,7 @@
|
||||
scripts\install.bat (Windows)
|
||||
./scripts/install.sh (Linux/macOS)
|
||||
|
||||
# 3) Docker로 MySQL + Redis 시작
|
||||
# 3) Docker로 MySQL 시작 (Redis는 Embedded Redis 자동 구동)
|
||||
docker compose -f docker-compose-dev.yml up -d
|
||||
|
||||
# 4) .env 파일 수정 (DB 비밀번호를 docker-compose 설정에 맞춤)
|
||||
@@ -185,13 +186,11 @@
|
||||
|
||||
# 3) MySQL/PostgreSQL 설치 후 DB 생성
|
||||
# 위 [2-2] 참고
|
||||
# (Redis는 Embedded Redis 자동 구동 — 설치 불필요)
|
||||
|
||||
# 4) Redis 설치
|
||||
# 위 [2-3] 참고
|
||||
# 4) .env 파일을 실제 DB 정보에 맞게 수정
|
||||
|
||||
# 5) .env 파일을 실제 DB 정보에 맞게 수정
|
||||
|
||||
# 6~7) 앱 실행 및 확인 (위와 동일)
|
||||
# 5~6) 앱 실행 및 확인 (위와 동일)
|
||||
|
||||
|
||||
--------------------------------------------------------------------------------
|
||||
@@ -206,7 +205,7 @@
|
||||
| MySQL 8.0 | 3306 | jsh | PW: jsh@ (기본 프로필) |
|
||||
| | | | root PW: rootpassword |
|
||||
| PostgreSQL 16 | 5432 | jsh | PW: jsh@ (--profile pg) |
|
||||
| Redis 7 | 6379 | - | 인증 없음 (개발용) |
|
||||
| Redis 7 | 6379 | - | Embedded Redis 자동 구동 |
|
||||
+------------------+--------+----------+------------------------------+
|
||||
|
||||
프로필별 실행:
|
||||
@@ -250,7 +249,7 @@
|
||||
| 8081 | wtm-api | WTM API, Admin, Swagger |
|
||||
| 3306 | MySQL | 기본 DB (mysql 프로필) |
|
||||
| 5432 | PostgreSQL | 대안 DB (postgresql 프로필) |
|
||||
| 6379 | Redis | 캐시, 세션 |
|
||||
| 6379 | Redis | Embedded Redis 자동 구동 (별도 설치 불필요)|
|
||||
| 5173 | wtm-frontend | Vue 3 개발 서버 |
|
||||
| 8001 | WBX FastAPI | 선택, 그룹웨어 동시 운영 시 |
|
||||
+--------+------------------+------------------------------------------+
|
||||
@@ -273,9 +272,10 @@
|
||||
2) .env 파일의 DB_HOST, DB_PORT, DB_PASS 확인
|
||||
3) telnet localhost 3306 으로 연결 가능 여부 확인
|
||||
|
||||
Q: Redis 연결 실패
|
||||
A: docker ps 에서 redis 컨테이너 실행 중인지 확인
|
||||
또는 Redis를 직접 설치하고 기본 포트(6379) 확인
|
||||
Q: Redis 관련 로그가 나옴
|
||||
A: Embedded Redis가 자동 구동됩니다. 별도 조치 불필요.
|
||||
로그에 "[WBX] Embedded Redis 시작" 출력 시 정상 동작.
|
||||
포트 6379가 이미 사용 중이면 외부 Redis를 자동 감지하여 사용합니다.
|
||||
|
||||
Q: Lombok 관련 컴파일 에러
|
||||
A: IDE에서 Annotation Processor 활성화 필요
|
||||
|
||||
새 Issue에서 참조
사용자 차단