Repository navigation
Environment Config
wcorn edited this page Apr 2, 2026
·
1 revision
프로필별 환경 구성과 환경변수를 정의한다.
Spring Boot 프로필로 환경을 분리한다. 모든 프로필은 mysql, redis, actuator를 자동 포함한다.
| 프로필 | 용도 | 활성화 방법 |
|---|---|---|
local |
docker-compose 로컬 개발 | SPRING_PROFILES_ACTIVE=local |
prod |
운영 배포 | SPRING_PROFILES_ACTIVE=prod |
test |
테스트 실행 | @ActiveProfiles("test") |
| 프로필 | MySQL | Redis |
|---|---|---|
local |
docker-compose 컨테이너 (환경변수) | docker-compose 컨테이너 (환경변수) |
prod |
클러스터 내부 서비스 (환경변수) | 클러스터 내부 서비스 (환경변수) |
test |
TestContainers 자동 생성 | TestContainers 자동 생성 |
개발 편의를 위해 추가 로깅이 활성화된다:
-
org.hibernate.SQL: DEBUG— 실행 SQL 출력 -
org.hibernate.orm.jdbc.bind: TRACE— 바인드 파라미터 출력 -
org.hibernate.stat: DEBUG— 쿼리 통계
- MySQL: TestContainers JDBC 드라이버 (
jdbc:tc:mysql:8.4.4:///) - Redis: TestContainers Redis 컨테이너
- JPA DDL:
create-drop(테스트마다 스키마 재생성)
| 변수 | 프로필 | 설명 | 예시 |
|---|---|---|---|
SPRING_PROFILES_ACTIVE |
전체 | 활성 프로필 |
local, prod
|
MYSQL_HOST |
local, prod | MySQL 호스트:포트 | mysql:3306 |
DB_NAME |
local, prod | 데이터베이스 이름 | orino |
MYSQL_USERNAME |
local, prod | DB 사용자명 | - |
MYSQL_PASSWORD |
local, prod | DB 비밀번호 | - |
REDIS_HOST |
local, prod | Redis 호스트 | redis |
REDIS_PORT |
local, prod | Redis 포트 | 6379 |
| 변수 | 설명 | 기본값 |
|---|---|---|
JWT_SECRET |
JWT 서명 키 (최소 256bit) | 개발용 기본값 (운영에서 반드시 오버라이드) |
application.yml에서 고정 관리하는 값:
-
jwt.access-token-expiration: Access Token 만료 시간 (ms) -
jwt.refresh-token-expiration: Refresh Token 만료 시간 (ms)
docker-compose에서 MySQL 컨테이너 초기화에 사용된다:
| 변수 | 설명 |
|---|---|
MYSQL_ROOT_PASSWORD |
root 비밀번호 |
MYSQL_DATABASE |
초기 생성할 데이터베이스 |
MYSQL_USER |
초기 생성할 사용자 |
MYSQL_PASSWORD |
사용자 비밀번호 |
-
be/.env.example— 템플릿 (Git 추적) -
be/.env— 실제 값 (.gitignore, 로컬 전용) - 운영 환경은 SealedSecret으로 K8s에서 주입
Vite의 import.meta.env로 접근한다. VITE_ 접두사가 필수.
| 변수 | 설명 | 개발 | 운영 |
|---|---|---|---|
VITE_API_URL |
BE API 베이스 URL | http://localhost:8080 |
배포 시 설정 |
| 파일 | 용도 | Git 추적 |
|---|---|---|
.env.example |
템플릿 | O |
.env.development |
로컬 개발 기본값 | O |
.env.production |
운영 빌드 기본값 | O |
.env.local |
개인 오버라이드 | X (.gitignore) |
로컬 개발 시 /api 경로는 Vite dev server가 BE로 프록시한다:
브라우저 → localhost:3000/api/* → (Vite 프록시) → localhost:8080/api/*
프록시 대상은 VITE_API_URL 환경변수로 결정된다.
운영 환경의 민감 정보는 SealedSecret으로 관리한다.
평문 값 → kubeseal 암호화 → SealedSecret YAML → Git 커밋
↓
ArgoCD 동기화 → Sealed Secrets Controller 복호화 → Secret → Pod 환경변수
| 시크릿 | 포함 값 | 사용처 |
|---|---|---|
mysql-secret |
DB 사용자명, 비밀번호, 데이터베이스명 | MySQL StatefulSet + BE Deployment |
jwt-secret |
JWT 서명 키 | BE Deployment |
헬스체크 엔드포인트는 프로필과 무관하게 동일하다.
| 경로 | 용도 |
|---|---|
/health/liveness |
프로세스 생존 확인 |
/health/readiness |
서비스 준비 상태 (DB + Redis 연결 포함) |
K8s Deployment의 probe가 이 엔드포인트를 사용한다.