• 4.8.1

    hanyul released this 2026-10-03 17:22:15 +09:00

    4.8.1 f2a86ece1b 2067 commits

    4.8.0 대비 변경사항

    UI/UX

    • Navigation 줄바꿈 수정 — Windows 클래식 스크롤바와 맑은 고딕에서 관리자 메뉴가 두 줄로 꺾이던 구간을 고쳤습니다. desktop 메뉴 시작을 833px에서 872px로, 계정 이름·로그인/로그아웃 글자 표시 시작을 1024px에서 1040px로 올렸습니다. 872px 미만은 햄버거 메뉴를 사용합니다.
    • 같은 속성의 반응형 간격을 px 기준으로 맞춰 Tailwind rem 기준과 출력 순서가 충돌하지 않게 했습니다. 전환 경계의 단위·브라우저 회귀 검증을 추가했습니다.

    문서

    • README를 해결하는 문제·사용 장면·사전 조건·첫 실행 중심으로 재구성했습니다.
    • 공통·영역별 작업 규칙의 적용 범위와 여러 checkout의 공유 개발 stack·runner 주의를 정리했습니다.
    • 문서 색인에 독자와 단일 소유 범위를 표시하고 운영·API·아키텍처·DB·중복 검사·테스트 안내의 링크·수치·현재 구현 설명을 바로잡았습니다. 중복 설명은 소유 문서로 연결하고 완료 이력을 최신 게시·마지막 운영 배포·영역별 검증 기준선으로 정리했습니다.

    호환되는 UI 수정과 문서 정리이므로 patch 버전입니다. 내부 private 패키지의 manifest·lock 버전은 4.8.0과 같이 유지하고 릴리스 버전은 Git 태그·이미지 OCI label로 관리합니다.

    이미지 게시 범위

    4.8.0 게시 뒤 latest의 빌드 입력 label과 최종 소스를 대조해 web만 새로 빌드하고 4.8.1·latest를 게시했습니다(publish-images.ps1 -ChangedOnly). web은 Navigation 실행 코드가 바뀌었습니다. backend·crawler·nginx·byedpi는 빌드 입력 지문이 같아 기존 latest digest를 유지하며 4.8.1 태그를 추가하지 않습니다. log-reader는 backend 이미지를 공유하고 PostgreSQL·Redis·Silo는 별도 자체 이미지 게시 대상이 아닙니다.

    NAS 업데이트

    4.8.0 대비 compose.yml·배포 스크립트·환경 키·DB migration 변경은 없습니다. 4.8.0이 이미 반영된 NAS는 web만 갱신하면 됩니다. 아래는 운영자 안내이며 이번 릴리스 작업에서는 NAS 배포를 실행하지 않습니다.

    cd /volume1/2ex-hentai
docker login git.2ex.dev
docker compose --env-file .env.production pull web
docker compose --env-file .env.production up -d --no-deps web
docker compose --env-file .env.production ps web

    4.8.0보다 이전 버전에서 업데이트하면 먼저 4.8.0 릴리스의 Compose·migration·배포 안내를 확인합니다. 마지막으로 기록된 NAS 배포는 4.6.0이며 4.7.0·4.8.0 운영 반영은 확인되지 않았습니다.

    알려진 주의사항

    • -ChangedOnly로 web에만 4.8.1 태그가 있으므로 전체 서비스를 IMAGE_TAG=4.8.1로 일괄 지정하거나 일괄 rollback할 수 없습니다. 운영은 기본 latest를 사용하고 rollback은 서비스별 기존 digest·Compose·migration 호환성을 확인합니다.
    • NAS 배포·실제 운영 브라우저의 메뉴 전환 확인은 미실행입니다. 기존 릴리스의 운영 검증 미확인 항목은 이번 UI·문서 릴리스로 해소되지 않습니다.

    4.8.0 대비 전체 변경

    검증

    • 코디네이터가 확인한 Navigation fd4b1b3b의 run-unit.ps1 -Workspace web 963개, web production build, run-integration.ps1(브라우저 871px 햄버거·872px 한 줄 포함) 통과 결과를 재사용했습니다. 이후 실행 코드가 같아 재실행하지 않았습니다.
    • 게스트·일반·관리자 × 라이트·다크 × 맑은 고딕/클래식 스크롤바·Noto Sans KR/스크롤바·기본 폰트/무스크롤바의 760~1440px 1px 측정은 fd4b1b3b 기준선이며 운영 브라우저 확인을 대신하지 않습니다.
    • 통합 문서 fada8dff에서 링크 415개·anchor 273개 오류 0, 개발·운영 Compose config와 git diff --check 통과 결과를 재사용했습니다. 게시 전 깨끗한 checkout·production Compose 설정·실제 Turnstile 빌드 키 존재·서비스별 입력 지문을 확인했습니다.

    게시 확인

    • 릴리스 소스: 1cedd031b1f07ba0ad2750765927cda97b72e887 (주석 태그 4.8.1).
    • web 4.8.1·latest: sha256:a14687e35c7ae1905d915974ce92c8ab9a9ace10cdf90715a922c0e1ace73f59
    • web OCI version 4.8.1·revision 1cedd031b1f07ba0ad2750765927cda97b72e887·빌드 입력 hash baa2d560d2ef7cac1ca4043970f058971158c4fb3280cbdf14d28abdf40535eb 일치를 확인했습니다.
    • backend 기존 latest: sha256:8a45d2408182b31b0dd58d642dc04c2ae2bc31ac0ed36195131d22aae265b932
    • crawler 기존 latest: sha256:6ee14a74a3992e892a0612881bfd311755827e2649e173768d04fb5e02d02466
    • nginx 기존 latest: sha256:e40f31f88d0af2c48b739d2cd3165cefcfd83e92603510b4b0c22fe3010df7ee
    • byedpi 기존 latest: sha256:15ac60ab852a92219573aa3e3795f700e9da0692022af47233590e6a78a1a40a
    • 생략한 네 서비스는 기존 OCI version·revision·digest를 유지하며 4.8.1 태그를 추가하지 않았습니다.
    Downloads 2