Activity

1. Cassiiopeia

   self-assigned this

   on Jul 26, 2026
2. Cassiiopeia

   added

   작업중작업이 진행 중인 상태작업이 진행 중인 상태

   on Jul 26, 2026
3. Cassiiopeia

   added this to RomRom 프로젝트 관리on Jul 26, 2026
4. github-actions commented on Jul 26, 2026

   

   github-actionsBot

   on Jul 26, 2026 – with GitHub Actions

   More actions

   Chuseok22 Issue Helper

   브랜치명

   20260726_#806_설정_인프라_위생_및_측정_기반_확보_서브프로젝트_A
   

   커밋 메시지

   설정_인프라_위생_및_측정_기반_확보_서브프로젝트_A : feat : {변경 사항에 대한 설명} https://github.com/TEAM-ROMROM/RomRom-BE/issues/806
   
5. github-project-automation

   moved this to 작업전 in RomRom 프로젝트 관리on Jul 26, 2026
6. Cassiiopeia

   added

   작업전작업 시작 전 준비 상태작업 시작 전 준비 상태

   and removed

   작업중작업이 진행 중인 상태작업이 진행 중인 상태

   on Jul 26, 2026
7. Cassiiopeia

   added 8 commits that reference this issue on Jul 26, 2026

   설정_인프라_위생_및_측정_기반_확보 : test : application.yml 키 위치 회귀 방지 테스트 추가(#806)

   5ece53d

   설정_인프라_위생_및_측정_기반_확보 : fix : open-in-view 키 위치 교정 및 JPA 배치 페치 튜닝(#806)

   c45c832

   설정_인프라_위생_및_측정_기반_확보 : feat : HikariCP 커넥션 풀 설정 및 누수 탐지 추가(#806)

   719433a

   설정_인프라_위생_및_측정_기반_확보 : refactor : 로그레벨 정의를 yml로 단일화(#806)

   fd6b2a0

   설정_인프라_위생_및_측정_기반_확보 : feat : Prometheus 메트릭 노출 추가(#806)

   c169458

   설정_인프라_위생_및_측정_기반_확보 : chore : 무시되던 Flyway repair-on-migrate 설정 제거(#806)

   b59163c

   설정_인프라_위생_및_측정_기반_확보 : test : 설정 런타임 바인딩 검증 테스트 추가(#806)

   8aa79e2

   설정_인프라_위생_및_측정_기반_확보 : fix : 최종 리뷰 지적사항 6건 수정 - Hibernate 통계 활성화, act…

   ...

   38e5c9c
8. Cassiiopeia commented on Jul 31, 2026

   

   Cassiiopeia

   on Jul 31, 2026

   MemberAuthor

   More actions

   설정·인프라 위생 및 측정 기반 확보 (서브프로젝트 A)

   개요

   프로젝트가 12개 모듈 / Java 346파일로 성장하는 동안 손대지 않았던 애플리케이션 설정을 정리했습니다. 코드 로직 변경 없이 설정만으로 JPA 배치 페치·커넥션 풀·로그 출력을 정상화하고, 이후 개선 작업의 효과를 숫자로 증명할 Prometheus 측정 기반을 확보했습니다.

   작업 중 설정 키가 잘못된 위치에 있어 조용히 무시되던 사례 2건과, 배포 후 실측에서 메트릭 엔드포인트에 아무도 접근할 수 없던 문제 1건을 발견해 함께 수정했습니다.

   관련 PR: #807 (설정 위생 + 측정 기반), #811 (actuator 인증 경로 보강)

   기능 흐름

   메트릭 엔드포인트 접근 경로가 이번 작업의 핵심 변경입니다.

   flowchart TD
       A(["/actuator/* 요청"]) --> B{"AUTH_WHITELIST<br/>매칭?"}
       B -->|"예 (/actuator/health)"| C["인증 없이 통과"]
       C --> D(["200 OK"])
       B -->|아니오| E{"AdminJwtAuthenticationFilter<br/>처리 대상?"}
       E -->|"아니오 (수정 전)"| F["인증 주체 미설정"]
       F --> G["hasRole ADMIN 검사<br/>익명으로 판정"]
       G --> H(["403 — 관리자도 접근 불가"])
       E -->|"예 (수정 후)"| I["Bearer 토큰 또는<br/>accessToken 쿠키 추출"]
       I --> J{"토큰 유효?"}
       J -->|아니오| K(["401"])
       J -->|예| L{"ROLE_ADMIN?"}
       L -->|아니오| K
       L -->|예| M["SecurityContext 인증 설정"]
       M --> N(["200 — 메트릭 반환"])
   

   Loading

   변경 사항

   무시되고 있던 설정 교정

   • RomRom-Web/src/main/resources/application.yml: open-in-view 키가 spring.jpa.properties.hibernate 아래에 있어 Spring Boot가 인식하지 못했습니다. false로 적혀 있었으나 실제로는 기본값 true로 동작 중이었습니다. spring.jpa 직속으로 이동하고 현재 실제 동작값인 true를 명시했습니다.
   • RomRom-Web/src/main/resources/application.yml: spring.flyway.repair-on-migrate 제거. Spring Boot 3.4.1 설정 메타데이터에 존재하지 않는 키로, "마이그레이션 전 자동 repair"라는 주석과 달리 한 번도 동작한 적이 없습니다.

   성능

   • application.yml: default_batch_fetch_size: 100 추가 — 지연 로딩 N+1을 IN 절 배치 조회로 접습니다.
   • application.yml: jdbc.batch_size: 50, jdbc.fetch_size: 100, order_inserts, order_updates, query.in_clause_parameter_padding 추가
   • application.yml: HikariCP 설정 신규 추가. 기존에는 설정이 전무해 기본 풀 크기 10으로 동작했습니다. 풀 20, 누수 탐지 5초, 커넥션 타임아웃 10초.

   로깅

   • application.yml: show_sql / format_sql / use_sql_comments 제거. show_sql은 로거를 거치지 않고 stdout으로 직행해 운영에서 로그레벨로 차단할 수 없었습니다.
   • application-dev.yml: org.hibernate.SQL: DEBUG, org.hibernate.orm.jdbc.bind: TRACE로 대체. logback을 경유하므로 프로필별 제어가 가능합니다.
   • RomRom-Web/src/main/resources/logback-spring.xml: 하드코딩된 <logger> 정의 전부 제거. Appender 정의만 담당하도록 정리하고 로그레벨은 프로필 yml 단일 소스로 통일했습니다.

   관측성

   • RomRom-Web/build.gradle: micrometer-registry-prometheus 추가
   • application.yml: actuator에 metrics, prometheus 노출. health는 유지.
   • application.yml: hibernate.generate_statistics: true — 이 설정이 없으면 Micrometer가 hibernate_* 메트릭을 아예 등록하지 않습니다.
   • RomRom-Domain-Auth/.../SecurityUrls.java: /actuator/prometheus, /actuator/metrics를 ADMIN_PATHS에 추가 (관리자 전용)
   • RomRom-Domain-Auth/.../AdminJwtAuthenticationFilter.java: /actuator/ 경로도 인증 처리 대상에 포함

   테스트

   • RomRom-Web/src/test/java/com/romrom/web/config/ApplicationYamlStructureTest.java (신규, 12개): Spring 컨텍스트·DB 없이 도는 설정 키 위치/존재 회귀 테스트
   • RomRom-Web/src/test/java/com/romrom/web/config/ConfigBindingTest.java (신규, 6개): 실기동 통합 테스트

   주요 구현 내용

   회귀 방지를 두 계층으로 나눈 이유

   이번 작업의 출발점이 "키가 잘못된 위치에 있어 조용히 무시됨"이었기 때문에, 그 계층을 직접 겨냥한 테스트를 만들었습니다.

   • ApplicationYamlStructureTest는 SnakeYAML로 application.yml을 직접 파싱해 키의 경로 자체를 단언합니다. Spring 컨텍스트를 띄우지 않아 DB·Redis 없이 어디서나 돕니다.
   • ConfigBindingTest는 실제로 컨텍스트를 띄워 Spring이 그 값을 바인딩하는지를 확인합니다. RANDOM_PORT로 실제 HTTP 요청을 보내 보안 동작까지 검증합니다.

   두 계층 중 하나만 있으면 "키는 올바른 자리에 있는데 바인딩이 안 되는" 경우나 "인프라가 없으면 회귀 방지 자체가 죽는" 문제가 생깁니다.

   변경 금지 가드

   의도된 운영 설계인 아래 항목들은 값이 실수로 바뀌면 테스트가 실패하도록 가드를 넣었습니다.

   • spring.jpa.hibernate.ddl-auto: update, spring.jpa.generate-ddl: true — Spring이 처리 가능한 스키마 변경은 Hibernate에 맡기고 나머지만 Flyway로 처리하는 운영 방식
   • spring.flyway.validate-on-migrate: false — 켜면 체크섬이 깨진 기존 마이그레이션에서 배포가 즉시 중단됩니다
   • management.endpoints.web.exposure.include의 health — Dockerfile HEALTHCHECK와 Traefik 블루/그린 전환이 의존합니다

   배포 후 발견한 메트릭 접근 불가 문제

   /actuator/prometheus를 ADMIN_PATHS로 보호한 뒤 운영에서 실측했더니 관리자 토큰으로도 403이 났습니다.

   원인은 두 인증 필터 모두 /actuator/*를 처리하지 않는 것이었습니다. TokenAuthenticationFilter는 /api/로 시작하는 경로에서만 Bearer 토큰을 읽고, AdminJwtAuthenticationFilter는 /admin, /api/admin, Swagger 경로만 다룹니다. 그 결과 actuator 요청은 인증 주체가 설정되지 않은 채 hasRole("ADMIN") 검사에 도달해 익명으로 판정됐습니다.

   AdminJwtAuthenticationFilter가 이미 Swagger라는 비-/api 경로를 같은 방식으로 처리하고 있어, 그 패턴을 그대로 따라 /actuator/를 처리 대상에 추가했습니다. /actuator/health는 필터의 화이트리스트 체크가 프리픽스 체크 뒤에 있어 여전히 미인증 200입니다.

   배포 후 실측 결과

   • 블루 → 그린 전환 성공, 기동 56.1초, 기동 예외 없음
   • 운영 로그에 RomRomHikariPool 확인 — 설정이 실제 운영에 반영된 직접 증거 (기본값은 HikariPool-1)
   • 포맷 없는 raw SQL 출력 0건 — show_sql 제거 확인
   • 커넥션 누수 경고 0건
   • /actuator/health 미인증 200 — 헬스체크 경로 정상
   • 관리자 인증 후 /actuator/prometheus 200, 본문에 hikaricp_·jvm_ 지표 포함

   PostgreSQL max_connections는 실측 결과 200이고 사용량은 59였습니다. 풀 20이면 블루+그린+테스트 환경을 합쳐도 여유가 있습니다.

   주의사항

   운영 로그레벨은 아직 DEBUG입니다

   application-prod.yml은 GitHub Secret APPLICATION_PROD_YML에서 생성되는데, 로컬 사본이 운영 배포본과 달랐습니다.

   운영 실제:  generation-model: gemini-3.1-flash-lite
   로컬 사본:  generation-model: gemini-2.0-flash-lite-001
   

   로컬 사본으로 Secret을 덮어썼다면 운영 Vertex AI 생성 모델이 조용히 구버전으로 롤백됐을 것입니다. Secret은 write-only라 권위 있는 최신본을 재구성할 수 없어 갱신을 보류했습니다.

   로컬 사본은 운영 배포본과 동기화하고 로그레벨 INFO까지 적용해두었습니다. 검토 후 APPLICATION_PROD_YML과 APPLICATION_TEST_YML을 직접 갱신하면 반영됩니다. 이것 때문에 빠진 것은 로그레벨 하나뿐이고, 나머지 개선은 공통 application.yml에 있어 이미 반영됐습니다.

   후속 작업

   1. 일반 회원 토큰의 메트릭 접근 차단 회귀 테스트 — 현재 동작은 정상(401)이나, ROLE_ADMIN 검사가 나중에 제거되면 잡아낼 테스트가 없습니다.
   2. Prometheus 스크레이퍼 운용 설계 — 지금은 만료되는 관리자 JWT를 요구해 스크레이퍼가 붙을 수 없습니다. 수동 계측에는 문제없지만 스크레이퍼 도입 전에 정적 크리덴셜 경로나 네트워크 레벨 제한이 필요합니다.
   3. OSIV 전환 — open-in-view: false는 이번 범위에서 제외했습니다. LAZY 연관관계 28개 중 @JsonIgnore로 보호된 것이 3개뿐이고 jackson-datatype-hibernate 모듈이 없어, Entity를 그대로 응답에 담는 이 프로젝트 컨벤션과 결합하면 직렬화 시점에 예외가 납니다. 엔드포인트 전수 감사가 선행돼야 합니다.
   4. Flyway 체크섬 정합화 — validate-on-migrate를 켜려면 먼저 필요합니다.

   배포 상태 참고

   작업 중 확인한 결과, 운영 컨테이너가 2026-06-20 빌드 이미지로 5주 넘게 고정돼 있었습니다. 그 사이 main에 들어간 커밋들이 배포되지 않은 상태였고, 이번 배포에 함께 실렸습니다.