monorepo

• Why Google Stores Billions of Lines of Code in a Single Repository

• Monorepo開発のメリット vs デメリット
• Monorepoって何なのか？と関連アーキテクチャとの関係をまとめてみた
• システムリニューアルに伴う monorepo 構成を考える
• SCOUTERのリポジトリ戦略 Monolith→MultiRepo→MonoRepoへと移行した理由

基本事項 †

monorepoとは †

• 1つのリポジトリで複数のモジュールリポジトリを管理すること
• マイクロサービス単位に分割された各資源をその分割状態を維持したまま単一のリポジトリで管理する方法
  • 管理する対象が一つになったことで、施さなければいけない対応やプロダクト全体の見通しが良くなる
  • 他にもプロダクトコードにまつわる周辺ツールの管理もしやすいなどと、プロダクト全体で共通するものの管理に関する問題が解消される

• Monorepoの目指すべき姿は、ソース管理は単一で、デプロイラインは複数
  • 例えば、何も考えずにリポジトリ単位でパイプラインを構築すると、全サービスに対する各種処理（テスト。ビルド等）が走ってしまって単一の重いパイプラインになってしまうので注意
  • コード管理のみを一点に集約し、実際にテスト、ビルド、デプロイされるものは従来通りサービスごとに独立して行える状態である必要があるということ
  • これを実現するために、パイプライン側でテスト、ビルド、デプロイに関するステップをリポジトリで管理されている各サービス単位で行えるように設定する必要がある

• Modular Monolithとの違いはデプロイラインの状態で区別ができるが、そもそもの目指すべきものは同じでただ段階が違うだけ

Pros †

• 単一のlint、ビルド、テスト、リリースのプロセス
• モジュールをまたいだ変更がしやすい i-ssueを報告する場所が一つ
• 開発環境のセットアップが容易
• モジュールをまたいだテストが一緒に実行されるため、複数のモジュールにまたがるバグがより簡単に見つかる
• ライブラリ等のバージョンアップ対応に関しても、単一リポジトリとなる事で、そのリポジトリ内で一元管理している依存関係をアップデートしてあげれば一瞬で、使用している全サービスへの反映ができる

事例 †

• 言語が違う複数のリポジトリをmonorepoへ移行した話

• メルカリShops の技術スタックと、その選定理由
• メルカリShops での monorepo 開発体験記

• Yarn Workspacesを利用したMonorepo環境の構築
• git の sparse-checkout を使ってモノリポでも快適にいこう！

関連ツール †

• Nx と Turborepo の比較
• NXとTurborepoを使用した最新のMonorepoの設計

Bazel †

Lerna †

Turborepo †

• Turborepo でモノレポ構成のプロジェクトを爆速でビルドする

Nx †

Git †

• Gitのリポジトリ構成、Monolith、Multi-repo、Monorepo、Polyrepo、どれが実現できるの？

GitHub †

• マルチレポからモノレポへの移行を経験して感じたこと
• Mono Repo のための GitHub Actions の Tips 集
• GitHub モノレポを AWS CodePipeline と統合して、プロジェクト固有の CI/CD パイプラインを実行する

• LernaとGithub Actionsでmonorepoライブラリのリリースを楽にする

GitHub Actions †

• モノレポでの無駄な GitHub Actions の実行を避ける
• モノレポでGitHub Actionsをいい感じにやるチップス

言語 †

Typescript †

Go †

• Goのmonorepoとworkspace mode