Migration of existing codebases into a lernaJS monorepo

In big projects it is best practice to outsource functionality into single packages to share them between different projects. It will work great, until changes have to be implemented across different packages or they where sliced suboptimal. When those packages or projects - wich will mostly be handled in their own repositories - merged together into one repository, we’re taking about a MonoRepo or also Multi-Package-Repository.

LernaJS is a command-line based tool, that can enormously simplify the administrative tasks in such a structure: creating pre-releases, versioning, linking packages within the MonoRepos and publishing the changed packages. So just import all the individual repositories and off you go!

But is it as easy as it seems? I will show you with the help of a step-by-step-list for the migration of multiple repositories in a MonoRepo and which pitfalls you will reach during the migration.

Transcript

1. M gr ti n f xi ti g od ba es nt a er aJ - M no ep M o e g c e t a L -M o // @a l // P o l N . 2 2 1
2. M o e g c e t a L -M o // @a l // P o l N . 2 2 2
3. W o m M o e g c e t a L -M o // @a l // P o l N . 2 2 3
4. H , I m Arnd @a nd ss er M o e g c e t a L -M o // @a l // P o l N . 2 2 4
5. S ño P od ct ng ne r Si erSchrader M o e g c e t a L -M o // @a l // P o l N . 2 2 5
6. O ga-T am JSunconf M o e g c e t a L -M o // @a l // P o l N . 2 2 6
7. I ft n ea fancy shirts M o e g c e t a L -M o // @a l // P o l N . 2 2 7
8. a d l ke t ls M o e g c e t a L -M o // @a l // P o l N . 2 2 8
9. M gr ti n f xi ti g od ba es nt a er aJ - M no ep M o e g c e t a L -M o // @a l // P o l N . 2 2 9
10. M gr ti n f xi ti g od ba es nt a er aJ m no ep Po JS e it on M o e g c e t a L -M o // @a l // P o l N . 2 2 1
11. T da 's oa ma W i l a ? 4 P o & M o // W 's W 4 W 's h m o? 4 W 's lerna // A b i c 4 M h d // e s 4 T a // W 's u t ? M o e g c e t a L -M o // @a l // P o l N . 2 2 1
12. C it si m? T m : 4 S a d m T @a l 4 S e i e @a l .n 4 G e n , o l o l e I e [G |B |D ] T t M o e g c e t a L -M o // @a l // P o l N . 2 2 1
13. Q es io s? ! r gh a te t e al M o e g c e t a L -M o // @a l // P o l N . 2 2 1
14. W o's ho M o e g c e t a L -M o // @a l // P o l N . 2 2 1
15. W o's ho? P o: n s r o M o: e i n r o p : a s p p M o e g c e t a L -M o // @a l // P o l N . 2 2 1
16. P ly ep v M no ep f ct f om an om nt rn t ou ce M o e g c e t a L -M o // @a l // P o l N . 2 2 1
17. P ly ep M o e g c e t a L -M o // @a l // P o l N . 2 2 1
18. P ly ep // W at s t? │ ├── Package-A │ ├── package.json │ ├── node_modules │ │ └── Package-B ├── Package-B │ ├── package.json │ └── node_modules │ ├── Package-C M o e g c e t a L -M o // @a l // P o l N . 2 2 1
19. P ly ep // W at s t? 4 M e R : n p e r 4 O node_modules f e p 4 O a r o m n n r b t M o e g c e t a L -M o // @a l // P o l N . 2 2 1
20. P ly ep // t e oo p rt 4 R i c 4 M f , b t : 4 u r o o k n e r o f u 4 f s r s i n : h e x b g c M o e g c e t a L -M o // @a l // P o l N . 2 2 2
21. P ly ep // t e ad ar s 4 S e c e r : f i , i o , s p e , c r 4 s p s r g l /f e 4 n c e c r : m e v s/A n m n h m t 4 O a s o h c r n /p s c e b g c M o e g c e t a L -M o // @a l // P o l N . 2 2 2
22. M no ep M o e g c e t a L -M o // @a l // P o l N . 2 2 2
23. M no ep // W at s t? ├── packages │ ├── Package-A │ │ ├── package.json │ │ └── node_modules │ │ └── Package-B │ └── Package-B │ ├── package.json │ └── node_modules │ └── Package-C ├── package.json ├── lerna.json └── node_modules M o e g c e t a L -M o // @a l // P o l N . 2 2 2
24. M no ep // W at s t? 4 o r , m e p s 4 o : n node_modules f 4 i l p s e w h m o r l 4 e l p s r o h (p r 's node_modules) n e l M o e g c e t a L -M o // @a l // P o l N . 2 2 2
25. M no ep // t e oo p rt 4 e i t h m o v n s b 4 t c e a b g c r v 4 s r i : o b - o x i 4 e v i - o a i i c i c 4 master h a r e s t h w e e M o e g c e t a L -M o // @a l // P o l N . 2 2 2
26. M no ep // t e ad ar s 4 t o o d o m o 4 s d a l o l p u 4 s l m o e M o e g c e t a L -M o // @a l // P o l N . 2 2 2
27. W at's n he on re o? M o e g c e t a L -M o // @a l // P o l N . 2 2 2
28. W at's n i t e on re o? M o e g c e t a L -M o // @a l // P o l N . 2 2 2
29. W at's n i t e on re o? 4 C i 4 c n a r s t e l c r 4 c n t a l c g, k a w p p s 4 t e c s h m o r d n u p - n o a s r M o e g c e t a L -M o // @a l // P o l N . 2 2 2
30. L rn JS t e e-f ct s an ar f r av Sc ip b se m no ep s M o e g c e t a L -M o // @a l // P o l N . 2 2 3
31. L rn L e h m o t 4 d n m e 4 s run s 4 v i 4 d e M o e g c e t a L -M o // @a l // P o l N . 2 2 3
32. L rn // d pe de cy an ge en 4 p s w h m o r l 4 a o p s r h n e l ! yarn w c b h m w M o e g c e t a L -M o // @a l // P o l N . 2 2 3
33. L rn // s ar run s ri ts 4 lerna run rocket - s rocket l p s h m o 4 lerna exec spaceX - e s spaceX l p s h m o 4 lerna run rocket --scope "packages/components-*" s rocket l m g p s M o e g c e t a L -M o // @a l // P o l N . 2 2 3
34. L rn // v rs on ng lerna s s w t v i : - independent: l p s v d e , i d v n - fixed: l a e p s v h m v n (s d) M o e g c e t a L -M o // @a l // P o l N . 2 2 3
35. L rn // d pl ym nt 4 lerna l d n h v n o h i c h (S ) lerna version --conventional-commits 4 i d p s r m e n l t r g p e lerna publish --from-git M o e g c e t a L -M o // @a l // P o l N . 2 2 3
36. M no ep S il i te es ed? M o e g c e t a L -M o // @a l // P o l N . 2 2 3
37. M gr ti n f xi ti g od ba es nt a er aJ m no ep L t's ol M o e g c e t a L -M o // @a l // P o l N . 2 2 3
38. L ss ns ea ne 4 m o p s 4 i n 3+ y git h 4 M a 5 .0 + c 4 B m o 4 3 m p g 4 2 m i n 4 4 h m o M o e g c e t a L -M o // @a l // P o l N . 2 2 3
39. M o e g c e t a L -M o // @a l // P o l N . 2 2 3
40. M gr ti n bs ac es M o e g c e t a L -M o // @a l // P o l N . 2 2 4
41. M gr ti n bs ac es B d c l y: 4 E : T o & T 4 H : p g h t e 4 V h : d e & m e M o e g c e t a L -M o // @a l // P o l N . 2 2 4
42. C ec li te ✁ p in o t nd he k M o e g c e t a L -M o // @a l // P o l N . 2 2 4
43. S ep t wa ds he on re o // t me in 4 P t // m a 4 T m n 4 c t a f i 4 T a f i // w a 4 c m o / / b g / r / d -r 4 R 4 K t n // c o M o e g c e t a L -M o // @a l // P o l N . 2 2 4
44. P ep ra io m a M o e g c e t a L -M o // @a l // P o l N . 2 2 4
45. P ep ra io // T rg t od ll ng E i : h m o e s n o u p s? 4 h n d e r w h c e s n ? 4 w r h b t o e ? 4 w p s r t a n s ? 4 d t l d M o e g c e t a L -M o // @a l // P o l N . 2 2 4
46. P ep ra io // T rg t od ll ng 4 w e u w o l l ? 4 h o r u p s? 4 w u v i s y? 4 h o c b x ? 4 h s l i s h m o? M o e g c e t a L -M o // @a l // P o l N . 2 2 4
47. P ep ra io // T rg t od ll ng 4 D t l d n , o l a o p u s a o h 't p n w 4 c a c b : m & d t n r p e M o e g c e t a L -M o // @a l // P o l N . 2 2 4
48. P ep ra io // T rg t od ll ng C (r n t ) c s 4 t s 4 c f n 4 l r 4 J i / T i ! prettier - o r p , u c e M o e g c e t a L -M o // @a l // P o l N . 2 2 4
49. P ep ra io // T rg t od ll ng C (r n t ) c s 4 u run s 4 h z d n : e l R , V , A , T i , b , w , p r, j 4 h z e node v s ! r b g c e & s a t M o e g c e t a L -M o // @a l // P o l N . 2 2 4
50. T ch ic l ou da io W a M o e g c e t a L -M o // @a l // P o l N . 2 2 5
51. M gr te he ep s T o o m u r 1. lerna import /path/to/repo w i a p t t c h 2. r h l r , d remote h m o n f l c o h f a remote M o e g c e t a L -M o // @a l // P o l N . 2 2 5
52. M gr te he ep s R h e g p a e s r : git filter-branch --index-filter ' git ls-files -s | gsed "s,\t,&'packages/repo-name'/," | GIT_INDEX_FILE="$GIT_INDEX_FILE.new" git update-index --index-info && \ mv "$GIT_INDEX_FILE.new" "$GIT_INDEX_FILE" ' HEAD` T d e remote n e h c i git fetch remote. A r o a s l h c o remote/master t h master h m o. M o e g c e t a L -M o // @a l // P o l N . 2 2 5
53. T ch ic l ou da io : s mm ry 4 C n d t h m o s r 4 r n i e g r 4 d t w 's r d 4 a import/require e c g p n T 's i : i 's o ! M o e g c e t a L -M o // @a l // P o l N . 2 2 5
54. W it - T er 's or M o e g c e t a L -M o // @a l // P o l N . 2 2 5
55. T ch ic l ou da io : git T u git w a m o i 't a e : 4 clone, fetch n pull n a r t 4 d o v a b n c a c r a m e p s? 4 t a git d -d , l a git subtree git clone --depth 123 4 d 't f a l e g git h R : h p u l M o e g c e t a L -M o // @a l // P o l N . 2 2 5
56. T ch ic l ou da io : T pe cr pt 4 T i s s s d m , u d h m o p 4 U h tsconfig l a c n o l u c g n i a (v extends) 4 m u w t s e p s 4 n -t T i t skipLibCheck types o R : e p , n n p l h r d m M o e g c e t a L -M o // @a l // P o l N . 2 2 5
57. T ch ic l ou da io : C 4 i u p l e ? l s ? 4 a h p e l a d? W t r r e n w b a u p l i p a ? 4 c a h c s o c o n r p e o o e g w W : o u t h i h s R : a s m a h p s b e M o e g c e t a L -M o // @a l // P o l N . 2 2 5
58. T ch ic l ou da io : B nd er/W bp ck 4 c e g webpack s 4 h z h s r c a s e d e p R : s w w s m b d w s 't s M o e g c e t a L -M o // @a l // P o l N . 2 2 5
59. T ch ic l ou da io : r le se ro es 4 T r n c l , e.g. p r y k sonatype/docker-nexus verdacchio 4 a e d n v i h C : d 't a m v i R : f r s, d t v n , w m n d n - t r p o u m o M o e g c e t a L -M o // @a l // P o l N . 2 2 5
60. T ch ic l ou da io : m re is s 4 I 4 i g h d p l s 4 c n i ? a e u l . 4 g a git c m c /s w u h s a c 4 c r : s d o R : p i d M o e g c e t a L -M o // @a l // P o l N . 2 2 6
61. K ep ea s n yn c o M o e g c e t a L -M o // @a l // P o l N . 2 2 6
62. K ep ea s n yn : d cu en at on & c mm ni at n 4 d t n w o 4 k h d t u -t -d , l h w o p 4 u n o w n h d t 4 s e t s d t s s ! R : e t 's d t o h h m o, a e r c e g g h n w u a n t a t h t w o M o e g c e t a L -M o // @a l // P o l N . 2 2 6
63. E co rs t e ar ll l ni er e M o e g c e t a L -M o // @a l // P o l N . 2 2 6
64. S ot he i e en e 0) u l d y: lerna run serve --scope 'packages/application-*' 1) u l i y yarn lerna run serve --scope 'packages/application-*' 2) u l i r e y yarn lerna exec --scope 'packages/application-*' yarn run serve 3) c a s e n u y cd packages && cd application-01 && yarn run serve M o e g c e t a L -M o // @a l // P o l N . 2 2 6
65. K ep ea s n yn : d cu en at on & c mm ni at on 4 t h t - b a /d /a h m o 4 l p s 4 d 't b p o h q n 4 a y f l t , a m o h r c - e e f k n g r u i 4 a y f y 'r s h r p s R : p r g f t b y 'r a n h w p s, n o h a v e r p s. M o e g c e t a L -M o // @a l // P o l N . 2 2 6
66. C nc us on M o e g c e t a L -M o // @a l // P o l N . 2 2 6
67. C nc us on 4 s t l m o p 4 d t c p e 4 m a g o d -r : a e d m o n a e , t , r n , C -w o 4 c i s n h d 4 o m a n p a a s r d 4 k h t s , a 4 a c y 'r h c p M o e g c e t a L -M o // @a l // P o l N . 2 2 6
68. B t... ...y u ig t not n ed M no ep M o e g c e t a L -M o // @a l // P o l N . 2 2 6
69. A te na iv a pr ac es/t ol 4 s s 4 git subtree 4 p 4 r (M f ) 4 B (G ) 4 B (f k) 4 U n M o e g c e t a L -M o // @a l // P o l N . 2 2 6
70. M o e g c e t a L -M o // @a l // P o l N . 2 2 7
71. Arnd I ler @a nd ss er e ai @a nd ss er.n t M o e g c e t a L -M o // @a l // P o l N . 2 2 7