¿Cómo muevo un submódulo Git existente dentro de un repositorio Git?

Me gustaría cambiar el nombre del directorio de un submódulo Git en mi superproyecto Git.

Supongamos que tengo la siguiente entrada en mi .gitmodulesarchivo:

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

¿Qué debo escribir para mover el .emacs.d/vimpulsedirectorio .emacs.d/vendor/vimpulsesin eliminarlo primero (explicado aquí y aquí ) y luego volver a agregarlo?

¿Git realmente necesita la ruta completa en la etiqueta del submódulo?

[submodule ".emacs.d/vimpulse"]

¿O también es posible almacenar solo el nombre del subproyecto?

[submodule "vimpulse"]

Nota: Como se menciona en los comentarios, esta respuesta se refiere a los pasos necesarios con versiones anteriores de git. Git ahora tiene soporte nativo para mover submódulos:

Desde git 1.8.5, git mv old/submod new/submodfunciona como se espera y hace toda la fontanería por usted. Es posible que desee utilizar git 1.9.3 o posterior, ya que incluye correcciones para el movimiento de submódulos.

El proceso es similar a cómo eliminaría un submódulo (consulte ¿Cómo elimino un submódulo? ):

1. Edite .gitmodulesy cambie la ruta del submódulo adecuadamente, y colóquelo en el índice con git add .gitmodules.
2. Si es necesario, cree el directorio principal de la nueva ubicación del submódulo ( mkdir -p new/parent).
3. Mueva todo el contenido del directorio antiguo al nuevo ( mv -vi old/parent/submodule new/parent/submodule).
4. Asegúrese de que Git rastrea este directorio ( git add new/parent).
5. Elimine el directorio antiguo con git rm --cached old/parent/submodule.
6. Mueva el directorio .git/modules/old/parent/submodulecon todo su contenido a .git/modules/new/parent/submodule.
7. Edite el .git/modules/new/parent/configarchivo, asegúrese de que el elemento de árbol de trabajo apunte a las nuevas ubicaciones, por lo que en este ejemplo debería estarlo worktree = ../../../../../new/parent/module. Por lo general, debe haber dos más ..que directorios en la ruta directa en ese lugar.

8. Edite el archivo new/parent/module/.git, asegúrese de que la ruta en él apunte a la nueva ubicación correcta dentro de la .gitcarpeta principal del proyecto , así que en este ejemplo gitdir: ../../../.git/modules/new/parent/submodule.

   git status La salida se ve así para mí despué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. Finalmente, comete los cambios.

La respuesta más moderna, tomada del comentario anterior de Valloric:

1. Actualice a Git 1.9.3 (o 2.18 si el submódulo contiene submódulos anidados )
2. git mv old/submod new/submod
3. Luego, los .gitmodules y el directorio de submódulos ya están preparados para una confirmación (puede verificar esto con git status).
4. ¡Compromete los cambios git commity listo!

¡Hecho!

En mi caso, quería mover un submódulo de un directorio a un subdirectorio, por ejemplo, "AFNetworking" -> "ext / AFNetworking". Estos son los pasos que seguí:

1. Edite .gitmodules cambiando el nombre y la ruta del submódulo para que sea "ext / AFNetworking"
2. Mueva el directorio git del submódulo de ".git / modules / AFNetworking" a ".git / modules / ext / AFNetworking"
3. Mover biblioteca de "AFNetworking" a "ext / AFNetworking"
4. Edite ".git / modules / ext / AFNetworking / config" y arregle la [core] worktreelínea. La mía cambió de ../../../AFNetworkinga../../../../ext/AFNetworking
5. Edite "ext / AFNetworking / .git" y corríjalo gitdir. La mía cambió de ../.git/modules/AFNetworkinga../../git/modules/ext/AFNetworking
6. git add .gitmodules
7. git rm --cached AFNetworking
8. git submodule add -f <url> ext/AFNetworking

Finalmente, vi en el estado de 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 voila. El ejemplo anterior no cambia la profundidad del directorio, lo que hace una gran diferencia en la complejidad de la tarea, y no cambia el nombre del submódulo (que puede no ser realmente necesario, pero lo hice para ser coherente con lo que sucedería si agregara un nuevo módulo en esa ruta).

