Como faço para substituir um submódulo git por outro repo?

96

Como substituo um submódulo git por um repo git diferente?

Especificamente, tenho um submódulo:

localizado em ./ExternalFrameworks/TestFramework naquele ponto para um repo gitgit@github.com:userA/TestFramework.git
Eu gostaria agora de apontar para git@github.com:userB/TestFramework.git .

O problema é que quando eu deleto o submódulo com o método descrito aqui , então o adiciono novamente usando o comando

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

Eu recebo este erro:

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.

git git-submodules

— joseph.hainline
fonte

1

possível duplicata de Changing remote repository for a git submodule

— jiyinyiyong

123

Se a localização (URL) do submódulo mudou, você pode simplesmente:

Modifique seu .gitmodulearquivo para usar o novo URL
Exclua a pasta do submódulo no repo rm -rf .git/modules/<submodule>
Exclua a pasta do submódulo no diretório de trabalho rm -rf <submodule>
Corre git submodule sync
Corre git submodule update

Informações mais completas podem ser encontradas em outro lugar:

Alterando o repositório remoto para um submódulo git

— Tim Henigan
fonte

4

Também vale a pena notar: quando outro usuário (que já havia iniciado o submódulo) receber sua atualização, ele também terá que fazer a "sincronização do submódulo git" uma vez antes que o novo submódulo funcione para eles.

— joseph.hainline

2

Isto não funcionou para mim. Meu submódulo ainda apontava para o URL antigo depois disso. Alguma ideia por quê?

— Arne

34

@Arne Talvez seu submódulo nunca tenha sido inicializado corretamente. Eu tinha que fazer rm -rf .git/modules/<submodule>isso antes de funcionar para mim.

— David Braun

@DavidBraun Eu tenho o mesmo problema que @Arne apesar de fazer git submodule syncdepois de rm -rf .git/modules/<submodule>dar fatal: Not a git repository: ../.git/modules/<submodule>. Alguma dica? Eu inicialmente criei o submódulo via de git submodule add https://<submodule-url>acordo com os documentos do git ...

— acannon828

1

Depois disso, eu tive que fazer o cd para o diretório do módulo, git checkout o branch que eu quero, então git pull.

— Nicolas Raoul

34

Primeiro, exclua o submódulo atual com o método já mencionado aqui , que estou incluindo por conveniência:

Exclua a seção relevante do .gitmodulesarquivo
Exclua a seção relevante de .git/config
Executar git rm --cached path_to_submodule(sem barra final)
Confirme e exclua os arquivos de submódulo agora não rastreados

Agora, adicione o novo submódulo com a --namebandeira. Isso dará ao git um nome alternativo para fazer referência .git/configao submódulo, para desconsiderar o submódulo que estava lá historicamente, que você ainda deseja trabalhar em seu histórico anterior.

Então digite:

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

e você terá o submódulo carregado no caminho que você espera.

— joseph.hainline
fonte

2

Embora essa maneira funcione, não é tão limpa quanto o método de Tim.

— joseph.hainline

4

Isso funcionou para mim, mas eu também tive que excluir .git/modules/<path_to_submodule>.

— Nate

1

Agradeço a referência a --name. Eu não estava ciente dos problemas relacionados a isso e não fui capaz de substituir um submódulo até que fiz uso desta opção (graças à sua resposta).

— aknuds1

Este acabou sendo o único método que funcionou para mim, porém eu queria manter o mesmo nome de diretório. Ele fez o checkout do caminho correto e tornou o nome do módulo o nome desejado, mas o nome do diretório de trabalho era o novo nome do repo. Portanto, se você deseja o mesmo nome, também precisa especificar isso no final da url, da seguinte forma: git submodule add --name old-name-to-keep git@github.com:userB/new-repository.git old-name-to-keep

— rgb

8

Esses comandos farão o trabalho no prompt de comando sem alterar nenhum arquivo no repositório 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

— Pavan Sokke Nagaraj
fonte

5

O que consertou isso para mim foi na raiz do seu repositório git (não no submódulo), execute

rm -rf .git/modules/yourmodule

Então você deve ser capaz de adicionar normalmente.

— hobberwickey
fonte

3

A maneira mais fácil que encontrei é esta:

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

Não gostei da ideia de modificar o meu .gitmodulesmanualmente. Eu também escrevi uma pequena postagem no blog sobre isso.

— DerZyklop
fonte

2

Se você deseja alterar o URL remoto apenas para este clone :

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

Isso não afetará o .gitmodulesarquivo no projeto pai, portanto não será propagado para outros desenvolvedores.

Isso é descrito como "alterações de registro específicas do usuário" aqui .

Não execute,git submodule syncpois isso redefinirá para o URL padrão novamente.

— joeytwiddle
fonte