= git submodulos
{{tag>git}}
== clonar incluyendo submódulos
<code bash; v2.13+>git clone --recurse-submodules -j8 <url-git></code>
<code bash; v2.8-v2.12>git clone --recursive -j8 <url-git>
# -j8 solo disponible a partir de la 2.8</code>
<code bash; v2.8->git clone --recursive <url-git></code>

si el repositorio ya estaba clonado:<code bash>git clone <url-git>
cd <path-git-submodule>
git submodule update --init --recursive</code>

== incluir en nuestro proyecto
  * añadir submódulo : <code bash>git submodule add <URL-REPO-GIT> <path></code>
    * después de añadir el submódulo, se procede como un commit normal
  * inicializar submódulo : <code bash>git submodule init</code>
  * actualizar submódulo : <code bash>git submodule update</code>
    * después de esto, el repositorio que configura el submódulo está en HEADLESS (sin rama especificada)
    * se debe:<code bash>cd <path_submodulo>
git checkout <rama>
git pull
# después tendremos que añadir los cambios
cd ${GIT_REPO_HOME}
git add <path_submodulo>
</code>
  * eliminar submódulo:
    * no existe aún comando para hacerlo
    * eliminar las referencias **[submodule "..."]** en **.gitmodules**
    * eliminar las referencias en **.git/config** <- se crean referencias si se ha ejecutado **git submodule init**
    * eliminar los directorios (sin la barra final): <code bash>git rm --cached <path></code>

/via: [[https://chrisjean.com/git-submodules-adding-using-removing-and-updating/]]\\
/via: [[https://stackoverflow.com/questions/3796927/how-to-git-clone-including-submodules]]