Behind the Scenes: Block 450 JVM Repositories Into Monorepo to Reduce Dependency Drift

KẾT LUẬN

Block đã di cư thành công 450 JVM repositories thành monorepo duy nhất, loại bỏ dependency drift, cải thiện DX và tạo nền tảng vững chắc cho AI-assisted development. Tuy nhiên monorepo đòi hỏi đầu tư mạnh vào platform team và tooling tùy chỉnh, không phù hợp nếu thiếu cam kết nguồn lực.

LUẬN ĐIỂM CHÍNH

• [Polyrepo gây dependency drift nghiêm trọng: breaking changes lan truyền khó kiểm soát, đòi hỏi nỗ lực heroic để rollout thay đổi xuyên team
• Monorepo cho phép atomic updates xuyên suốt nhiều service trong một commit duy nhất, giải quyết triệt để vấn đề diamond dependency
• Block xây dựng bộ tooling tùy chỉnh toàn diện: custom IntelliJ plugin, Gradle convention plugins, dependency graph–based build scoping, merge queues
• Monorepo tạo nền tảng lý tưởng cho AI-assisted development nhờ lượng context lớn, standardization cao và well-paved paths cho AI agents]

LUẬN ĐIỂM PHỤ

• [Migration mất nhiều thời gian hơn dự kiến do phải duy trì DX và liên tục xử lý CI scalability khi repo phình to
• Monorepo chỉ phù hợp khi có platform team được đầu tư đúng mức và các project có cấu trúc tương đồng về ngôn ngữ, framework
• Hiệu suất IDE được đảm bảo bằng cách chỉ load project cần thiết và swap project references thành published JAR references để tránh Gradle chậm]

LUẬN CỨ & VÍ DỤ

• [8800 builds/tuần, p90 CI ~10 phút trên main branch luôn xanh — minh chứng cho scale và hiệu quả của monorepo
• Custom IntelliJ plugin (block/gradle-monorepo-ij-plugin) chỉ load project kỹ sư đang làm, swap refs thành JAR để IDE luôn nhanh
• Phân loại 3 kiểu thay đổi (trực tiếp/gián tiếp/global) dựa trên dependency graph để scope build tối ưu, bỏ CI check không cần cho indirect changes]

Nguồn: InfoQ | Phân tích bởi AI