Skip to content

docs(documents): 의존성 관리 구조 문서화 (#8) #11

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
1210thatman wants to merge 2 commits into from
Closed

docs(documents): 의존성 관리 구조 문서화 (#8) #11

Changes from 1 commit
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
be932b8
docs(documents): 의존성 관리 구조 문서화 (#8)
1210thatman Jan 21, 2026
996e016
docs(documents): One-Version Rule 가이드 작성 - EntryDSM 프로젝트 구조 기반 의존성 관리…
1210thatman Feb 1, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
25 changes: 25 additions & 0 deletions documents/DEPENDENCY.md
View file
Open in desktop

@kangeunchan kangeunchan Jan 21, 2026

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

  1. 프로젝트의 전체 파일 구조를 명시하면 개발자가 어디에 어떤 설정이 있는지 한눈에 파악할 수 있을 것 같습니다.
  2. 모노레포에서 가장 중요한 One-Version Rule에 대한 설명이 필요합니다.
  3. 새로운 의존성을 추가하는 과정을 단계별로 예시를 들어서 설명 해야합니다.
  4. 루트 BUILD.bazel에 정의된 별칭 시스템을 설명해야 합니다.
  5. Bazel 공식 문서, rules_kotlin, rules_go 레포지토리, Google의 One-Version Rule 문서 등의 링크를 제시하면 좋습니다.

@1210thatman 1210thatman Feb 1, 2026

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

996e016

@1210thatman 1210thatman Feb 1, 2026 •
edited
Loading

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

문서 수정했습니다. 커밋 메세지 앞글자를 O -> o로 수정해야 하는데 지금 제 노트북에서 cli 명령이 안먹혀서 내일까지 커밋 메세지 바꿔서 린트 통과시키겠습니다

@kangeunchan kangeunchan Feb 5, 2026

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

@1210thatman 언제 해결해주시나요? 해결하고 review-reqeust 다시 눌러주세요!

Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
우리 프로젝트에서 모든 공통 의존성 등록의 진입점은 MODULE.bazel이며, 프로젝트 규모 확장에 따른 유지보수 효율성을 위해 다음과 같은 원칙을 따른다.

## 1. 의존성 관리 구조

### 1.1 MODULE.bazel

- 프로젝트 루트의 MODULE.bazel은 외부 모듈 버전 및 의존성을 관리하는 진입점이다.
- Bazel 정책상 MODULE.bazel 파일은 분할이 불가능하므로, 파일이 비대해지는 것을 방지하기 위해 Module Extensions을 활용한다.

### 1.2 Module Extensions

언어별로 관리 효율을 높이기 위해 별도의 .bzl 파일에 정의를 위임하고, MODULE.bazel에서 이를 호출한다.

- Go 의존성: go.mod 파일과 rules_go의 go_deps 확장을 연동하여 관리한다
- Kotlin/Maven 의존성: rulese_jvm_external을 사용하여 Maven 아티팩트를 관리하며, 별도의 .bzl 파일에 아티팩트 리스트를 정의하여 가독성을 확보한다

## 2. 서비스별 디펜던시 참조 및 최적화

### 2.1 불필요한 의존성 전파 방지

전체 의존성 풀에 특정 라이브러리가 등록되어 있더라도, 개별 서비스가 이를 강제로 참조하지 않는다.

### 2.2 서비스별 BUILD.bazel 활용

각 서비스 디렉토리 내의 BUILD.bazel 파일에서 해당 서비스가 실제로 필요한 디펜던시만 deps 항목에 명시한다.