Skip to content

[FBE-7] 환경별 도메인 및 Nginx 라우팅 구성 - #4

Merged
young0311 merged 22 commits into
devfrom
chore/FBE-7-nginx-routing
Oct 19, 2026
Merged

young0311 merged 22 commits into
devfrom
chore/FBE-7-nginx-routing

Conversation

@young0311

@young0311 young0311 commented Oct 6, 2026 •

Copy link
Copy Markdown
Member

🔗 연관된 이슈

FBE-7

📝 작업 내용

  • Swagger/OpenAPI 접근을 위한 Spring Security 설정
    • Local Swagger 및 Nginx에서 OpenAPI 문서 접근 허용
  • Dev Swagger 환경 구성
    • Swagger UI 및 서비스별 OpenAPI 문서 경로 설정
    • Swagger UI 전용 Docker 이미지 구성
    • Nginx Reverse Proxy 및 DNS 설정
  • Dev 브랜치 기반 Swagger 문서 연동
    • Dev 브랜치에 반영된 API가 Dev Swagger 문서에 반영되도록 구성

💬 리뷰 요구사항(선택)

리뷰어가 특별히 봐주었으면 하는 부분이 있다면 작성해주세요

ETC

dev 환경 워크플로우 개선사항

  • 공통 모듈 변경 감지 로직 검증 및 개선

  • Docker Compose 설정 변경 감지 추가

  • Swagger 및 Nginx Health Check 추가

  • 배포 실패 처리 및 동시 배포 제어 개선

  • SSL 인증서 자동 갱신 설정

  • coderabbit 도입

  • db admin username 변경

* 현재 도메인 기준 서비스별 API 문서 경로 설정
* Member Service를 기본 API 문서로 설정
* Swagger UI 전용 Dockerfile 추가
* swagger-config.json 로드 설정
@young0311 young0311 added the CHORE label Oct 6, 2026
@young0311 young0311 self-assigned this Oct 6, 2026
* framey-common 하위 멀티모듈(common-web, common-jpa, common-monitoring)을 역할 기반의 최상위 모듈 구조로 재구성
* framey-web을 분리하여 Swagger 등 웹 계층 공통 설정 배치
* framey-monitoring을 분리하여 모니터링 및 로깅 관련 구성의 책임 분리
* framey-infrastructure를 생성하여 배포 및 인프라 관련 설정을 애플리케이션 모듈과 분리
* 기존 문서에서 경로 관련 부분을 변경된 경로로 수정
* 구조 개선함으로써 책임 분리
* FQCN으로 직접 참조하던 PublicApi, ApiErrorCodeExample을 import 방식으로 변경
* Framey와 Swagger의 ApiResponse 클래스명 충돌을 고려해 Swagger ApiResponse를 import하고 공통 응답은 FQCN으로 명시
* ErrorCode 구현체의 enum 타입 검증 메시지를 상수화
* include 목록을 Set으로 변경
* member-service 기본 패키지 및 Spring Boot 애플리케이션 구성
* 로컬 PostgreSQL 실행을 위한 docker-compose-local 수정 및 DB 정보 환경 변수로 분리
* DB 호스트 포트를 5433으로 변경
* env 파일 .gitignore에 포함
* 테스트 모듈 실행 시 데이터베이스 연결 오류 해결

* PostgreSQL과 H2 간 호환성 문제로 H2가 아닌 Local 데이터베이스에 연결
* 추후 필요에 따라 테스트 환경 분리 예정
* swagger 문서 내 서비스명 변경 ( mypage → archive )
* 테스트 전용 PostgreSQL Docker Compose 추가
* Local/Test 환경별 PostgreSQL 컨테이너 및 포트 분리 (5433/5434)
* 환경별 .env 파일을 통한 DB 정보 관리
* PostgreSQL pg_isready 기반 Healthcheck 설정
*  DEV DB 환경변수 바인딩 (DEV_DB_URL, DEV_DB_USER, DEV_DB_PASSWORD)
*  springdoc api-docs 활성화, swagger-ui 비활성화
* Actuator health/info endpoint 노출 설정
*  HTTP → HTTPS 301 리다이렉트
* OpenAPI JSON 프록시 (/api-docs/* → 각 서비스 /v3/api-docs)
* 서비스별 API 프록시 (swagger 문서 내 테스트)
* Swagger UI 기본 라우팅 설정
* 테스트용 브랜치(chore/FBE-7-nginx-routing)로 git pull 대상 변경
* Health Check 단계에 누락된 SSH key 추가
* script 블록 내 주석 들여쓰기 수정 및 주석 제거
@young0311
young0311 merged commit e3bc180 into dev Oct 19, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant