Lerna 마스터하기: JavaScript Monorepos 관리 가이드

목차

1. 소개
2. 1장: Lerna는 무엇인가요?
   • 왜 모노레포스인가?
3. 2장: Lerna 설치 및 설정
   • 전제조건
   • 단계별 설치 가이드
   • 첫 번째 Lerna 프로젝트 설정
4. 3장: Lerna의 종속성 관리
   • 독립적 종속성
   • 공유 종속성 끌어올리기
   • 부트스트래핑 패키지
5. 4장: 패키지 전체에서 스크립트 실행
   • 전역적으로 스크립트 실행
   • 특정 패키지 타겟팅
6. 5장: Lerna를 사용한 버전 관리 및 게시
   • 고정 모드 vs 독립 모드
   • npm에 패키지 게시
7. 6장: Yarn 작업공간에서 Lerna 사용
   • Lerna에서 Yarn 작업공간 활성화
   • Lerna Yarn 작업 공간으로 작업 흐름 최적화
8. 7장: 고급 Lerna 사용법
   • 필터링 명령
   • 사용자 정의 명령 만들기
9. 8장: Lerna Monorepos 모범 사례
   • 논리적 패키지 구성
   • 테스트 및 빌드 자동화
   • CI/CD 통합
10. 결론
11. 부록: 일반적인 Lerna 명령

---

소개

상호 의존적인 여러 패키지가 포함된 대규모 JavaScript 또는 TypeScript 프로젝트를 관리하는 것은 개발자와 개발 팀에게 중요한 과제가 될 수 있습니다. 종종 개발자는 각 패키지에 대해 여러 저장소에 의존하므로 코드 유지 관리, 종속성 관리 및 공동 작업 측면에서 오버헤드가 발생합니다.

모노레포 관리를 위해 개발된 강력한 도구인 Lerna는 이 프로세스를 간소화합니다. Monorepos를 사용하면 팀이 단일 저장소에 여러 패키지를 호스팅하여 종속성 관리를 단순화하고 팀 간 협업을 더욱 원활하게 만들 수 있습니다.

이 eBook은 Lerna를 사용하여 모노레포를 효율적으로 관리하는 방법에 대한 완전한 가이드를 제공하는 것을 목표로 합니다. 구성 요소 라이브러리를 처리하든, 여러 개의 상호 연결된 패키지가 있는 대규모 프로젝트를 처리하든, Lerna를 통해 생산성을 극대화하는 데 도움이 되는 귀중한 통찰력을 찾을 수 있습니다.

---

1장: Lerna는 무엇인가요?

Lerna는 모노레포에서 여러 패키지를 쉽게 관리할 수 있는 오픈 소스 도구입니다. 자동 종속성 관리, 버전 관리, 게시 등의 강력한 기능을 제공하므로 JavaScript 및 TypeScript 프로젝트를 대규모로 더 쉽게 유지 관리할 수 있습니다.

왜 모노레포스인가?

Monorepos는 여러 가지 이점을 제공하므로 많은 대규모 프로젝트에 적합한 아키텍처 선택입니다.

• 공유 코드베이스: 단일 저장소를 사용하면 코드 재사용이 더 쉽습니다. 이렇게 하면 중복이 줄어들고 프로젝트 전반에 걸쳐 일관성이 보장됩니다.
• 간소화된 협업: 모든 패키지가 한 곳에 있으면 개발자가 더욱 효과적으로 협업할 수 있습니다.
• 통합 빌드 프로세스: 여러 패키지에 걸쳐 빌드, 테스트 및 배포를 표준화하는 것이 더 쉬워졌습니다.

이러한 이점에도 불구하고 모노레포 관리는 특히 종속성 및 버전 관리에 있어 독특한 과제를 안겨줄 수 있습니다. Lerna는 이러한 문제를 정면으로 해결하도록 설계되어 모노레포에 최적화된 워크플로우를 제공합니다.

---

2장: Lerna 설치 및 설정

전제조건

시작하기 전에 Node.js 및 npm(또는 Yarn)이 설치되어 있는지 확인하세요. Lerna는 npm과 Yarn 모두와 호환됩니다.

1단계: Lerna 설치

npm을 통해 Lerna를 전역적으로 설치할 수 있습니다.

npm install --global lerna

또는 Lerna를 프로젝트의 개발 종속성으로 추가할 수 있습니다.

npm install --save-dev lerna

2단계: Lerna Monorepo 초기화

설치가 완료되면 프로젝트 디렉터리로 이동하여 다음을 실행하여 모노레포를 초기화하세요.

lerna init

이렇게 하면 lerna.json을 포함한 필수 구성 파일이 생성되고 개별 패키지가 저장될 패키지 폴더가 설정됩니다.

3단계: 패키지 추가

Lerna 프로젝트에서 각 패키지는 패키지 아래의 자체 하위 폴더에 있습니다. 각 패키지에는 종속성 관리를 위한 자체 package.json 파일이 있어야 합니다.

샘플 구조:

/my-project
  /packages
    /package-a
    /package-b
  lerna.json
  package.json

---

Chapter 3: Dependency Management in Lerna

Managing dependencies across multiple packages is one of Lerna’s core strengths.

Independent Dependencies

Lerna allows you to add dependencies to a specific package. For example, if only package-a needs lodash, you can run:

lerna add lodash --scope=package-a

Hoisting Shared Dependencies

When multiple packages share dependencies, you can hoist those dependencies to the root of your monorepo. This reduces redundancy and speeds up installations. To enable hoisting, add this to lerna.json:

{
  "hoist": true
}

Bootstrapping

To install dependencies and link packages that depend on one another, run:

lerna bootstrap

This ensures that all necessary external dependencies are installed and that packages can reference each other properly.

---

Chapter 4: Running Scripts Across Packages

Lerna makes it easy to execute scripts (e.g., build, test, lint) across all packages in your monorepo.

Executing Scripts Globally

To run a script like build across all packages, use:

lerna run build

Targeting Specific Packages

If you only want to run a script in certain packages, use the --scope flag:

lerna run test --scope=package-a

This flexibility allows for more targeted execution, saving time during development.

---

Chapter 5: Versioning and Publishing with Lerna

Lerna provides robust versioning and publishing features, allowing you to easily version and release packages.

1. Fixed Mode

In fixed mode, all packages share the same version number. When any package is updated, the version number is incremented for all.

2. Independent Mode

In independent mode, each package has its own version number. When a package is changed, only that package’s version is updated.

To switch to independent mode, modify lerna.json:

{
  "version": "independent"
}

Publishing Packages

To publish your packages to npm, run:

lerna publish

Lerna will handle versioning and publishing based on your configuration.

---

Chapter 6: Using Lerna with Yarn Workspaces

Combining Lerna with Yarn Workspaces can further optimize dependency management by hoisting even more shared dependencies.

To enable Yarn Workspaces, modify your lerna.json file:

{
  "npmClient": "yarn",
  "useWorkspaces": true
}

Then update your package.json:

{
  "workspaces": ["packages/*"]
}

This integration boosts performance and simplifies managing large-scale projects.

---

Chapter 7: Advanced Lerna Usage

Filtering Commands

Lerna allows filtering to run commands for specific packages or to exclude certain packages.

Example for running on specific packages:

lerna run build --scope=package-a --scope=package-b

Example for excluding packages:

lerna run build --ignore=package-c

Custom Commands

You can define custom Lerna commands within package.json for specialized workflows. These commands can then be run across your packages.

---

Chapter 8: Best Practices for Lerna Monorepos

1. Organize Packages Logically: Group related packages together for better code reuse.
2. Use Hoisting: Hoisting shared dependencies saves space and speeds up install times.
3. Automate Testing: Use lerna run to automate testing across your entire monorepo.
4. CI/CD Pipelines: Implement continuous integration and deployment workflows to automatically test and deploy changes.
5. Yarn Workspaces: Leverage Yarn Workspaces with Lerna for better dependency management.

---

Conclusion

Lerna is an invaluable tool for managing monorepos, offering features that simplify complex workflows, from dependency management to versioning and publishing. By adopting Lerna, teams can reduce complexity, streamline processes, and improve collaboration, making it easier to maintain large-scale projects.

Whether you’re working on a simple component library or a multi-package ecosystem, Lerna provides the tools needed to manage your project effectively. Keep experimenting with Lerna’s advanced features to unlock its full potential.

---

부록: 일반적인 Lerna 명령

• lerna init: Lerna 모노레포를 초기화합니다.
• lerna bootstrap: 종속성을 설치하고 패키지를 링크합니다.
• lerna add [패키지] --scope=[패키지 이름]: 특정 패키지에 종속성을 추가합니다.
• lerna run [script]: 모든 패키지에서 스크립트를 실행합니다.
• lernaPublish: npm에 패키지를 게시합니다.

---

행복한 코딩하세요 :)

위 내용은 Lerna 마스터하기: JavaScript Monorepos 관리 가이드의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!