[Actualización: 26/11/2014] Como Yar resume muy bien a continuación, antes de hacer nada, asegúrese de conocer la URL del submódulo. Si se desconoce, abra .git/.gitmodulesy examine la llave submodule.<name>.url.

Lo que funcionó para mí fue eliminar el submódulo anterior usando git submodule deinit <submodule>seguido de git rm <submodule-folder>. Luego agregue el submódulo nuevamente con el nuevo nombre de carpeta y confirme. Al verificar el estado de git antes de confirmar, se muestra el submódulo antiguo renombrado al nuevo nombre y se modificó .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"

El truco parece ser comprender que el .gitdirectorio para submódulos ahora se mantiene en el repositorio maestro, debajo .git/modules, y cada submódulo tiene un .gitarchivo que apunta a él. Este es el procedimiento que necesita ahora:

• Mueva el submódulo a su nuevo hogar.
• Edite el .gitarchivo en el directorio de trabajo del submódulo y modifique la ruta que contiene para que apunte al directorio correcto en el directorio del repositorio maestro .git/modules.
• Ingrese el .git/modulesdirectorio del repositorio principal y busque el directorio correspondiente a su submódulo.
• Edite el configarchivo, actualizando la worktreeruta para que apunte a la nueva ubicación del directorio de trabajo del submódulo.
• Edite el .gitmodulesarchivo en la raíz del repositorio principal, actualizando la ruta al directorio de trabajo del submódulo.
• git add -u
• git add <parent-of-new-submodule-directory>(Es importante que agregue el padre , y no el directorio del submódulo en sí).

Algunas notas

• Las [submodule "submodule-name"]líneas .gitmodulesy .git/configdeben coincidir entre sí, pero no corresponden a nada más.
• El directorio de trabajo del submódulo y el .gitdirectorio deben apuntar correctamente entre sí.
• Los archivos .gitmodulesy .git/configdeben estar sincronizados.

La cadena entre comillas después de "[submódulo" no importa. Puede cambiarlo a "foobar" si lo desea. Se utiliza para encontrar la entrada coincidente en ".git / config".

Por lo tanto, si realiza el cambio antes de ejecutar "git submodule init", funcionará bien. Si realiza el cambio (o recoge el cambio mediante una combinación), deberá editar manualmente .git / config o ejecutar "git submodule init" nuevamente. Si haces lo último, te quedará una entrada inofensiva "varada" con el nombre anterior en .git / config.

Simplemente puede agregar un nuevo submódulo y eliminar el antiguo submódulo usando comandos estándar. (debería evitar cualquier error accidental dentro de .git)

Configuración de ejemplo:

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>

Examine mover 'jquery' a 'proveedor / 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étodo de bonificación para submódulos grandes:

Si el submódulo es grande y prefiere no esperar al clon, puede crear el nuevo submódulo utilizando el antiguo como origen y luego cambiar el origen.

Ejemplo (use la misma configuración de ejemplo)

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 solución dada no funcionó para mí, sin embargo, una versión similar sí ...

Esto es con un repositorio clonado, por lo tanto, los repositorios de submódulos git están contenidos en los repositorios superiores .git dir. Todos los cationes son del repositorio superior:

1. Edite .gitmodules y cambie la configuración "ruta =" para el submódulo en cuestión. (No es necesario cambiar la etiqueta ni agregar este archivo al índice).

2. Edite .git / modules / name / config y cambie la configuración "worktree =" para el submódulo en cuestión

3. correr:

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

Me pregunto si hace una diferencia si los repositorios son atómicos o submódulos relativos, en mi caso fue relativo (submodule / .git es una referencia al proyecto superior / .git / modules / submodule)

Simplemente use el script de shell git-submodule-move .

Acabo de pasar por esta prueba ayer y esta respuesta funcionó perfectamente. Aquí están mis pasos, para mayor claridad:

1. Asegúrese de que el submódulo esté registrado y enviado a su servidor. También necesita saber en qué rama está.
2. ¡Necesitas la URL de tu submódulo! Úselo more .gitmodulesporque una vez que elimine el submódulo no estará disponible
3. Ahora puedes usar deinit, rmy luegosubmodule add

EJEMPLO

• El submódulo de Git está en: Clases / lib / mustIReally
• Pasando a: lib / AudioBus
• URL: http://developer.audiob.us/download/SDK.git

Comandos

    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 

NOTA: git mv no hace esto. En absoluto.