Hace unos momentos me encontraba creando esta pequeña guía de como utilizar la combinación git y en particular con Github, esta es una guía en su primer parte y en su primer edición, tratare de ir mejorarndo así como de agregar más ejemplos, imagenes y casos en particular, ahora bien, esta es una guía rapida para empezar a utilizar este administrador de control de versiones, pero ya da por hecho que se encuentra instalado git y que ya cuentas con una cuenta en github espero este sea de gran utilidad, todos los comentarios son bienvenidos.
Primero que nada es detallar y configurar tanto Git en la maquina[s] que se tiene así como la cuenta de Github.
1.- En el terminal editar la siguiente información:
$ git config—global user.name “Tu nombre”
$ git config—global user.email “Tu email”
2.- El siguiente paso si es que no se ha realizado ya, es registrar la maquina en relación a github y tu llave de SSH, para realizar esto, seguir la siguiente liga:
http://github.com/guides/providing-your-ssh-key
3.- Configurar tu usuario de Github en tu maquina:
$ git config—global github.user tu_usuario_de_github
$ git config—global github.token 605966…este_numero_se_encuentra_en_la_seccion_de_tu cuenta y se llama API Token
4.- Paso extra en Mac y solo Mac, con esto nos aseguramos de no subir archivos tipo .DS_Store:
$ git config—global core.excludesfile ~/.gitexcludes
5.- Dentro de tu cuenta debes de tener acceso al proyecto, y tienes un link llamado Your Clone URL, copia este:
Ejemplo:: git@github.com:igmarin/spree.git
Y en tu maquina corre el comando:
$ git clone git@github.com:igmarin/spree.git
6.- Listo ya puedes acceder a tu carpeta del proyecto y realizar cambios a este.
7.- Visualización en Mac de las modificaciones al proyecto.
$ gitk—all
8.- Una ves creada una modificación, lo que debemos de hacer es guardar localmente el cambio en nuestra maquina, para posteriormente enviarla al repositorio de Github, los comandos para poder manipular de forma sencilla estos cambios son los siguientes:
Status, nos permite ver que cambios hemos hechos o que archivos hemos creado.
$ git status
Add, con este comando añadimos el cambio creado al repositorio y podemos manejarlo de dos formas:
1. Añadiendo todo lo que haya en nuestro repositorio de cambios
$ git add .
2. Añadiendo un archivo especifico.
$ git add ruta/y_nombre_del_archivo
9.- Una ves agregados los cambios, debemos de guardar estos en el repositorio local con el fin de no solo tener un guardado en Github sino de también en nuestra propia maquina y esto lo hacemos con:
$ git commit -am “El mensaje con el cual se identifica lo que se esta guardando”
10. Guardar en Github, para mandar nuestro código en el repositorio central usamos el siguiente comando:
$git push origin master
(Nota: cuando trabajamos en un proyecto grupal y una ves que mandamos nuestros cambios, debemos de notificar de nuestros cambios al master del proyecto y esto se hace en github seleccionando la opción pull request con lo cual seleccionamos a la persona a la cual queremos notificar y añadimos una nota de los cambios para más fácil lectura de estos cambios).
11. Actualización de nuestra copia local.
$ git pull
Trabajando con Branches (Ramificaciones)
1.- El concepto más importante dentro de Git es el de branch, ya con esto nosotros podemos crear ciertas funcionalidades las cuales quizás estemos desarrollando como prueba o bien en un estado posiblemente experimental pero que pueden ser parte de nuestro proyecto o bien, para tener un orden de trabajo sobre lo que se va agregando en nuestro proyecto.
Por default Git, trabaja con el branch master que es el branch principal de desarrollo, el comando para verificar los branches en nuestro proyecto es:
$ git branch
2.- Crear un branch, para crear un branch solamente debemos de ejecutar:
$ git branch el_nombre_del_branch
Y para utilizar este nuevo branch:
$ git checkout el_nombre_del_branch
De igual forma podemos trabajar y realizar los pasos 8 y 9 para manipular nuestro proyecto.
Una ves finalizado el desarrollo en el branch que estemos trabajando y para guardar estos cambios en Github, ejecutamos el siguiente comando:
$ git push origin el_nombre_del_branch
Una ves realizado esto, podemos verificar en Github en la sección de all branches, que se ha guardado y que cambios se han hecho, incluso localmente la forma gráfica de verlos sería ejecutando el comando:
$ gitk
3.- Para poder agregar estos cambios al Branch master, debemos de hacer lo siguiente:
$ git checkout master
y claro podemos verificar que hemos vuelto a master con:
$ git branch
e incluso a nivel terminal verificar que cambios existen en relación a master con el comando:
$ git diff master el_nombre_del_branch
Una ves convencidos de estos cambios ejecutamos el siguiente comando para realizar la fusión de el branch creado desde branch master con:
$ git merge el_nombre_del_branch
(Nuevamente para enviar ya la unión del branch creado con master ejecutamos)
$ git add .
$ git commit -am “Con su respectivo mensaje”
$ git push origin master
4.- Borrando un branch, una ves convencidos de que lo que realizamos ya fue agregado al branch master y no vamos a seguir trabajando en ese branch ejecutamos.
$ git branch -d el_nombre_del_branch
Ahora bien para borrar este branch de github lo hacemos con:
$ git push origin :el_nombre_del_branch
5.- Regresar a un estado anterior a la fusión, para realizar esto, ejecutamos lo siguiente:
$ git reset—hard ORIG_HEAD
Manejo de colaboradores del proyecto
Para dar de alta colaboradores dentro de un proyecto en Github, solamente debemos de hacer lo siguiente, dentro del proyecto en la sección de Admin, seleccionar la opción de Repository Collaborators y buscar por nick al nuevo colaborador de nuestro proyecto.
