martes, 20 de marzo de 2012

Usando github

Antes que nada voy a comentar un poco que es github. Es un lugar para alojar nuestros proyectos utilizando el sistema de control de versiones Git, desarrollado por Linus Torvalds. Podemos permitir que varios desarrolladores estén trabajando en un mismo proyecto, ver los cambios que se produjeron en cada archivo, incluso permite que sigamos a ciertos usuarios.

La página de github es http://github.com. Lo primero que debemos realizar antes que nada, es registrarnos. No voy a comentar como se hace eso porque es fácil.

Una vez que tengamos un usuario en github, tendremos que instalar las herramientas necesarios en nuestro sistema para acceder al repositorio. Soy usuario de Ubuntu, así que los pasos que explique aquí para instalar las herramientas serán para dicho sistema operativo.

Abramos una terminal y mediante apt-get instalemos git-core, git-gui y git-doc:
sudo apt-get install git-core git-gui git-doc

Tendremos que generar una clave SSH para conectarnos al servidor, esto si no tenemos una generada. Para hacerlo tenemos que ejecutar lo siguiente en la terminal:
ssh-keygen -t rsa -C "tu-email@tuemail.com"

Cuando genera la clave SSH nos indica el directorio en donde la guardo. En mi caso la genero en /root/.ssh/id_rsa.pub. Hacemos:
cat /root/.ssh/id_rsa.pub

Copiamos todo lo que nos devuelve y nos vamos a la página de github. Le damos click en la sección Account Settings que seria la opción del medio.


En el panel izquierdo veremos una opción que dice SSH Keys, ingresamos allí y colocamos la clave SSH que acabamos de generar.

Si en una terminal ejecutamos el comando ssh -T git@github.com tendría que conectarse correctamente al servidor.

Configuramos unos datos que serán necesarios cuando hacemos los commit.
git config --global user.name "NombreDeUsuario"
git config --global user.email "tu-email@tuemail.com"

Listo, con esto tendremos configurado git para cuando nos conectemos a github.

Crear un repositorio
Deberemos crear un repositorio en github para guardar nuestro proyecto. Podemos tener dos tipos de repositorios:
-Público: todos pueden ver nuestro proyecto y descargarlo.
-Privado: solo nosotros podemos acceder a este repositorio. Obviamente es una opción que solo podemos acceder pagando.

Para nuestro aprendizaje vamos a utilizar un repositorio público. Vamos a la página de github, ingresamos con nuestros datos, en la parte inferior podemos ver los repositorios que tenemos y un botón que dice New repository, le damos click y podremos ingresar los datos de nuestro repositorio público.

Una vez creado el repositorio tenemos que usar git para acceder al mismo y subir nuestros archivos.

Suponiendo que no tienen todavía ninguna carpeta con su proyecto, vamos a comenzar creando la carpeta.
mkdir NuevaCarpeta
cd NuevaCarpeta

Estamos ahora dentro de NuevaCarpeta, vamos a iniciar git:
git init

Es recomendable crear un archivo README para comentar de que va nuestro proyecto, cambios, problemas, etc.
touch README (este comando solo crea README, pueden modificarlo con algun editor de texto)

Tenemos que indicarle a git que agregamos un archivo nuevo, en este caso README:
git add README

Luego realizamos el commit del archivo agregado:
git commit -m 'Se agregó el archivo README'

Una vez hecho esto, tendremos que enlazar nuestro directorio local con el directorio remoto:
git remote add origin git@github.com:nombreDeUsuario/repositorio.git
git push -u origin master

Listo! Con esto tenemos completamente enlazado y configurado nuestro directorio local con el repositorio en github. Si vamos a nuestra cuenta veremos que en nuestro repositorio se encuentra el archivo README que recien subimos.

Y después?
La herramienta git tiene muchísimas funciones, es casi imposible memorizar todas, pero sí podemos ir aprendiendo como usar las más comunes.
Cuando modifiquen algún archivo o lo creen, tendrán que hacer un commit y un push para colocar esos cambios en el repositorio. Les voy a explicar como hacer eso, es muy simple.

Si creamos un nuevo archivo, tenemos que agregarlo con:
git add NuevoArchivo

Si modificamos algunos archivos, podemos ver con git checkout cuales son los modificados.

El commit es indicar que queremos hacer un cambio. Si nosotros agregamos nuevos archivos solo debemos hacer:
git commit -m 'Comentarios'

En cambio, si también algunos archivos fueron modificados, debemos hacer:
git commit -a -m 'Comentarios'

Por último debemos darle el toque final con push:
git push

Si se ejecuta correctamente, entonces todos los cambios que indicamos serán aplicados a nuestro repositorio en github.

Conclusión
Github es muy potente, tiene miles de funciones, nos permitirá ser más productivos en nuestros desarrollos. Personalmente, me gustó, pero tengo que admitir que me falta muchísimo por aprender sobre esta herramienta, así que es muy seguro que haga otras publicaciones para explicar como utilizar ciertas funciones. Espero que el artículo les haya servido para iniciarse con github. En la página tienen un centro de ayuda donde explican como usar el servicio.

Hace mucho que no publicaba. La universidad me consume mucho tiempo, si bien gracias a mi dedicación voy llevándole al día, es muy difícil dedicarme a proyectos personales como mi blog.



No hay comentarios: