Baron SSO 다중 인스턴스 배포 가이드

이 프로젝트는 한 대의 서버(머신)에서 여러 개의 독립된 서비스 인스턴스(예: stg, test2, prod 등)를 충돌 없이 실행하기 위한 템플릿 기반 자동 배포 시스템을 사용합니다.

1. 폴더 구조

deploy/templates/: 모든 설정의 원천이 되는 마스터 템플릿.
deploy/create-instance.sh: 새로운 인스턴스를 생성하는 마법사 스크립트.
instances/: (자동 생성) 실제 실행되는 인스턴스별 설정 파일들이 저장되는 곳.

2. 핵심 배포 전략

2.1 포트 Prefix 시스템

모든 포트는 환경 변수 P (Port Prefix)를 기반으로 자동 계산됩니다.

예: 포트 Prefix를 23으로 설정 시:
- Backend: 23000
- PostgreSQL: 23432
- UserFront: 23500
- AdminFront: 23173

2.2 네임스페이스 격리

모든 리소스 이름에 ${INSTANCE_NAME}이 자동으로 붙어 도커 엔진 내에서 격리됩니다.

컨테이너: baron-sso-test2_backend
네트워크: baron-sso-test2_net
볼륨: db_data_test2

3. 새로운 인스턴스 배포 방법

Step 1: 인스턴스 생성

deploy/ 폴더로 이동하여 스크립트를 실행합니다.

cd deploy
./create-instance.sh [인스턴스이름] [포트앞자리]

예시: test3 환경을 24xxx 포트 대역으로 만들고 싶을 때
./create-instance.sh test3 24

Step 2: 서비스 실행

생성된 인스턴스 폴더로 이동하여 도커 컴포즈를 실행합니다.

cd instances/test3
docker compose up -d

4. 도메인 및 URL 규칙

스크립트 실행 시 인스턴스 이름에 따라 다음 도메인이 자동으로 설정 파일에 주입됩니다. (DOMAIN_SUFFIX는 .env에서 수정 가능)

SSO/UserFront: https://[이름]-sso.hmac.kr
AdminFront: https://[이름]-admin.hmac.kr
DevFront: https://[이름]-dev.hmac.kr

5. 주요 설정 파일 관리

Nginx (Gateway & UserFront): 각 인스턴스의 백엔드 포트를 자동으로 감지하여 리버스 프록시를 수행합니다.
Ory Kratos: allowed_origins, allowed_return_urls, webhook 주소 등이 인스턴스 포트에 맞게 자동 치환됩니다.
Ory Oathkeeper (rules.json, rules.active.json): 인증 규칙 내의 업스트림 주소가 현재 인스턴스 포트에 맞게 자동 치환됩니다.
Environment (.env): 모든 시크릿과 URL 설정이 중앙에서 관리됩니다.

6. Vite 프론트엔드 주의사항

Vite 개발 서버나 Preview 모드를 사용하는 경우, vite.config.ts의 allowedHosts 설정이 새로운 도메인을 차단할 수 있습니다. 여러 인스턴스를 동적 도메인으로 운영할 경우, vite.config.ts에서 allowedHosts: true (Vite 5.1+) 설정을 권장합니다.

주의: 새로운 인스턴스 생성 후 외부에서 접속하려면, 앞단의 메인 리버스 프록시(Nginx 등)나 DNS 설정에서 해당 인스턴스의 포트(USERFRONT_PORT)로 라우팅해주는 작업이 필요합니다.

3.1 KiB Raw Blame History