- ¿Por qué integrar un proyecto existente en un repositorio Git?
- Escenario 1: el repositorio Git todavía está vacío
- Paso 1: acceder al directorio del proyecto
- Paso 2: inicializar Git
- Paso 3: añadir los archivos
- Paso 4: crear el primer commit
- Paso 5: conectar el repositorio remoto
- Paso 6: crear o cambiar el nombre de la rama
- Paso 7: subir los archivos
- Escenario 2: el repositorio ya contiene archivos, como README o .gitignore
- Paso 1: cambiar el nombre de la carpeta del proyecto
- Paso 2: clonar el repositorio
- Paso 3: copiar los archivos antiguos al repositorio nuevo
- Paso 4: añadir los archivos a Git
- Paso 5: crear el commit
- Paso 6: subir los cambios
- Resumen de comandos importantes de Git y Linux
- Cómo escribir correctamente los mensajes de commit
- Consejos para buenos mensajes de commit
- Ejemplos
- ¿Qué son los Gitmojis?
- Consejos, trucos y buenas prácticas
- FAQ
- Glosario
Muchos desarrolladores conocen esta situación: una web, un proyecto de WordPress o una aplicación existe desde hace meses en un servidor o en el ordenador local, pero nunca se ha versionado con Git. Cuando los cambios empiezan a ser difíciles de seguir o varias personas colaboran, resulta conveniente crear un repositorio Git. En este artículo te explico paso a paso cómo subir un proyecto existente a GitHub o GitLab y qué comandos de Git y Linux necesitas. También encontrarás buenas prácticas, consejos para mensajes de commit, una introducción a Gitmoji, preguntas frecuentes y un glosario.
¿Por qué integrar un proyecto existente en un repositorio Git?
El control de versiones es una parte importante del desarrollo de software mono. Git permite gestionar el código de forma controlada, incluso en proyectos que comenzaron sin Git. Un repositorio central en GitHub o GitLab ofrece estas ventajas:
- Control de versiones seguro
- Posibilidad de deshacer errores
- Cambios fáciles de rastrear
- Trabajo en equipo estructurado
- Automatización de pruebas o despliegues
- Copias de seguridad organizadas
Los proyectos web como WordPress, Node.js, Laravel o los sitios estáticos se benefician especialmente de Git.
Escenario 1: el repositorio Git todavía está vacío
Si tu repositorio de GitHub o GitLab todavía no contiene archivos, puedes comenzar directamente en la carpeta del proyecto existente.
Paso 1: acceder al directorio del proyecto
cd /pfad/zu/deinem/projekt
Paso 2: inicializar Git
git init
Paso 3: añadir los archivos
git add -A
Paso 4: crear el primer commit
git commit -m "Initial commit - bestehendes Projekt"
Paso 5: conectar el repositorio remoto
git remote add origin https://github.com/user/projekt.git
# oder:
git remote add origin https://gitlab.com/user/projekt.git
Paso 6: crear o cambiar el nombre de la rama
git branch -M main
Paso 7: subir los archivos
git push -u origin main
Todo el proyecto existente estará ahora dentro del repositorio.
Escenario 2: el repositorio ya contiene archivos, como README o .gitignore
Muchos repositorios de GitHub y GitLab ya contienen archivos como README.md o configuraciones de ejemplo. En ese caso, resulta más sencillo clonar primero el repositorio.
Paso 1: cambiar el nombre de la carpeta del proyecto
mv projekt projekt.bkp
Paso 2: clonar el repositorio
git clone https://github.com/user/projekt.git projekt
o
git clone https://gitlab.com/user/projekt.git projekt
Paso 3: copiar los archivos antiguos al repositorio nuevo
cp -a projekt.bkp/. projekt/
Paso 4: añadir los archivos a Git
cd projekt
git add -A
Paso 5: crear el commit
git commit -m "Import bestehendes Projekt"
Paso 6: subir los cambios
git push -u origin main
Resumen de comandos importantes de Git y Linux
| Tarea | Comando | Descripción |
|---|---|---|
| Crear un repositorio Git | git init | Crea un repositorio Git nuevo |
| Añadir archivos | git add -A | Añade todos los archivos al índice |
| Guardar un commit | git commit -m «Text» | Crea una versión de los cambios |
| Conectar el remote | git remote add origin URL | Vincula el repositorio local con el remoto |
| Clonar el repositorio | git clone URL | Descarga un repositorio remoto |
| Establecer la rama | git branch -M main | Crea o establece la rama main |
| Hacer push | git push -u origin main | Transfiere el código al remote |
| Copiar una carpeta | cp -a alt/. neu/ | Copia archivos con sus permisos |
| Cambiar el nombre de una carpeta | mv alt neu | Cambia el nombre de archivos o directorios |
Cómo escribir correctamente los mensajes de commit
Los buenos mensajes de commit hacen que el historial sea claro y comprensible. Utilizar una estructura limpia se considera una buena práctica.
Consejos para buenos mensajes de commit
- Escribe en imperativo: « Add », « Fix », « Update »
- Mantén el mensaje breve y comprensible
- Añade explicaciones opcionales en una segunda línea cuando sea necesario
- Evita términos imprecisos como « Update », « Fixes » o « Cambio »
Ejemplos
- Add initial project structure
- Fix menu alignment on mobile
- Update dependencies
- Remove deprecated plugin
¿Qué son los Gitmojis?
Gitmoji es un proyecto comunitario que proporciona emojis para los mensajes de commit. Permiten reconocer de un vistazo qué hace cada commit.
| Emoji | Significado |
|---|---|
| 🎉 (:tada:) | Inicio del proyecto |
| 🐛(:bug:) | Corrección de errores |
| ✨(:sparkles:) | Nueva función |
| 🔧(:wrench:) | Cambios de configuración |
| 🔥(:fire:) | Elimina código o archivos |
| 📝(:memo:) | Documentación |
Estas incorporaciones son opcionales, pero suelen hacer que el historial de commits resulte más claro y mono.
Consejos, trucos y buenas prácticas
Algunos consejos probados para versionar proyectos existentes:
- Utiliza siempre un archivo
.gitignorepara excluir archivos innecesarios - No rastrees carpetas grandes de subidas ni directorios de caché
- Trabaja con ramas para las funciones nuevas
- Realiza pequeños commits periódicos en lugar de enormes commits conjuntos
- Utiliza claves SSH con GitHub o GitLab para trabajar con mayor comodidad
- Antes de cada push, comprueba con
git statusque todo sea correcto
FAQ
¿Puedo utilizar Git para cualquier proyecto?
Sí. Git es adecuado para webs, bases de datos, scripts, copias de seguridad, aplicaciones web y mucho más.
¿Debo versionar imágenes y archivos subidos?
No. Normalmente deben almacenarse en el espacio web o en un CDN, no en el repositorio.
¿Qué hago si aparecen conflictos?
Git marca las zonas afectadas, que deben corregirse manualmente.
¿Puedo utilizar varios repositorios remotos?
Sí. Un proyecto puede tener varios remotes, por ejemplo GitHub y GitLab al mismo tiempo.
Glosario
Repositorio Git
Estructura de proyecto central o local que guarda versiones.
GitHub / GitLab
Plataformas para alojar repositorios Git.
Commit
Cambio guardado con un mensaje.
Push
Transfiere los cambios locales al repositorio remoto.
Clone
Descarga un repositorio existente.
Rama
Línea de desarrollo paralela para funciones nuevas.
Índice
Área de preparación entre la carpeta de trabajo y el commit.
Este artículo ha sido traducido con ayuda de IA.