Jak przenieść istniejący podmoduł Git w repozytorium Git?

Chciałbym zmienić nazwę katalogu submodułu Git w moim superprojekcie Git.

Załóżmy, że mam następujący wpis w moim .gitmodulespliku:

[submodule ".emacs.d/vimpulse"]  
path = .emacs.d/vimpulse  
url = git://gitorious.org/vimpulse/vimpulse.git

Co muszę wpisać, aby przenieść .emacs.d/vimpulsekatalog .emacs.d/vendor/vimpulsebez uprzedniego usunięcia go (wyjaśnione tutaj i tutaj ), a następnie dodania go ponownie.

Czy Git naprawdę potrzebuje całej ścieżki w znaczniku submodułu

[submodule ".emacs.d/vimpulse"]

lub czy można również zapisać tylko nazwę podprojektu?

[submodule "vimpulse"]

Uwaga: Jak wspomniano w komentarzach, ta odpowiedź odnosi się do kroków wymaganych w starszych wersjach git. Git ma teraz natywne wsparcie dla przenoszenia submodułów:

Od wersji 1.8.5 git git mv old/submod new/submoddziała zgodnie z oczekiwaniami i wykonuje całą instalację wodociągową. Możesz użyć gita 1.9.3 lub nowszego, ponieważ zawiera poprawki do przenoszenia podmodułów.

Proces jest podobny do sposobu usuwania submodułu (zobacz Jak usunąć submoduł? ):

1. Edytuj .gitmodulesi zmień odpowiednio ścieżkę submodułu i umieść ją w indeksie za pomocą git add .gitmodules.
2. W razie potrzeby utwórz katalog nadrzędny nowej lokalizacji submodula ( mkdir -p new/parent).
3. Przenieś całą zawartość ze starego do nowego katalogu ( mv -vi old/parent/submodule new/parent/submodule).
4. Upewnij się, że Git śledzi ten katalog ( git add new/parent).
5. Usuń stary katalog za pomocą git rm --cached old/parent/submodule.
6. Przenieś katalog .git/modules/old/parent/submodulez całą zawartością do .git/modules/new/parent/submodule.
7. Edytuj .git/modules/new/parent/configplik, upewnij się, że element z drzewa roboczego wskazuje nowe lokalizacje, więc w tym przykładzie powinno to być worktree = ../../../../../new/parent/module. Zazwyczaj ..w bezpośredniej ścieżce w tym miejscu powinny znajdować się dwa katalogi więcej niż katalogi.

8. Edytuj plik new/parent/module/.git, upewnij się, że ścieżka w nim wskazuje poprawną nową lokalizację w głównym .gitfolderze projektu , więc w tym przykładzie gitdir: ../../../.git/modules/new/parent/submodule.

   git status dane wyjściowe wyglądają dla mnie następująco:

   # On branch master
   # Changes to be committed:
   #   (use "git reset HEAD <file>..." to unstage)
   #
   #       modified:   .gitmodules
   #       renamed:    old/parent/submodule -> new/parent/submodule
   #
   

9. Na koniec zatwierdz zmiany.

Najnowocześniejsza odpowiedź zaczerpnięta z powyższego komentarza Vallorica:

1. Uaktualnij do Git 1.9.3 (lub 2.18, jeśli podmoduł zawiera zagnieżdżone podmoduły )
2. git mv old/submod new/submod
3. Następnie .gitmodules i katalog podmodułów są już przemieszczane dla zatwierdzenia (możesz to zweryfikować za pomocą git status.)
4. Zatwierdź zmiany za pomocą git commiti możesz zacząć!

Gotowy!

W moim przypadku chciałem przenieść submoduł z jednego katalogu do podkatalogu, np. „AFNetworking” -> „ext / AFNetworking”. Oto kroki, które wykonałem:

1. Edytuj .gitmodules zmieniając nazwę i ścieżkę submodułu na „ext / AFNetworking”
2. Przenieś katalog git submodułu z „.git / modules / AFNetworking” do „.git / modules / ext / AFNetworking”
3. Przenieś bibliotekę z „AFNetworking” do „ext / AFNetworking”
4. Edytuj „.git / modules / ext / AFNetworking / config” i napraw [core] worktreelinię. Mój zmienił się z ../../../AFNetworkingna../../../../ext/AFNetworking
5. Edytuj „ext / AFNetworking / .git” i napraw gitdir. Mój zmienił się z ../.git/modules/AFNetworkingna../../git/modules/ext/AFNetworking
6. git add .gitmodules
7. git rm --cached AFNetworking
8. git submodule add -f <url> ext/AFNetworking

Wreszcie zobaczyłem w statusie git:

matt$ git status
# On branch ios-master
# Changes to be committed:
#   (use "git reset HEAD <file>..." to unstage)
#
#   modified:   .gitmodules
#   renamed:    AFNetworking -> ext/AFNetworking

Zrobione. Powyższy przykład nie zmienia głębokości katalogu, co ma duży wpływ na złożoność zadania i nie zmienia nazwy submodułu (co może nie jest tak naprawdę konieczne, ale zrobiłem to, aby zachować spójność z tym, co tak by się stało, gdybym dodał nowy moduł na tej ścieżce).

[Aktualizacja: 26.11.2014] Jak Yar ładnie podsumowuje poniżej, zanim cokolwiek zrobisz, upewnij się, że znasz adres URL podmodułu. Jeśli jest nieznany, otwórz .git/.gitmodulesi sprawdź klucz submodule.<name>.url.

Dla mnie zadziałało usunięcie starego podmodułu za pomocą, git submodule deinit <submodule>a następnie git rm <submodule-folder>. Następnie ponownie dodaj submoduł z nową nazwą folderu i zatwierdź. Sprawdzanie statusu git przed zatwierdzeniem pokazuje, że stary podmoduł został przemianowany na nową nazwę i zmodyfikowany .gitmodule.

$ git submodule deinit foo
$ git rm foo
$ git submodule add https://bar.com/foo.git new-foo
$ git status
renamed:    foo -> new-foo
modified:   .gitmodules
$ git commit -am "rename foo submodule to new-foo"

Sztuką wydaje się być zrozumienie, że .gitkatalog podmodułów jest teraz przechowywany w głównym repozytorium pod .git/modules, a każdy podmoduł ma .gitplik, który na to wskazuje. Oto procedura, której potrzebujesz teraz:

• Przenieś submoduł do nowego domu.
• Zmodyfikuj .gitplik w katalogu roboczym podmodułu i zmodyfikuj zawartą w nim ścieżkę, tak aby wskazywał właściwy katalog w katalogu głównego repozytorium .git/modules.
• Wejdź do .git/moduleskatalogu głównego repozytorium i znajdź katalog odpowiadający Twojemu podmodułowi.
• Edytuj configplik, aktualizując worktreeścieżkę, tak aby wskazywała nową lokalizację katalogu roboczego podmodułu.
• Edytuj .gitmodulesplik w katalogu głównym repozytorium głównego, aktualizując ścieżkę do katalogu roboczego podmodułu.
• git add -u
• git add <parent-of-new-submodule-directory>(Ważne jest, aby dodać nadrzędny , a nie sam katalog podmodułu).

Kilka uwag:

• Te [submodule "submodule-name"]linie .gitmodulesi .git/configmusi pasować do siebie, ale nie odpowiadają cokolwiek innego.
• Podmodułowy katalog roboczy i .gitkatalog muszą poprawnie wskazywać na siebie.
• .gitmodulesI .git/configpliki powinny być zsynchronizowane.

