Как правильно использовать git submodules при командной разработке?

Question

[AlexanderY]

Сегодня столкнулись с одним неудобством.

Наш проект на Kohana. Удаленный гит-репозиторий. Несколько разработчиков, каждый что-то пишет, коммитит, и отправляет в репозиторий (push).

Сегодня понадобилось установить модуль HTML Purifier и я пошел по рекомендуемому пути: добавил его в качестве подмодуля

git submodule add git://github.com/shadowhand/purifier.git modules/purifier
git submodule update --init --recursive

Закоммитил: гит сообщил, что добавлен каталог modules/purifier. Запушил — но у других разработчиков после git pull появился только этот каталог, но не файлы внутри. Каждому из них пришлось выполнять команду git submodule update --init --recursive. Точно также мне пришлось выполнить эту команду на сервере, в удаленном репозитории.

Я ожидал, что все новые файлы, как обычно, добавятся в коммит и отправятся в удаленный репозиторий. Что я сделал неправильно? Как в дальнейшем работать с подмодулями?

Comments

[Алексей Киселев]

Все правильно, это так работает.

Answer 1

[Виктор]

Всё правильно сделали и да, нужно в каждом новом репозитории делать git submodule update --init --recursive.
В дальнейшем делать git submodule update после смены коммита в подмодуле кем-то другим для того, чтобы был checkout нужных файлов в Вашей копии.

Comments

[AlexanderY]

Что случится, если в будущем, один из разработчиков отредактирует подмодуль? Как удаленному репозиторию и другим разработчикам об этом узнать? Родительский репо, как я понимаю, не "увидит" этих изменений?

[Виктор]

Делаешь коммит в подподмуле, пушишь его. В этот момент меняется хеш выбранного коммита подмодуля в основном (вашем) репозитории, тоже нужен коммит и пуш. Потом на другом репозитории делаете fetch для подмодуля и git pull && git submodule update для основного.

[evnuh]

Всё верно, и да, поэтому сабмодули никто не любит. Ацкая морока с ними.

[Виктор]

Ну, во всяком случае это лучше, чем тащить в хранилище ядро системы, которое вами не меняется, но требует периодического обновления.