Crónicas de un ElePHPante

Hola de nuevo. Tras unos días sin comentaros nada interesante, me dispongo a resumir en estas líneas como comenzar a usar GitHub. Quiero aprovechar este espacio para dedicarle este post a los fundadores de Cadiz Developers: @oldlastma y @drwaky, así como a Loba Sofware por cedernos amablemente sus instalaciones.

Este manual está pensado para usuarios de Linux, en concreto Ubuntu. De todas formas aunque los comandos no sean los mismos, puede dar una idea de cómo debemos proceder en cualquier otro sistema operativo. Para ello, configuraremos nuestro usuario, generaremos nuestra clave SSH, generaremos un repositorio nuevo, y por último lo sincronizaremos en local y lo actualizaremos.

Si quereis simplemente usar un repositorio que ya existe, podeis avanzar aquí directamente.

Registrandose en GitHub

• En primero lugar, y aunque parezca obvio, nos debemos registrar en GitHub.
• Una vez registrados, procederemos a obtener nuestro certificado RSA. Este proceso variará según el sistema operativo que estés utilizando. La propia página de GitHub te proporciona la guía de cómo hacerlo, nosotros os explicamos aquí como hacerlo en Ubuntu.

Instalación de GIT en Ubuntu

Instalamos GIT y GITK, un gestor gráfico para ver las ramas y actualizaciones de los colaboradores.

[sourcecode]
sudo apt-get install git
sudo apt-get install gitk
[/sourcecode]

Obtención de una clave SSH

[sourcecode]
ssh-keygen -t rsa -C "youremail@youremail.com"
sudo apt-get install xclip
cat ~/.ssh/id_rsa.pub | xclip -sel clip
[/sourcecode]

Una vez tenemos nuestra clave SSH, la agregamos a nuestra cuenta de GitHub. Para ello nos vamos a configuración y en el apartado “Llaves públicas SSH” agregamos la que acabamos de obtener. Ahora ya podemos interactuar entre el repositorio remoto y el local. Comencemos entonces con la generación de un repositorio.

Generación de un repositorio en GitHub

Debes irte a la propia web de GitHub, y en tu Escritorio, verás la opción “Añadir nuevo repositorio”. Allí tienes las instrucciones, pero por si acaso, te las repetimos aquí.

Configuramos nuestros datos.

[sourcecode]
git config –global user.name "Your Name"
git config –global user.email youremail@youremail.com
[/sourcecode]

Creamos el directorio en local y generamos un fichero README, subimos el fichero al repositorio remoto y ya lo tenemos listo

[sourcecode]
mkdir [NombreRepositorio]
cd [NombreRepositorio]
git init
touch README
git add README
git commit -m ‘[Comentario]‘
git remote add origin git@github.com:[NombreUsuarioGitHub]/[NombreRepositorio].git
git push origin master
[/sourcecode]

¡Ya tenemos nuestro repo subido a GitHub y un archivo en él!

Veamos ahora qué debemos hacer si queremos usar un repositorio que ya existe en GitHub.
Clonación de un Repositorio de GitHub

Trabajar con un repositorio existente

[sourcecode]
git clone git@github.com/[NombreUsuario]/NombreRepositorio.git
[/sourcecode]

Ya tenemos descargado el código de nuestro repositorio remoto. Una vez hayamos modificado el código y queramos subir nuestros cambios, procederemos de la siguiente manera:

[sourcecode]
git add [nombre_del_fichero_modificado]
git commit -m "Comentario sobre los cambios"
git push
[/sourcecode]

Por ahora esto es todo, dejaré para otra entrega cómo crear ramas, y el trabajo con ellas. Espero que les sea de utilidad.

Un saludo a todos y gracias por vuestra atención