Ciąg w cudzysłowie po „[submodule” nie ma znaczenia. Możesz go zmienić na „foobar”, jeśli chcesz. Służy do znalezienia pasującego wpisu w „.git / config”.

Dlatego, jeśli dokonasz zmiany przed uruchomieniem „git submodule init”, będzie działać dobrze. Jeśli dokonasz zmiany (lub przejmiesz ją poprzez scalenie), będziesz musiał albo ręcznie edytować .git / config lub ponownie uruchomić „git submodule init”. Jeśli zrobisz to drugie, pozostanie ci nieszkodliwy wpis „spleciony” ze starą nazwą w .git / config.

Możesz po prostu dodać nowy submoduł i usunąć stary submoduł za pomocą standardowych poleceń. (powinien zapobiec przypadkowym błędom w .git)

Przykładowa konfiguracja:

mkdir foo; cd foo; git init; 
echo "readme" > README.md; git add README.md; git commit -m "First"
## add submodule
git submodule add git://github.com/jquery/jquery.git
git commit -m "Added jquery"
## </setup example>

Przykład przeniesienia „jquery” do „vendor / jquery / jquery”:

oldPath="jquery"
newPath="vendor/jquery/jquery"
orginUrl=`git config --local --get submodule.${oldPath}.url`

## add new submodule
mkdir -p `dirname "${newPath}"`
git submodule add -- "${orginUrl}" "${newPath}"

## remove old submodule
git config -f .git/config --remove-section "submodule.${oldPath}"
git config -f .gitmodules --remove-section "submodule.${oldPath}"
git rm --cached "${oldPath}"
rm -rf "${oldPath}"              ## remove old src
rm -rf ".git/modules/${oldPath}" ## cleanup gitdir (housekeeping)

## commit
git add .gitmodules
git commit -m "Renamed ${oldPath} to ${newPath}"

Metoda bonusowa dla dużych submodułów:

Jeśli podmoduł jest duży i wolisz nie czekać na klon, możesz utworzyć nowy podmoduł, używając starego jako źródła, a następnie przełączyć źródło.

Przykład (użyj tej samej konfiguracji przykładowej)

oldPath="jquery"
newPath="vendor/jquery/jquery"
baseDir=`pwd`
orginUrl=`git config --local --get submodule.${oldPath}.url`

# add new submodule using old submodule as origin
mkdir -p `dirname "${newPath}"`
git submodule add -- "file://${baseDir}/${oldPath}" "${newPath}"

## change origin back to original
git config -f .gitmodules submodule."${newPath}".url "${orginUrl}"
git submodule sync -- "${newPath}"

## remove old submodule
...

Podane rozwiązanie nie działało dla mnie, jednak podobna wersja działała ...

Dzieje się tak ze sklonowanym repozytorium, dlatego podmoduły repozytorium git znajdują się w najlepszych repozytoriach .git reż. Wszystkie kationy pochodzą z górnego repozytorium:

1. Edytuj .gitmodules i zmień ustawienie „path =” dla danego submodułu. (Nie trzeba zmieniać etykiety ani dodawać tego pliku do indeksu).

2. Edytuj .git / modules / name / config i zmień ustawienie „worktree =” dla danego podmodułu

3. biegać:

   mv submodule newpath/submodule
   git add -u
   git add newpath/submodule
   

Zastanawiam się, czy robi to różnicę, jeśli repozytoria są atomowe, czy względne submoduły, w moim przypadku były względne (submoduł / .git jest odnośnikiem do topproject / .git / modules / submodule)

Wystarczy użyć skryptu powłoki git-submodule-move .

Właśnie przeszedłem tę próbę wczoraj i ta odpowiedź zadziałała idealnie. Oto moje kroki dla jasności:

1. Upewnij się, że podmoduł jest zalogowany i przekazany na swój serwer. Musisz także wiedzieć, na jakiej gałęzi się znajduje.
2. Potrzebujesz adresu URL swojego modułu podrzędnego! Użyj, more .gitmodulesponieważ po usunięciu submodułu nie będzie go w pobliżu
3. Teraz możesz użyć deinit, rma następniesubmodule add

PRZYKŁAD

• Podmoduł Git znajduje się w: Classes / lib / mustIReally
• Przeprowadzka do: lib / AudioBus
• URL: http://developer.audiob.us/download/SDK.git

POLECENIA

    git submodule deinit Classes/lib/mustIReally
    git rm foo
    git submodule add http://developer.audiob.us/download/SDK.git lib/AudioBus

    # do your normal commit and push
    git commit -a 

UWAGA: git mv tego nie robi. W ogóle.