Operaciones comunes con Git

Crear un proyecto

Empezar un repositorio recién creado

git clone git@gitlab.com:manuelcillero/proyecto.git
cd proyecto
touch README.md
git add README.md
git commit -m "Inicia el repositorio"
git push -u origin master

Enviar una carpeta ya existente

cd carpeta_existente
git init
git remote add origin git@gitlab.com:manuelcillero/proyecto.git
git add .
git commit -m "Inicia el repositorio"
git push -u origin master

Enviar un repositorio Git existente

cd repositorio_existente
git remote rename origin old-origin
git remote add origin git@gitlab.com:manuelcillero/proyecto.git
git push -u origin --all
git push -u origin --tags

Configuración global de Git

git config --global user.name "Nombre De Usuario"
git config --global user.email "correo@ejemplo.com"

Renombrar rama en repositorio local y remoto

Para renombrar una rama local desde cualquier otra:

git branch -m nombre_anterior nombre_nuevo

Aunque es más seguro activar la rama (puede ser útil el comando git branch --list para listar todas las ramas locales) y luego renombrarla:

git checkout nombre_anterior              # Activa la rama local a la que cambiar el nombre
git branch -m nombre_nuevo                # Renombra la rama local

Si está en el repositorio remoto entonces se complica un poco. De hecho, no es directamente posible. En la práctica se realiza eliminando la rama anterior y enviando la nueva rama:

git push origin --delete nombre_anterior  # Elimina la rama remota con el nombre anterior
git push origin -u nombre_nuevo           # Envía la rama local con el nuevo nombre

Para verificar el cambio podemos listar todas las ramas (locales y remotas) con git branch -a.

Incluir proyectos Git como submódulos

Los submódulos permiten mantener un repositorio Git como un subdirectorio de otro repositorio Git. Por ejemplo, si estamos trabajando en un proyecto que requiere una biblioteca que se está desarrollando separadamente, podremos integrarla y mantenerla actualizada o, incluso, participar en su desarrollo al margen del proyecto principal.

Para incluir un repositorio como submódulo hay que acceder al directorio del proyecto principal y ejecutar:

cd carpeta_proyecto
git submodule add git@gitlab.com:manuelcillero/submodulo.git carpeta_submodulo

siendo el último argumento opcional (permite usar otro nombre para el directorio del submódulo en la carpeta del proyecto principal).

Para facilitar la operación es importante que el repositorio del submódulo no esté vacío antes de añadirlo.