Files

7.0 KiB

번역 및 관리자 오디오 테스트 수정

  • 작성일: 2026-11-18
  • 상태: P7 Linux 메모리 관측 수정·86개 테스트·lint·root 구성 검증·리뷰 승인·정리 완료. 실제 Jenkins와 전체 suite는 P7 후 미실행.
  • 구현 계획: plan-task.md

목표와 범위

운영 로직을 변경하지 않고 사용자가 지정한 네 테스트의 설정·fixture 불일치를 수정한다. 기존 assertion의 의미와 검증 강도를 유지한다. 전체 테스트 통과가 사용자 목표이며, 저장소 실행 규칙에 따라 에이전트는 focused 및 관련 회귀를 검증하고 전체 실행은 사용자에게 안내한다.

수용 기준

ID 확정 요구사항 검증
TEST-01 기본 AWS 우선과 독립적인 기능 순서, 잘못된 순서 거부를 유지한다. LanguageProviderSpringConfigurationTest
TEST-02 현재 FAILED 작업 재개와 다른 언어 작업의 보존을 검증한다. 번역이 없으면 현재 언어 작업을 예약하는 기존 계약을 반영한다. OriginalWorkReadRetryTest
TEST-03 관리자 오디오 정상 응답·소유권·인증·입력 검증과 거부 요청의 부작용 없음 검증을 유지한다. AiCharacterAdminAudioContentControllerTest, AiCharacterAdminAudioContentOwnershipTest
TEST-04 운영 코드 변경, 테스트 삭제/skip/검증 완화 없이 관련 회귀를 통과한다. diff 및 focused test 결과 리뷰

제외

운영 코드와 API 계약 변경, 무관한 리팩터링, 기존 staged 변경 수정, 커밋은 제외한다.

추가 승인: 테스트 자원 수명 관리

  • 사용자가 공통 테스트 실행 설정·H2 수명 설정·직접 관련 테스트 변경을 승인했다. 운영 코드와 assertion 강도는 유지하고 commit/push는 수행하지 않는다.
  • H2의 마지막 연결 종료 시 DB 해제와 열린 연결 간 데이터 공유를 실제 JDBC/connection pool로 검증한다. context별 DB 격리는 유지한다.
  • Spring context 캐시 상한을 작은 값부터 비교하고, 진행 위치와 GC 로그를 남겨 조용한 장시간 정지를 진단할 수 있어야 한다.
  • 전체 테스트가 정상 종료하여 종료 코드/XML을 생성하고 후반 GC 과부하가 재현되지 않는지 확인한다. 필요 시 worker 교체는 원인 수정과 별도 보호 장치로 평가한다.
  • 신규 테스트 작성 규칙에 context 재사용, H2/fixture 수명, 비동기 자원 종료를 기록한다. 테스트 누락/skip/검증 완화로 완료 처리하지 않는다.

추가 승인: SQL 출력과 세 클래스 초기화 비용 최적화

  • 2026-11-19 사용자 승인: SQL 상세 출력·포맷팅 비활성화와 세 클래스의 메서드별 context 폐기를 명시적 fixture 정리로 대체한다.
  • 대상: MainContentAllEndToEndTest, ContentOverviewEndToEndTest, ContentSeriesBannerServiceIntegrationTest. DB/HTTP/commit/OSIV 및 기존 assertion을 유지한다.
  • 캐시 4개, worker 50클래스 교체, 동시 worker 1개, heap 4GB는 유지한다. 공통 context 재설계·테스트 순서 강제·운영 코드 변경은 제외한다.
  • 동일 focused 실행으로 변경 전, SQL 출력 변경 후, context 재사용 후 결과를 따로 비교한다. 출력 감소와 실제 시간 단축은 구분하며 실측 결과만 보고한다.

