Новый уровень модульной разработки - Mon Repo

Сначала их было всего один, потом появились множество модулей. Чтобы оптимизировать работу с модулями, мы попробовали разные варианты. В итоге мы дошли до уровня Mono Repo - один repository для всего.
В данном докладе расскажу о том, какие варианты реализации модульной разработки существует и в чем их недостаток.

Transcript

1. Новый уровень модульной разработки Mono Repo Маршал Жанибек Kolesa Team
2. Проекты Kolesa Team - Android Колёса Май, 2013 Крыша Сентябрь, 2014 Маркет Август, 2016 Avtoelon.uz Октябрь, 2018 2
3. Multiple Repositories У каждого проекта свой git repository В итоге у нас было бы 4 repository 3
4. Multiple Repositories Жирный минус - дублирование кода во всех repository 4
5. Наши внутренние библиотеки SDK Permission Push Authentication Network Analytics UI Utils 5 Еще больше на подходе
6. Первый уровень модульной разработки Решили создать отдельный Git Repository для общей бизнес логики kz.kolesateam.sdk Первое время будет проще работать с Git submodule 6
7. Git Submodule Проще внедрить git submodule add {url} Разработчикам приходилось вручную обновлять git submodule update 7
8. Второй уровень модульной разработки Собираем .aar файл (Android Library) и публикуем в локальный repository BUILD PUBLISH CI 8
9. Второй уровень модульной разработки allprojects { repositories { maven { url "https://artifactory.kolesa-team.org/libs" } } } dependencies { implementation "kz.kolesateam:utils:1.0.0" implementation "kz.kolesateam:authentication:1.0.0" } 9
10. Локальный repository для модулей Преимущество: - Кэширование внешних библиотек в локальных сетях - Удобное хранилище apk файлов, создаваемое в CI Если сложно поднять в in-house, можно воспользоваться их SaaS решением 10
11. Удобство публикации в artifactory 1. Четкая граница ответственности 2. Меньше шансов сломать сборки других проектов 3. Версионирование 4. Нет необходимости пересобирать исходный код 11
12. Минусы публикации в artifactory 1. Сложнее править архитектуру проектов 2. Много повторяющегося кода 3. Версионирование 12
13. Написали статью О том как публиковать локальные модули в artifactory repository 13
14. Схема работы с локальными repository Authentication new feature 5 Repo 5 PR 14 1.0.1 SNAPSHOT 1.0.1 Merge
15. Зависимость в модуле Authentication new feature 6 Repo 6 PR Utils bug fix 15
16. Получили обратную связь 16
17. Новый уровень 17
18. Mono Repo Вместо того чтобы хранить код в разных repository Поместим все в один репозиторий 18
19. Как настроить settings.gradle include ‘:kolesa’, ‘:authentication’ project(‘:kolesa).projectDir = new File(‘apps/kolesa’) project(‘:authentication).projectDir = new File(libs/authentication’) apps/kolesa/build.gradle dependencies { implementation project(‘:authentication’) } 19
20. Как мигрировать текущие repository 20
21. Нельзя просто так взять и скопировать код в Mono Repo 21
22. github.com/unravelin/tomono ./repos.txt git@bitbucket.kolesa-team.org/kolesa.git apps/kolesa git@bitbucket.kolesa-team.org/authentication.git libs/authentication Проекты в папку apps Модули библиотек в папку libs 22
23. Запускаем миграцию repositories Вся история commit теперь в безопасности 23
24. Процесс разработки не останавливается 24
25. Теперь у нас Mono Repo apps/ Kolesa Krisha Market Avtoelon libs/ Analytics-core Authentication UI Network ... 25
26. Как мы теперь разрабатываем module 1 Repo 1 PR Authentication new feature 26
27. Как мы теперь разрабатываем module 1 Repo 1 PR Authentication new feature Utils bug fix 27
28. CI Trigger По названию ветки .*/(KLMA|AAS)-\d*.* Изменение файлов в папках (libs|apps/kolesa/app).* 28
29. Обновленная схема Git Flow Больше не используем master ветку 29
30. Статус миграции Количество файлов: 7943 Количество коммитов: 33045 Размер repository: 192.4MB Количество модулей: 19 Количество модулей в будущем 30
31. “ОК, а где время сборки?" 31 Before app:assembleDistribRelease After kolesa:assembleDistribRelease
32. Еще проще переиспользовать код 32
33. Больше нет проблем с актуализацией версии модуля 33
34. Больше не страшно делать большой рефакторинг 34
35. Проще взаимодействовать с командами 35
36. • Всегда актуальная версия тоже создает иногда неудобство Недостатки Mono Repo 36
37. • Всегда актуальная версия тоже создает иногда неудобство • Не получится закрыть доступ к определенным модулям Недостатки Mono Repo 37
38. • Всегда актуальная версия тоже создает иногда неудобство • Не получится закрыть доступ к определенным модулям • git clone скачивает всю историю repository Недостатки Mono Repo 38
39. • Всегда актуальная версия тоже создает иногда неудобство • Не получится закрыть доступ к определенным модулям • git clone скачивает всю историю repository ◦ В целом git не предназначен для большого repository Недостатки Mono Repo 39
40. • Всегда актуальная версия тоже создает иногда неудобство • Не получится закрыть доступ к определенным модулям • git clone скачивает всю историю repository ◦ В целом git не предназначен для большого repository • clean build занимает много времени Недостатки Mono Repo 40
41. Итог миграции • Ускорили процесс разработки • Разбиваем монолит в проектах на мелкие модули • Проще изменять зависимость модулей • Весь исходный код в одном каталоге 41
42. Ссылки • https://git-scm.com/book/en/v2/Git-Tools-Submodules • https://habr.com/company/kolesa/blog/353942/ • https://eng.uber.com/android-monorepo/ • https://en.wikipedia.org/wiki/Monorepo • http://danluu.com/monorepo/ • https://gregoryszorc.com/blog/2014/09/09/on-monolithic-repositories/ • https://github.com/unravelin/tomono 42
43. Вопросы @orangerange @megasuperhero janibekmarshal.com 43