Skip to content

스토리지 MinIO -> R2 변경 운영 배포 - #158

Merged
tnals0924 merged 23 commits into
mainfrom
develop
Nov 11, 2026
Merged

tnals0924 merged 23 commits into
mainfrom
develop

Conversation

@tnals0924

Copy link
Copy Markdown
Member

No description provided.

tnals0924 and others added 23 commits July 24, 2026 23:02
- HikariCP 풀 크기 15로 고정, 커넥션 획득 타임아웃 3초로 단축
- max-lifetime 29분 설정으로 MySQL wait_timeout 만료 커넥션 획득 방지
- Tomcat 스레드 최대 100, 대기 큐 100으로 조정
- 배포 시 처리 중 요청 유실 방지를 위한 graceful shutdown 적용

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
chore: 동시 접속 100명 기준 커넥션 풀/스레드 풀 설정 적용
fix: 납부자 목록 조회 정렬 순서와 불일치하는 인덱스 수정
FCM 호출이 알림 저장 트랜잭션 안에 있어, 푸시가 실패하면 방금 저장한
Notification 레코드까지 롤백되고 관리자 알림은 루프 중간에서 끊겼다.
또 HTTP 호출이 끝날 때까지 HikariCP 커넥션을 점유했다.

- NotificationService는 알림 저장만 담당하도록 축소 (FCMService, MemberService 의존 제거)
- PushNotificationSender를 추가해 트랜잭션 밖에서 푸시 발송, 실패를 예외로 전파하지 않음
- NotificationEventHandler의 REQUIRES_NEW 제거 — 저장은 짧은 트랜잭션에서 커밋 후 푸시 발송
- FCMService 반환 타입을 Boolean에서 PushResult로 교체해 재시도 가능 여부를 구분
  (기존에는 네트워크 오류·FCM 5xx도 true로 반환되어 실패가 호출부에 전달되지 않았음)

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
자동 설정 실행기(applicationTaskExecutor)는 큐가 무제한이라 FCM 지연 시
태스크가 계속 쌓이고, 종료 대기 설정이 없어 배포 시 큐에 남은 알림이 유실됐다.

- notificationTaskExecutor 정의 (코어 4 / 최대 8 / 큐 500)
- 큐 포화 시 CallerRunsPolicy로 유실 대신 지연 선택
- 종료 시 최대 20초간 잔여 작업 처리 대기
- AsyncUncaughtExceptionHandler 등록해 실패한 비동기 작업을 식별 가능하도록 기록

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Retryable로 분류된 푸시 실패가 로그로만 남고 유실됐다. FCM 일시 장애나
네트워크 오류로 실패하면 사용자는 대여 승인 알림을 영영 받지 못한다.

발송 대상을 수신자 단위 row로 DB에 남기고 스케줄러가 미발송 건을 재시도한다.
알림과 같은 트랜잭션에서 저장되므로 프로세스가 재시작돼도 발송 대상이 남는다.

- notification_push_outbox 테이블 및 엔티티 추가 (상태/재시도 횟수/다음 시도 시각/마지막 오류)
- 백오프 30초 → 2분 → 5분 → 15분, 최대 4회. 생성 후 1시간 경과 시 EXPIRED로 포기
- 즉시 발송과 재시도가 같은 경로(PushNotificationSender.dispatch)를 공유
- 새 row의 nextRetryAt을 60초 뒤로 잡아 즉시 시도와 폴러의 중복 발송 방지
- InvalidToken은 재시도 없이 토큰 제거 후 종료
- 상태 전이(백오프/최대 횟수/TTL) 단위 테스트 추가

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
발송이 끝난 아웃박스 row가 계속 남았다. 알림 한 건마다 수신자 수만큼 쌓이므로
방치하면 재시도 대상 조회가 느려진다.

- 매일 새벽 4시(KST) 보존 기간이 지난 건 삭제
- SENT 7일, FAILED/EXPIRED 30일(실패 원인 확인용), PENDING은 삭제하지 않음
- 배치(500건) 단위로 나눠 삭제하고 배치마다 트랜잭션을 끊어 락 구간을 짧게 유지
- 한 회 처리량 상한(20배치)에 도달하면 남은 건이 있다는 경고 로그
- 정리 조회용 인덱스 (delivery_status, created_at) 추가

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
refactor: 알림 발송 구조 개선, 아웃박스 재시도 및 보관 정책
TTL 1시간은 이 서비스의 알림 성격에 비해 지나치게 길다. 대여 승인은 사용자가
지금 과방에 갈지 결정하는 정보고, 관리자 알림도 학생이 기다리는 상태에서
처리해야 하는 일이라 늦게 도착하면 의미가 없다.

- 유효 시간을 1시간에서 10분으로 단축
- 도달할 수 없게 된 15분 백오프 제거 (30초 → 2분 → 5분, 최대 3회, 누적 7분 30초)
- 다음 재시도 시각이 유효 시간을 넘기면 예약하지 않고 즉시 EXPIRED 처리
  (기존에는 만료될 것이 뻔한 시도를 예약해 두고 폴러가 집어간 뒤에야 만료를 확인했다)

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
fix: 푸시 유효 시간을 10분으로 단축
#142에서 인덱스를 (enrollment_year DESC, name) 순서로 맞췄지만 정렬 비용은
그대로 남아 있었다. 원인은 두 가지다.