추가 승인: 실행 시 테스트 힙 자동 산정

  • 2026-11-19 사용자가 고정 4GB 대신 시작 시 가용 메모리를 기반으로 테스트 worker 힙을 계산하는 방식을 승인했다.
  • Gradle 8.1.1의 기본 512MB 상한으로 돌아가지 않도록 계산한 maxHeapSize를 명시적으로 전달한다. 계산은 설정 로딩 때가 아닌 Test task 실행 직전에 수행한다.
  • OS의 현재 메모리 관측값에 안전 여유와 JVM 힙 외 메모리 예산을 남기고 동시 worker 수로 나눈다. 기존에 검증한 4GiB를 보수적 실행 하한으로 유지하며, 하한 미달 또는 유효한 관측 불가 시 worker 시작 전에 이유를 알리고 중단한다. 하한은 수학적으로 입증된 최소 필요량이라는 뜻이 아니다.
  • macOS JDK의 free-only 값은 전체 가용량이 아니므로 회수 가능한 메모리 추정 규칙을 출처와 함께 명시한다. 실행 도중 가용량 변화에 따른 실시간 heap 재조정이나 무제한 할당은 제외한다.
  • 기존 cache 4개, 50클래스 worker 교체, 동시 worker 1개는 유지한다. 운영 코드 변경, commit/push는 제외한다.

추가 승인: 고정 하한과 고정 예약량 제거

  • Jenkins가 보고한 availableBytes=2460004352를 4GiB 하한 때문에 거부한 뒤, 사용자가 하한도 고정하지 말고 현재 관측값으로 결정하도록 승인했다.
  • 4GiB 정책 하한과 worker당 고정 1GiB 예약을 제거한다. 전체 관측값의 50%를 worker에 배분하고 그 예산의 25%를 힙 외 용도로 남겨, 나머지 75%를 힙 상한으로 사용한다. worker 수와 MiB 내림을 유지한다.
  • 정책상의 최소 힙을 임의로 올려 할당하지 않는다. 현재 JDK가 실행 자체를 거부하는 1MiB 이하만 명시적으로 거부한다. 이는 앱 테스트의 필요 힙을 보장하는 하한이 아니다.
  • OS 관측 구현·기존 cache/fork/parallel 설정은 유지한다. Linux MemAvailable/cgroup 관측 변경, 운영 코드·commit·push는 이번 범위에 포함하지 않는다.

추가 승인: buildSrc Kotlin 통일

  • 사용자가 힙 정책과 테스트를 프로젝트 관례에 맞게 Kotlin으로 통일하도록 승인했다.
  • Java helper/test를 Kotlin 소스로 이동하고 중복 Java 파일을 제거한다. 현재 P5 계산식·OS 관측·오류·자원 정리와 58개 테스트 케이스를 보존한다.
  • buildSrc에는 Gradle 8.1.1에 맞는 kotlin-dsl을 적용하고 Java 17/JUnit 5.8.2를 유지한다. 앱의 Kotlin 1.6.21 버전과 운영 코드, root Test 정책은 변경하지 않는다.
  • public static 호출 호환성과 실제 루트 Gradle 연결을 검증한다. commit/push와 전체 앱 suite 자동 실행은 제외한다.

추가 승인: Linux 가용 메모리 관측 보정

  • Jenkins에서 available estimate=1315 MiB, maxHeap=493 MiB 선택 뒤 실제 OOM이 보고됐다. 사용자가 Linux MemAvailable와 cgroup 제한을 반영하는 수정에 동의했다.
  • Linux는 /proc/meminfo의 MemAvailable를 사용한다. JDK가 보고한 total memory가 proc MemTotal보다 작으면 JDK가 인식한 제한으로 판단하고, 그 free memory와 total memory를 넘지 않도록 가용량을 제한한다.
  • cgroup v1/v2 파싱을 새로 만들지 않고 Java 17의 컨테이너 인식 API를 재사용한다. UseContainerSupport 비활성화·미지원/발견 실패·일부 상위 계층 제한은 JDK 인식 범위를 벗어날 수 있음을 명시한다.
  • 고정 4GiB 하한을 복원하거나 힙 비율·캐시·worker 정책을 변경하지 않는다. 작은 실제 예산에서도 모든 테스트가 성공한다는 보장은 하지 않는다. 실제 Jenkins 성공 여부는 원격 재실행 전까지 미검증이다.