Предполагая, что репозиторий подмодуля содержит коммит, который вы хотите использовать (в отличие от коммита, на который ссылается текущее состояние суперпроекта), есть два способа сделать это.
Первый требует, чтобы вы уже знали коммит из подмодуля, который вы хотите использовать. Он работает «изнутри наружу», напрямую настраивая подмодуль, а затем обновляя суперпроект. Второй работает извне, находя коммит супер-проекта, который изменил подмодуль, и затем сбрасывает индекс супер-проекта для ссылки на другой коммит суб-модуля.
Наизнанку
Если вы уже знаете, какой коммит вы хотите использовать cd
в субмодуле, выберите в субмодуле коммит, который вы хотите, git add
а затем иgit commit
его обратно в супер-проекте.
Пример:
$ git submodule update
fatal: reference is not a tree: e47c0a16d5909d8cb3db47c81896b8b885ae1556
Unable to checkout 'e47c0a16d5909d8cb3db47c81896b8b885ae1556' in submodule path 'sub'
К сожалению, кто-то сделал супер-проект коммита, который ссылается на неопубликованный коммит в субмодуле sub
. Почему-то мы уже знаем, что хотим, чтобы субмодуль был в коммите5d5a3ee314476701a20f2c6ec4a53f88d651df6c
. Идите туда и проверьте это непосредственно.
Оформить заказ в субмодуле
$ cd sub
$ git checkout 5d5a3ee314476701a20f2c6ec4a53f88d651df6c
Note: moving to '5d5a3ee314476701a20f2c6ec4a53f88d651df6c' which isn't a local branch
If you want to create a new branch from this checkout, you may do so
(now or later) by using -b with the checkout command again. Example:
git checkout -b <new_branch_name>
HEAD is now at 5d5a3ee... quux
$ cd ..
Так как мы проверяем коммит, это приводит к отсоединению HEAD в подмодуле. Если вы хотите убедиться, что субмодуль использует ветку, используйтеgit checkout -b newbranch <commit>
для создания и извлечения ветку при фиксации или извлечение ветки, которую вы хотите (например, ту, у которой в подсказке есть нужная фиксация).
Обновление Супер-проекта
Оформление заказа в подмодуле отражается в суперпроекте как изменение рабочего дерева. Таким образом, мы должны поэтапно изменить индекс супер-проекта и проверить результаты.
$ git add sub
Проверьте результаты
$ git submodule update
$ git diff
$ git diff --cached
diff --git c/sub i/sub
index e47c0a1..5d5a3ee 160000
--- c/sub
+++ i/sub
@@ -1 +1 @@
-Subproject commit e47c0a16d5909d8cb3db47c81896b8b885ae1556
+Subproject commit 5d5a3ee314476701a20f2c6ec4a53f88d651df6c
Обновление субмодуля было тихим, потому что субмодуль уже находится в указанной фиксации. Первый diff показывает, что индекс и рабочее дерево совпадают. Третья разница показывает, что единственное поэтапное изменение - это перемещение sub
подмодуля в другой коммит.
совершить
git commit
Это фиксирует фиксированную запись субмодуля.
Снаружи
Если вы не уверены, какой коммит вам следует использовать из подмодуля, вы можете посмотреть историю в суперпроекте, чтобы он вам помог. Вы также можете управлять сбросом прямо из супер-проекта.
$ git submodule update
fatal: reference is not a tree: e47c0a16d5909d8cb3db47c81896b8b885ae1556
Unable to checkout 'e47c0a16d5909d8cb3db47c81896b8b885ae1556' in submodule path 'sub'
Это та же ситуация, что и выше. Но на этот раз мы сосредоточимся на том, чтобы починить его из суперпроекта, а не заглядывать в подмодуль.
Найти Странствующий коммит Супер-проекта
$ git log --oneline -p -- sub
ce5d37c local change in sub
diff --git a/sub b/sub
index 5d5a3ee..e47c0a1 160000
--- a/sub
+++ b/sub
@@ -1 +1 @@
-Subproject commit 5d5a3ee314476701a20f2c6ec4a53f88d651df6c
+Subproject commit e47c0a16d5909d8cb3db47c81896b8b885ae1556
bca4663 added sub
diff --git a/sub b/sub
new file mode 160000
index 0000000..5d5a3ee
--- /dev/null
+++ b/sub
@@ -0,0 +1 @@
+Subproject commit 5d5a3ee314476701a20f2c6ec4a53f88d651df6c
ОК, похоже, что все пошло не ce5d37c
так, поэтому мы восстановим подмодуль из его родителя ( ce5d37c~
).
В качестве альтернативы, вы можете взять коммит субмодуля из текста патча ( 5d5a3ee314476701a20f2c6ec4a53f88d651df6c
) и использовать вместо него вышеописанный процесс «изнутри, снаружи».
Оформить заказ в Супер-проекте
$ git checkout ce5d37c~ -- sub
Это сбрасывает запись субмодуля для sub
того, что было в коммите ce5d37c~
в суперпроекте.
Обновите субмодуль
$ git submodule update
Submodule path 'sub': checked out '5d5a3ee314476701a20f2c6ec4a53f88d651df6c'
Обновление субмодуля прошло нормально (это указывает на отключенную ГОЛОВКУ).
Проверьте результаты
$ git diff ce5d37c~ -- sub
$ git diff
$ git diff --cached
diff --git c/sub i/sub
index e47c0a1..5d5a3ee 160000
--- c/sub
+++ i/sub
@@ -1 +1 @@
-Subproject commit e47c0a16d5909d8cb3db47c81896b8b885ae1556
+Subproject commit 5d5a3ee314476701a20f2c6ec4a53f88d651df6c
Первый diff показывает, что sub
теперь то же самое в ce5d37c~
. Вторая разница показывает, что индекс и рабочее дерево совпадают. Третья разница показывает, что единственное поэтапное изменение - это перемещение sub
подмодуля в другой коммит.
совершить
git commit
Это фиксирует фиксированную запись субмодуля.