Comment déplacer un sous-module Git existant dans un référentiel Git?

Je voudrais changer le nom de répertoire d'un sous-module Git dans mon superprojet Git.

Supposons que j'ai l'entrée suivante dans mon .gitmodulesfichier:

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

Que dois-je taper pour déplacer le .emacs.d/vimpulserépertoire .emacs.d/vendor/vimpulsesans le supprimer d'abord (expliqué ici et ici ), puis l'ajouter à nouveau.

Est-ce que Git a vraiment besoin de tout le chemin dans la balise de sous-module

[submodule ".emacs.d/vimpulse"]

ou est-il également possible de stocker uniquement le nom du sous-projet?

[submodule "vimpulse"]

Remarque: Comme mentionné dans les commentaires, cette réponse fait référence aux étapes nécessaires avec les anciennes versions de git. Git a maintenant un support natif pour déplacer des sous-modules:

Depuis git 1.8.5, git mv old/submod new/submodfonctionne comme prévu et fait toute la plomberie pour vous. Vous voudrez peut-être utiliser git 1.9.3 ou plus récent, car il comprend des correctifs pour le déplacement des sous-modules.

Le processus est similaire à la façon dont vous supprimeriez un sous-module (voir Comment supprimer un sous-module? ):

1. Modifiez .gitmoduleset modifiez le chemin du sous-module de manière appropriée et placez-le dans l'index avec git add .gitmodules.
2. Si nécessaire, créez le répertoire parent du nouvel emplacement du sous-module ( mkdir -p new/parent).
3. Déplacer tout le contenu de l'ancien vers le nouveau répertoire ( mv -vi old/parent/submodule new/parent/submodule).
4. Assurez-vous que Git suit ce répertoire ( git add new/parent).
5. Supprimez l'ancien répertoire avec git rm --cached old/parent/submodule.
6. Déplacez le répertoire .git/modules/old/parent/submoduleavec tout son contenu vers .git/modules/new/parent/submodule.
7. Modifiez le .git/modules/new/parent/configfichier, assurez-vous que l'élément de l'arbre de travail pointe vers les nouveaux emplacements, donc dans cet exemple, il devrait l'être worktree = ../../../../../new/parent/module. En général, il doit y avoir deux ..répertoires de plus dans le chemin direct à cet endroit.

8. Modifiez le fichier new/parent/module/.git, assurez-vous que le chemin d'accès pointe vers le nouvel emplacement correct dans le .gitdossier principal du projet , donc dans cet exemple gitdir: ../../../.git/modules/new/parent/submodule.

   git status la sortie ressemble à ceci pour moi après:

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

9. Enfin, validez les modifications.

La réponse la plus moderne, tirée du commentaire de Valloric ci-dessus:

1. Mettre à niveau vers Git 1.9.3 (ou 2.18 si le sous-module contient des sous-modules imbriqués )
2. git mv old/submod new/submod
3. Ensuite, le .gitmodules et le répertoire du sous-module sont déjà organisés pour une validation (vous pouvez le vérifier avec git status.)
4. Engagez les changements avec git commitet vous êtes prêt à partir!

Terminé!

Dans mon cas, je voulais déplacer un sous-module d'un répertoire dans un sous-répertoire, par exemple "AFNetworking" -> "ext / AFNetworking". Voici les étapes que j'ai suivies:

1. Modifiez .gitmodules en changeant le nom et le chemin du sous-module en "ext / AFNetworking"
2. Déplacer le répertoire git du sous-module de ".git / modules / AFNetworking" vers ".git / modules / ext / AFNetworking"
3. Déplacer la bibliothèque de "AFNetworking" vers "ext / AFNetworking"
4. Modifiez ".git / modules / ext / AFNetworking / config" et corrigez la [core] worktreeligne. Le mien est passé de ../../../AFNetworkingà../../../../ext/AFNetworking
5. Modifiez "ext / AFNetworking / .git" et corrigez gitdir. Le mien est passé de ../.git/modules/AFNetworkingà../../git/modules/ext/AFNetworking
6. git add .gitmodules
7. git rm --cached AFNetworking
8. git submodule add -f <url> ext/AFNetworking

Enfin, j'ai vu dans le statut 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

Et voilà. L'exemple ci-dessus ne change pas la profondeur du répertoire, ce qui fait une grande différence dans la complexité de la tâche, et ne change pas le nom du sous-module (ce qui n'est peut-être pas vraiment nécessaire, mais je l'ai fait pour être cohérent avec ce se produirait si j'ajoutais un nouveau module sur ce chemin.)

[Mise à jour: 2014-11-26] Comme Yar le résume bien ci-dessous, avant de faire quoi que ce soit, assurez-vous de connaître l'URL du sous-module. Si inconnue, ouvrez .git/.gitmoduleset examinez la clé submodule.<name>.url.

Ce qui a fonctionné pour moi a été de supprimer l'ancien sous-module en utilisant git submodule deinit <submodule>suivi de git rm <submodule-folder>. Ajoutez ensuite le sous-module avec le nouveau nom de dossier et validez. La vérification de l'état de git avant de valider affiche l'ancien sous-module renommé avec le nouveau nom et le .gitmodule modifié.

$ 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"

L'astuce semble être de comprendre que le .gitrépertoire des sous-modules est maintenant conservé dans le référentiel maître, sous .git/modules, et chaque sous-module a un .gitfichier qui le pointe. Voici la procédure dont vous avez besoin maintenant:

• Déplacez le sous-module dans sa nouvelle maison.
• Modifiez le .gitfichier dans le répertoire de travail du sous-module et modifiez le chemin qu'il contient afin qu'il pointe vers le bon répertoire dans le répertoire du référentiel maître .git/modules.
• Entrez dans le répertoire du référentiel maître .git/moduleset recherchez le répertoire correspondant à votre sous-module.
• Modifiez le configfichier, en mettant à jour le worktreechemin afin qu'il pointe vers le nouvel emplacement du répertoire de travail du sous-module.
• Modifiez le .gitmodulesfichier à la racine du référentiel maître, en mettant à jour le chemin d'accès au répertoire de travail du sous-module.
• git add -u
• git add <parent-of-new-submodule-directory>(Il est important que vous ajoutiez le parent et non le répertoire du sous-module lui-même.)

Quelques notes:

• Les [submodule "submodule-name"]lignes .gitmoduleset .git/configdoivent correspondre, mais ne correspondent à rien d'autre.
• Le répertoire de travail du sous-module et le .gitrépertoire doivent pointer correctement l'un vers l'autre.
• Les fichiers .gitmoduleset .git/configdoivent être synchronisés.

La chaîne entre guillemets après "[sous-module" n'a pas d'importance. Vous pouvez le changer en "foobar" si vous le souhaitez. Il est utilisé pour trouver l'entrée correspondante dans ".git / config".

Par conséquent, si vous effectuez la modification avant d'exécuter "git submodule init", cela fonctionnera correctement. Si vous apportez la modification (ou la récupérez via une fusion), vous devrez soit éditer manuellement .git / config, soit réexécuter "git submodule init". Si vous faites ce dernier, vous vous retrouverez avec une entrée "échouée" inoffensive avec l'ancien nom dans .git / config.

Vous pouvez simplement ajouter un nouveau sous-module et supprimer l'ancien sous-module à l'aide de commandes standard. (devrait éviter toute erreur accidentelle à l'intérieur de .git)

Exemple de configuration:

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>

Examinez le déplacement de «jquery» vers «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}"

Méthode bonus pour les grands sous-modules:

Si le sous-module est volumineux et que vous préférez ne pas attendre le clone, vous pouvez créer le nouveau sous-module en utilisant l'ancien comme origine, puis changer d'origine.

Exemple (utilisez le même exemple de configuration)

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
...

La solution donnée n'a pas fonctionné pour moi, mais une version similaire a fonctionné ...

C'est avec un référentiel cloné, donc les sous-modules git repos sont contenus dans les répertoires supérieurs .git dir. Tous les cations proviennent du référentiel supérieur:

1. Modifiez .gitmodules et modifiez le paramètre "path =" du sous-module en question. (Pas besoin de changer l'étiquette, ni d'ajouter ce fichier à l'index.)

2. Modifiez .git / modules / name / config et modifiez le paramètre "worktree =" pour le sous-module en question

3. courir:

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

Je me demande si cela fait une différence si les référentiels sont atomiques, ou des sous-modules relatifs, dans mon cas c'était relatif (sous-module / .git est une référence à topproject / .git / modules / submodule)

Utilisez simplement le script shell git-submodule-move .

Je viens de traverser cette épreuve hier et cette réponse a parfaitement fonctionné. Voici mes étapes, pour plus de clarté:

1. Assurez-vous que le sous-module est archivé et envoyé à son serveur. Vous devez également savoir sur quelle branche son est activée.
2. Vous avez besoin de l'URL de votre sous-module! À utiliser more .gitmodulescar une fois le sous-module supprimé, il ne sera plus là
3. Vous pouvez maintenant utiliser deinit, rmpuissubmodule add

EXEMPLE

• Le sous-module Git est dans: Classes / lib / mustIReally
• Déplacement vers: lib / AudioBus
• URL: http://developer.audiob.us/download/SDK.git

COMMANDES

    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 

REMARQUE: git mv ne fait pas cela. Du tout.