Comment remplacer un sous-module git par un autre dépôt?


96

Comment remplacer un sous-module git par un dépôt git différent?

Plus précisément, j'ai un sous-module:

  • situé à ./ExternalFrameworks/TestFrameworkce point vers un repo gitgit@github.com:userA/TestFramework.git
  • Je voudrais qu'il pointe maintenant git@github.com:userB/TestFramework.git.

Le problème est que lorsque je supprime le sous-module avec la méthode décrite ici , puis le rajoute à l'aide de la commande

git submodule add git@github.com:userB/TestFramework.git

J'obtiens cette erreur:

A git directory for 'ExternalFrameworks/TestFramework' is found locally with remote(s):
  origin    git@github.com:userA/TestFramework.git
If you want to reuse this local git directory instead of cloning again from
  git@github.com:userB/TestFramework.git
use the '--force' option. If the local git directory is not the correct repo
or you are unsure what this means choose another name with the '--name' option.

Réponses:


123

Si l'emplacement (URL) du sous-module a changé, vous pouvez simplement:

  1. Modifiez votre .gitmodulefichier pour utiliser la nouvelle URL
  2. Supprimer le dossier du sous-module dans le référentiel rm -rf .git/modules/<submodule>
  3. Supprimer le dossier du sous-module dans le répertoire de travail rm -rf <submodule>
  4. Courir git submodule sync
  5. Courir git submodule update

Des informations plus complètes peuvent être trouvées ailleurs:


4
A noter également: lorsqu'un autre utilisateur (qui avait déjà introduit le sous-module) reçoit votre mise à jour, il devra également faire la "synchronisation du sous-module git" une fois avant que le nouveau sous-module ne fonctionne pour lui.
joseph.hainline

2
Cela n'a pas fonctionné pour moi. Mon sous-module indiquait toujours l'ancienne URL après cela. Des idées pourquoi?
Arne

34
@Arne Peut-être que votre sous-module n'a jamais été correctement initialisé. Je devais le faire rm -rf .git/modules/<submodule>avant que ça marche pour moi.
David Braun

@DavidBraun J'ai le même problème que @Arne bien que faire git submodule syncaprès rm -rf .git/modules/<submodule>donne fatal: Not a git repository: ../.git/modules/<submodule>. Des conseils? J'ai initialement créé le sous-module via git submodule add https://<submodule-url>selon les documents git ...
acannon828

1
Ensuite, j'ai dû cd dans le répertoire du module, git checkout la branche que je veux, puis git pull.
Nicolas Raoul

34

Tout d'abord, supprimez le sous-module actuel avec la méthode déjà mentionnée ici , que j'inclus par commodité:

  • Supprimer la section pertinente du .gitmodulesfichier
  • Supprimer la section correspondante de .git/config
  • Exécuter git rm --cached path_to_submodule(pas de barre oblique finale)
  • Validez et supprimez les fichiers de sous-modules maintenant non suivis

Maintenant, ajoutez le nouveau sous-module avec l' --nameindicateur. Cela donnera à git un nom alternatif à référencer .git/configpour le sous-module, à déconfliger avec le sous-module qui était là historiquement, que vous souhaitez toujours travailler dans votre histoire précédente.

Alors tapez:

git submodule add --name UpdatedTestFramework git@github.com:userB/TestFramework.git

et vous obtiendrez le sous-module chargé sur le chemin que vous attendez.


2
Bien que cette méthode fonctionne, ce n'est pas aussi propre que la méthode de Tim.
joseph.hainline

4
Cela a fonctionné pour moi, mais j'ai également dû supprimer .git/modules/<path_to_submodule>.
Nate

1
Appréciez la référence à --name. Je n'étais pas au courant des problèmes liés à cela, et je n'ai pas pu remplacer un sous-module avant d'avoir utilisé cette option (grâce à votre réponse).
aknuds1

Cela a fini par être la seule méthode qui a fonctionné pour moi, mais je voulais garder le même nom de répertoire. Il a vérifié le chemin correct et a fait du nom du module le nom souhaité, mais le nom du répertoire de travail était le nouveau nom du dépôt. Donc, si vous voulez le même nom, vous devez également le spécifier à la fin de l'url comme ceci: git submodule add --name old-name-to-keep git@github.com:userB/new-repository.git old-name-to-keep
rgb

8

Ces commandes effectueront le travail à l'invite de commande sans modifier aucun fichier sur le référentiel local.

git config --file=.gitmodules submodule.Submod.url https://github.com/username/ABC.git
git config --file=.gitmodules submodule.Submod.branch Dev
git submodule sync
git submodule update --init --recursive --remote

5

Ce qui a résolu cela pour moi était à la racine de votre dépôt git (pas le sous-module), exécutez

rm -rf .git/modules/yourmodule

Ensuite, vous devriez pouvoir ajouter comme d'habitude.


3

Le moyen le plus simple que j'ai trouvé est le suivant:

git rm -rf [submodule_dir]
git submodule add --name new_[submodule_name] [new_submodule_url] [submodule_dir]

Je n'ai pas aimé l'idée de modifier mon .gitmodulesmanuellement. J'ai également écrit un petit article à ce sujet.


2

Si vous souhaitez modifier l'URL distante uniquement pour ce clone :

git config submodule."$submodule_name".url "$new_url"

Cela n'affectera pas le .gitmodulesfichier du projet parent, il ne sera donc pas propagé à d'autres développeurs.

Ceci est décrit comme « utilisateur change d'enregistrement spécifique » ici .

Ne pas exécutergit submodule synccar cela réinitialisera à nouveau l'URL par défaut.

En utilisant notre site, vous reconnaissez avoir lu et compris notre politique liée aux cookies et notre politique de confidentialité.
Licensed under cc by-sa 3.0 with attribution required.