Skip to content

Environment Config

wcorn edited this page Apr 2, 2026 · 1 revision

환경 설정 가이드

프로필별 환경 구성과 환경변수를 정의한다.

1. BE 프로필 구조

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 자동 생성

local 프로필 특이사항

개발 편의를 위해 추가 로깅이 활성화된다:

  • org.hibernate.SQL: DEBUG — 실행 SQL 출력
  • org.hibernate.orm.jdbc.bind: TRACE — 바인드 파라미터 출력
  • org.hibernate.stat: DEBUG — 쿼리 통계

test 프로필 특이사항

  • MySQL: TestContainers JDBC 드라이버 (jdbc:tc:mysql:8.4.4:///)
  • Redis: TestContainers Redis 컨테이너
  • JPA DDL: create-drop (테스트마다 스키마 재생성)

2. BE 환경변수

필수 환경변수

변수 프로필 설명 예시
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 설정

변수 설명 기본값
JWT_SECRET JWT 서명 키 (최소 256bit) 개발용 기본값 (운영에서 반드시 오버라이드)

application.yml에서 고정 관리하는 값:

  • jwt.access-token-expiration: Access Token 만료 시간 (ms)
  • jwt.refresh-token-expiration: Refresh Token 만료 시간 (ms)

Docker Compose 전용 변수

docker-compose에서 MySQL 컨테이너 초기화에 사용된다:

변수 설명
MYSQL_ROOT_PASSWORD root 비밀번호
MYSQL_DATABASE 초기 생성할 데이터베이스
MYSQL_USER 초기 생성할 사용자
MYSQL_PASSWORD 사용자 비밀번호

.env 파일 관리

  • be/.env.example — 템플릿 (Git 추적)
  • be/.env — 실제 값 (.gitignore, 로컬 전용)
  • 운영 환경은 SealedSecret으로 K8s에서 주입

3. FE 환경변수

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)

Vite Dev Server 프록시

로컬 개발 시 /api 경로는 Vite dev server가 BE로 프록시한다:

브라우저 → localhost:3000/api/* → (Vite 프록시) → localhost:8080/api/*

프록시 대상은 VITE_API_URL 환경변수로 결정된다.

4. 운영 환경 시크릿

운영 환경의 민감 정보는 SealedSecret으로 관리한다.

평문 값 → kubeseal 암호화 → SealedSecret YAML → Git 커밋
    ↓
ArgoCD 동기화 → Sealed Secrets Controller 복호화 → Secret → Pod 환경변수
시크릿 포함 값 사용처
mysql-secret DB 사용자명, 비밀번호, 데이터베이스명 MySQL StatefulSet + BE Deployment
jwt-secret JWT 서명 키 BE Deployment

5. Actuator 설정

헬스체크 엔드포인트는 프로필과 무관하게 동일하다.

경로 용도
/health/liveness 프로세스 생존 확인
/health/readiness 서비스 준비 상태 (DB + Redis 연결 포함)

K8s Deployment의 probe가 이 엔드포인트를 사용한다.

Clone this wiki locally