Acerca de las fusiones de subárboles
Habitualmente, una fusión de subárbol se usa para contener un repositorio dentro de otro repositorio. El "subrepositorio" se almacena en una carpeta del repositorio principal.
La mejor manera de explicar las fusiones de subárbol es mostrar por ejemplo. Haremos lo siguiente:
- Crear un repositorio vacío llamado
test
que represente nuestro proyecto. - Fusionar otro repositorio en él como un subárbol llamado
Spoon-Knife
. - El proyecto
test
usará ese subproyecto como si fuera parte del mismo repositorio. - Recuperar actualizaciones desde
Spoon-Knife
hacia el proyectotest
.
Configurar el repositorio vacío para una fusión de subárbol
- Abre la TerminalTerminalGit Bash.
- Crear un directorio nuevo y navegar a él.
$ mkdir test $ cd test
- Inicializar un repositorio de Git nuevo.
$ git init > Initialized empty Git repository in /Users/octocat/tmp/test/.git/
- Crear y confirmar un archivo nuevo.
$ touch .gitignore $ git add .gitignore $ git commit -m "initial commit" > [main (root-commit) 3146c2a] initial commit > 0 files changed, 0 insertions(+), 0 deletions(-) > create mode 100644 .gitignore
Agregar un nuevo repositorio como subárbol
-
Agregar una URL remota nueva que apunte a un proyecto por separado en el que estemos interesados.
$ git remote add -f spoon-knife git@github.com:octocat/Spoon-Knife.git > Updating spoon-knife > warning: no common commits > remote: Counting objects: 1732, done. > remote: Compressing objects: 100% (750/750), done. > remote: Total 1732 (delta 1086), reused 1558 (delta 967) > Receiving objects: 100% (1732/1732), 528.19 KiB | 621 KiB/s, done. > Resolving deltas: 100% (1086/1086), done. > From git://github.com/octocat/Spoon-Knife > * [new branch] main -> Spoon-Knife/main
-
Fusionar el proyecto
Spoon-Knife
en el proyecto de Git local. Esto no modifica ninguno de tus archivos localmente, pero prepara Git para el siguiente paso.Si estás usando Git 2.9 o superior:
$ git merge -s ours --no-commit --allow-unrelated-histories spoon-knife/main > Automatic merge went well; stopped before committing as requested
Si estás usando Git 2.8 o inferior:
$ git merge -s ours --no-commit spoon-knife/main > Automatic merge went well; stopped before committing as requested
-
Crear un nuevo directorio denominado spoon-knife, y copiar el historial de Git del proyecto
Spoon-Knife
en él.$ git read-tree --prefix=spoon-knife/ -u spoon-knife/main
-
Confirmar los cambios para mantenerlos seguros.
$ git commit -m "Subtree merged in spoon-knife" > [main fe0ca25] Subtree merged in spoon-knife
Aunque solo hemos agregado un subproyecto, se puede incorporar cualquier número de subproyectos en un repositorio de Git.
Sugerencia: Si creas un clon nuevo del repositorio en el futuro, no se crearán los remotos que agregaste. Deberás volver a agregarlos mediante el comando git remote add
.
Sincronizando con actualizaciones y cambios
Cuando se agrega un subproyecto, no se mantiene sincronizado automáticamente con los cambios ascendentes. Necesitarás actualizar el subproyecto con el siguiente comando:
$ git pull -s subtree remotename branchname
Para el ejemplo de más arriba, esto sería:
$ git pull -s subtree spoon-knife main