1. ORDER BY가 두 곳에서 지정됨
   findAllByNameContaining()의 @query에 ORDER BY가 하드코딩된 상태에서
   PageRequest에도 Sort를 넘기고 있었다. Spring Data는 @query에 ORDER BY가
   있으면 Pageable의 Sort를 지우지 않고 뒤에 이어붙이기 때문에 실제 SQL은
   `order by enrollment_year desc, name asc, enrollment_year desc, id asc`가
   되고, 정렬 키가 인덱스와 어긋나 매 조회마다 filesort가 발생했다.
   덤으로 하드코딩된 키가 항상 앞에 오는 탓에 criteria 파라미터는 무시됐고,
   엔티티에 없는 이름을 넣으면 HQL이 깨져 500이 났다.

   @query에서 ORDER BY를 걷어내고 정렬 생성을 resolveSort() 한 곳으로 모았다.
   criteria는 화이트리스트로 받아 알 수 없는 값이면 기본 정렬로 떨어진다.

2. 검색어가 없어도 LIKE '%%'를 태움
   SearchCondition.search의 기본값이 ""라 목록 첫 진입에도 술어가 붙었다.
   한 건도 걸러내지 못하면서 선행 와일드카드로 인덱스 접근만 막는다.
   검색어가 비어 있으면 술어 없이 findAll(pageable)로 보낸다.

응답의 행 순서는 바뀌지 않는다. 기존에도 뒤에 붙던 id asc가 동점 처리
역할을 하고 있어 최종 정렬 결과는 동일하고, 정렬 방법만 filesort에서
인덱스 순서 스캔으로 바뀐다.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
show-sql은 org.hibernate.SQL 로거와 별개로 System.out에 직접 쓴다.
로그 레벨로 끌 수 없고, 비동기 appender로 돌릴 수도 없으며, System.out이
동기화된 스트림이라 요청 스레드들이 출력 락에서 직렬화된다. dev는 부하
테스트 대상 환경이기도 해서 측정에 잡음을 넣는다.

format_sql은 BasicFormatterImpl이 쿼리마다 SQL 문자열을 파싱해 들여쓰기를
넣는 비용이고, 출력이 꺼지면 수행되지 않으므로 show-sql과 함께 끈다.

대신 logging.level에 org.hibernate.SQL과 org.hibernate.orm.jdbc.bind를
남겨, SQL을 봐야 할 때 레벨만 올리면 되도록 했다. 이쪽은 Logback을 타므로
레벨과 appender 제어가 정상적으로 된다.

application-local.yml은 그대로 둔다. 개발자 개인 머신이라 SQL이 바로
보이는 편이 유용하고 출력 경합이 문제가 되지 않는다.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
chore: dev 프로파일의 SQL 콘솔 출력 제거 - #151
fix: 납부자 목록 조회 정렬 중복 제거 및 criteria 파라미터 오동작 수정
Logback의 ConsoleAppender는 OutputStreamAppender를 상속하고 write가
동기화돼 있다. 톰캣 스레드 100개가 한 스트림에 쓰면 그 락에서 직렬화되고,
로그 한 줄의 비용이 그대로 응답시간에 실린다.

#151에서 dev의 SQL 콘솔 출력을 끄자 납부자 목록 조회 p95가 452ms에서
240ms로 줄었다. 출력량을 줄여 절반을 회수했지만 구조는 그대로였다.
LoggingFilter가 요청마다 남기는 한 줄이 여전히 같은 경로로 나간다.
출력을 더 줄이는 대신 요청 스레드에서 I/O를 떼어낸다.

AsyncAppender 기본값 두 개는 의도와 맞지 않아 명시적으로 바꿨다.

- discardingThreshold: 기본값 20은 큐가 80% 차면 INFO 이하를 조용히
  버린다. LoggingFilter의 요청 로그가 INFO라 부하 상황에서 소리 없이
  사라진다. 0으로 두어 레벨과 무관하게 큐에 자리가 있는 한 남긴다.
- neverBlock: 기본값 false는 큐가 가득 차면 요청 스레드를 블로킹한다.
  비동기로 만든 이유가 사라지므로 true로 둔다. 응답시간을 지키는 게
  목적이라 로그 유실보다 블로킹을 더 나쁘게 봤다.

커스텀 설정 파일이 있으면 Spring Boot 기본 로깅 설정이 통째로 대체되므로,
로그 포맷과 CONSOLE appender 정의는 defaults.xml과 console-appender.xml을
include해 그대로 쓴다. 목적지는 콘솔 그대로 두었다. CapRover가 stdout을
수집하는 구조라 파일 appender는 필요하지 않다.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
chore: 로그 출력을 비동기 appender 로 분리
- build-docker-image 잡(Docker Hub, latest 태그)은 그대로 유지
- deploy 잡의 CapRover 액션을 Coolify API(GET /api/v1/deploy?uuid=...&force=true) 호출로 교체
- prod/dev 각각 COOLIFY_PROD_RESOURCE_UUID / COOLIFY_DEV_RESOURCE_UUID 사용

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01BwEtkafDnUZh8TeKrrzuEo
deploy: CD 배포를 CapRover에서 Coolify로 마이그레이션
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- MinIO SDK를 AWS SDK v2(S3 호환)로 교체하고 R2Config/R2Service 구현
- R2 공개 URL은 버킷에 직접 연결되므로 이미지 URL에서 버킷명 제거
- R2 비호환 기본 체크섬 계산을 WHEN_REQUIRED로 제한
- 설정 키를 minio.* 에서 r2.* 로 변경 (R2_ENDPOINT, R2_ACCESS_KEY, R2_SECRET_KEY, R2_BUCKET, R2_PUBLIC_URL)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
refactor: 파일 저장소를 MinIO에서 Cloudflare R2로 교체
@tnals0924 tnals0924 self-assigned this Nov 11, 2026
@tnals0924 tnals0924 added the release 배포 label Nov 11, 2026
@tnals0924
tnals0924 merged commit b64efd6 into main Nov 11, 2026
3 of 5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

release 배포

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant