Menguasai Lerna: Panduan Mengurus Monorepos JavaScript

Jadual Kandungan

1. Pengenalan
2. Bab 1: Apa itu Lerna?
   • Kenapa Monorepos?
3. Bab 2: Memasang dan Menyediakan Lerna
   • Prasyarat
   • Panduan Pemasangan Langkah demi Langkah
   • Menyediakan Projek Lerna Pertama Anda
4. Bab 3: Pengurusan Kebergantungan di Lerna
   • Kebergantungan Bebas
   • Mengangkat Kebergantungan Dikongsi
   • Pakej Bootstrapping
5. Bab 4: Menjalankan Skrip Merentasi Pakej
   • Melaksanakan Skrip Secara Global
   • Menyasarkan Pakej Khusus
6. Bab 5: Versi dan Penerbitan dengan Lerna
   • Mod Tetap lwn Mod Bebas
   • Pakej Penerbitan ke npm
7. Bab 6: Menggunakan Lerna dengan Ruang Kerja Benang
   • Mendayakan Ruang Kerja Benang dalam Lerna
   • Mengoptimumkan Aliran Kerja dengan Ruang Kerja Benang Lerna
8. Bab 7: Penggunaan Lerna Lanjutan
   • Arahan Penapisan
   • Mencipta Perintah Tersuai
9. Bab 8: Amalan Terbaik untuk Lerna Monorepos
   • Organisasi Pakej Logik
   • Mengautomasikan Ujian dan Binaan
   • Integrasi CI/CD
10. Kesimpulan
11. Lampiran: Perintah Lerna Biasa

---

Pengenalan

Menguruskan projek JavaScript atau TypeScript berskala besar yang melibatkan berbilang pakej yang saling bergantung boleh menjadi cabaran yang besar bagi pembangun dan pasukan pembangunan. Selalunya, pembangun bergantung pada berbilang repositori untuk setiap pakej, yang menghasilkan overhed dari segi penyelenggaraan kod, pengurusan pergantungan dan kerjasama.

Lerna, alat berkuasa yang dibangunkan untuk mengurus monorepos, menyelaraskan proses ini. Monorepos membolehkan pasukan mengehoskan berbilang pakej dalam satu repositori, memudahkan pengurusan pergantungan dan menjadikan kerjasama merentas pasukan lebih lancar.

Ebook ini bertujuan untuk menyediakan panduan lengkap menggunakan Lerna untuk menguruskan monorepos anda dengan cekap. Sama ada anda berurusan dengan perpustakaan komponen atau projek berskala besar dengan beberapa pakej yang saling berkaitan, anda akan mendapat cerapan berharga untuk membantu anda memaksimumkan produktiviti anda dengan Lerna.

---

Bab 1: Apa itu Lerna?

Lerna ialah alat sumber terbuka yang memudahkan pengurusan berbilang pakej dalam monorepo. Ia menawarkan ciri hebat seperti pengurusan pergantungan automatik, versi dan penerbitan, menjadikannya lebih mudah untuk mengekalkan projek JavaScript dan TypeScript pada skala.

Kenapa Monorepos?

Monorepos ialah pilihan seni bina untuk banyak projek berskala besar, kerana ia memberikan beberapa faedah:

• Pangkalan Kod Dikongsi: Dengan monorepos, penggunaan semula kod lebih mudah. Ini mengurangkan pertindihan dan memastikan konsistensi merentas projek.
• Kerjasama Ringkas: Pembangun boleh bekerjasama dengan lebih berkesan apabila semua pakej berada di satu tempat.
• Proses Binaan Bersatu: Penyeragaman binaan, ujian dan penggunaan merentas berbilang pakej menjadi lebih mudah.

Walaupun faedah ini, mengurus monorepo boleh membawa cabaran yang unik, terutamanya dalam mengurus kebergantungan dan versi. Lerna direka bentuk untuk menangani cabaran ini secara berterusan, menyediakan aliran kerja yang dioptimumkan untuk monorepos.

---

Bab 2: Memasang dan Menyediakan Lerna

Prasyarat

Sebelum bermula, pastikan anda telah memasang Node.js dan npm (atau Yarn). Lerna serasi dengan npm dan Yarn.

Langkah 1: Memasang Lerna

Anda boleh memasang Lerna secara global melalui npm:

npm install --global lerna

Sebagai alternatif, anda boleh menambah Lerna sebagai pergantungan pembangunan dalam projek anda:

npm install --save-dev lerna

Langkah 2: Memulakan Lerna Monorepo

Setelah dipasang, mulakan monorepo anda dengan menavigasi ke direktori projek anda dan jalankan:

lerna init

Ini akan mencipta fail konfigurasi penting, termasuk lerna.json, dan menyediakan folder pakej di mana pakej individu anda akan disimpan.

Langkah 3: Menambah Pakej

Dalam projek Lerna, setiap pakej tinggal dalam subfolder sendiri di bawah pakej. Setiap pakej mesti mempunyai fail package.json sendiri untuk pengurusan kebergantungan.

Struktur sampel:

/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.

---

Lampiran: Perintah Lerna Biasa

• lerna init: Memulakan monorepo Lerna.
• lerna bootstrap: Memasang kebergantungan dan memautkan pakej.
• lerna tambah [pakej] --scope=[nama-pakej]: Menambah kebergantungan pada pakej tertentu.
• lerna run [skrip]: Menjalankan skrip merentas semua pakej.
• lerna publish: Menerbitkan pakej ke npm.

---

Selamat Mengekod :)

Atas ialah kandungan terperinci Menguasai Lerna: Panduan Mengurus Monorepos JavaScript. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!