Cómo adicionar un proyecto de Software Libre a Gitorious

Por xtingray

Este es un pequeño articulo acerca de mi experiencia importando el código fuente de KTooN al repositorio de Gitorious.

Me prometí a mi mismo escribir esta guía, después de volverme loco buscando un procedimiento simple y corto para empezar a trabajar con GIT, teniendo en cuenta que vengo de la escuela de SVN.

Gitorious es un repositorio bastante útil para proyectos de Software Libre, usando GIT como sistema distribuido de control de versiones (DCRS en inglés). Además, es un lugar genial para intercambiar código y experiencias con una gran cantidad de programadores alrededor del mundo.

El primer paso para unirse a la fiesta es abrir una cuenta gratuita en Gitorious. El proceso de registro es muy sencillo y solo tienes que confirmarlo por correo. Eso es todo!

Como usuario registrado, puedes crear proyectos de software desde la interfaz del sitio, llenando una forma muy básica. Por cada proyecto creado, tendrás acceso automáticamente a un repositorio GIT.

Mis problemas comienzan en este punto: Cómo importar el código fuente de mi proyecto al servidor GIT de Gitorious? (Estoy asumiendo que tienes conocimientos básicos sobre GIT)

Muy bien, después de leer un montón de manuales enormes y de intentar diferentes comandos de varias maneras, encontré el procedimiento correcto y aquí está:

1. Luego de crear tu proyecto, tu repositorio es inicializado sin datos. Escoge un lugar dentro de tu sistema de archivos para empezar a jugar:
% mkdir tmp
% cd tmp

2. Ahora, solicita una copia de tu proyecto "vacío". En mi caso y para este ejemplo, su nombre es "kom":
% git clone git@gitorious.org:kom/kom.git

3. Un directorio con el nombre de tu proyecto será creado. Ingresa a él:
% cd kom/

4. Crea una rama llamada "master" en tu repositorio desde Gitorious, ejecutando:
% git remote add master git@gitorious.org:kom/kom.git

5. Copia todo el código fuente de tu proyecto en el interior de tu directorio actual:
% cp -rv /path/to/your/code/kom/* .

6. Añade los nuevos archivos a esta rama (master):
% git add .

7. Haz commit de este cambio, quiero decir, haz commit de todos los achivos que copiaste hace un minuto:
% git commit -a

8. Actualiza tu proyecto en el repositorio de Gitorious:
% git push --all

9. Si todo sale bien, entonces podrás consultar tu código desde el sitio web de Gitorious, con una vista similar a esta:
http://gitorious.org/kom/kom/trees/master

A partir de este momento, puedes empezar a trabajar en tu proyecto, haciendo cambios en el código, creando parches, ejecutando commits o lo que sea que necesites usando GIT.

Estos son recursos adicionales que podrían resultarte útiles en caso de que desees profundizar en el tema:

- http://www.kernel.org/pub/software/scm/git/docs/user-manual.html
- http://wiki.freegeek.org/index.php/Git_for_dummies

PD: Espero que este pequeño texto le salve la vida a alguien algún día XD