Skip to content

[BOM-1290] chore: 배포시 코드가 바뀌지 않은 JS 파일은 이름이 바뀌지 않도록 빌드 설정 변경 - #382

Merged
sanghee01 merged 2 commits into
devfrom
chore/BOM-1290
Nov 3, 2026
Merged

sanghee01 merged 2 commits into
devfrom
chore/BOM-1290

Conversation

@sanghee01

@sanghee01 sanghee01 commented Nov 2, 2026 •

Copy link
Copy Markdown
Member

📌 What

  • 코드가 바뀌지 않은 JS 파일은 배포 후에도 같은 이름을 유지하도록 빌드 설정 변경

❓ Why

  • 지금은 배포할 때마다 JS 파일 142개의 이름이 전부 바뀜
  • 사용자는 배포 후 첫 접속 때 바뀌지 않은 코드까지 JS 약 4.4MB를 전부 다시 받음 (브라우저 캐시가 매번 무효화됨)
  • 배포 전에 열어 둔 화면은 이전 이름의 JS 파일을 요청함. 이름이 바뀌는 파일이 많을수록 #381에서 다룬 "문제가 발생했어요" 화면이 뜰 가능성이 커짐

🔧 How

항목 변경 전 변경 후
Sentry release 주입 모든 JS 파일 맨 앞에 SENTRY_RELEASE={id:"<커밋 sha>"} 삽입 release.inject: false로 주입 끔
process.env 정의 process.env 전체를 정의 src/apis/env.ts가 쓰는 값만 개별로 정의, 나머지는 빈 객체
  • release 주입: 커밋 sha가 배포마다 달라 모든 파일 내용과 이름이 바뀌던 원인. release는 이미 Sentry.init에 직접 넘기고 있어(src/libs/sentry/initSentry.ts) 주입값은 쓰이지 않았음
  • NODE_ENV는 webpack이 mode로 넣어 주므로 목록에서 제외

왜 src/apis/env.ts에서 쓰는 값만 넣었나

  • 빌드된 JS는 누구나 열어 볼 수 있어, 브라우저에 필요한 값만 넣어야 함
  • 기존 설정에서는 MSW 로그 코드 때문에 CI 서버의 환경변수 전체(GITHUB_SHA 등)가 JS 파일 2개에 들어갔고, 그 값이 배포마다 달라 두 파일 이름도 매번 바뀜
  • 앱이 쓰는 값은 그대로 들어가므로 동작은 같음

👀 Review Point

  • release 값만 다르게 운영 빌드를 두 번 하고 JS 파일 이름 비교

    이름이 같은 JS 파일
    변경 전 0 / 142
    release 주입만 끔 137 / 142
    환경변수까지 정리 141 / 142

    남은 1개는 release 값을 담은 env.ts가 들어 있는 파일이라 배포마다 바뀌는 게 정상

  • 빌드 결과를 로컬에서 띄워 첫 화면과 메뉴 이동(JS 파일 추가 로드) 확인. 에러 화면, process 관련 에러 없음

  • pnpm --filter web type-check, pnpm --filter web lint (에러 0, 기존 경고 2건)

  • dev 배포 후 Sentry 이벤트에 release가 그대로 찍히는지 확인

  • 운영 배포 후 source map이 연결된 스택 트레이스가 보이는지 확인

🤖 Generated with Claude Code

@coderabbitai

coderabbitai Bot commented Nov 2, 2026 •

Copy link
Copy Markdown

Warning

Review limit reached

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

Next included review available in 7 minutes.

Check out review usage here.

View limit details

Limit details: You’ve used the included review currently available.

Learn how review limits work.

Review configuration:

Run configuration
Commits

Reviewing files that changed from the base of the PR and between 09cb6fa and 33cd1c9.

Files selected for processing: 1
  • web/webpack.config.ts
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

Share

@sanghee01 sanghee01 left a comment

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 PR Review

✅ 꼭 고쳐야 할 문제는 찾지 못했습니다.

🚨 0 Critical · ⚠️ 0 Major · 📝 0 Minor

Critical: 장애·데이터 손실·보안 문제 · Major: 특정 상황에서 생기는 버그 · Minor: 동작은 하지만 고치면 좋은 것

요약

꼭 고쳐야 할 문제는 찾지 못했습니다. 번들에서 읽는 환경변수가 모두 개별 정의에 들어 있고, Sentry release는 Sentry.init에서 직접 넘기고 있어 주입을 꺼도 이벤트의 release 값은 그대로입니다.

👀 Review Point 확인 결과

항목 결과 근거
JS 파일 이름 비교 (141 / 142) ❔ 확인 못 함 운영 빌드를 직접 돌리지 않았습니다. 코드상으로는 배포마다 바뀌는 값이 SENTRY_RELEASE(env.ts에 들어감)뿐이라 작성자 측정 결과와 맞습니다.
process 관련 런타임 에러 여부 ✅ 문제 없음 head 기준 web/src·shared/src에서 process.env를 읽는 곳은 web/src/apis/env.ts:2-12뿐이고, 그 키는 모두 CLIENT_ENV_KEYS, ENABLE_MSW, webpack mode의 NODE_ENV로 정의됩니다.
dev 배포 후 Sentry 이벤트의 release ✅ 문제 없음 web/src/libs/sentry/initSentry.ts의 init에 release: ENV.sentryRelease를 넘기고 있어 주입값에 의존하지 않습니다. 실제 이벤트는 배포 후 확인이 필요합니다.
운영 배포 후 source map 연결 ❔ 확인 못 함 release.inject: false는 release 주입만 끄고 sourcemaps 업로드와 debug ID 주입 설정은 그대로입니다. 실제 연결은 배포 후 Sentry에서 확인해야 합니다.
📋 리뷰하면서 확인한 내용
  • web/webpack.config.ts 전체를 head 기준으로 읽었습니다. @bombom/shared/env alias가 web/src/apis/env.ts를 가리켜 shared 코드도 같은 정의를 씁니다.
  • git grep 'process\.env'로 web/src·shared/src를 검색해 env.ts 외 사용처가 없음을 확인했습니다. node_modules 안 라이브러리의 process.env.* 참조는 확인하지 않았습니다.
  • SENTRY_RELEASE는 .github/workflows/frontend-ci-base.yml:57에서 github.sha로 넣고 있어 release 이름과 업로드는 기존과 같습니다.
  • 빌드, lint, type-check, 브라우저 실행은 하지 않았습니다.

🤖 Claude PR Review


Generated by Claude Code

@sanghee01 sanghee01 changed the title [BOM-1290] chore: 배포마다 JS 파일 이름이 바뀌지 않도록 빌드 설정 변경 [BOM-1290] chore: 배포시 코드가 바뀌지 않은 JS 파일은 이름이 바뀌지 않도록 빌드 설정 변경 Nov 2, 2026

@JeLee-river JeLee-river left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM 입니다~!

@sanghee01
sanghee01 merged commit 28b44e0 into dev Nov 3, 2026
4 checks passed
@sanghee01
sanghee01 deleted the chore/BOM-1290 branch November 3, 2026 06:40

This branch was previously deployed

1 inactive deployment
dev — 33cd1c9b Deployed Nov 2, 2026 by sanghee01 via pre-build / web-checks #978
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants