Crear un proyecto en GitHub

By: Javier on 6/02/2012

GitHub es un excelente gestor de proyectos gracias a git, el controlador de versiones que emplea a bajo nivel. En los últimos tiempos se dio mucho a conocer y la verdad es que si vas a desarrollar algo y necesitas tener una copia en la nube, ¿por qué no usarlo?

Hace unos cuantos post's vimos cómo funcionaba git para control local o subir a repositorios remotos, pero siempre conocidos y controlados. Ahora vamos a ver cómo poder unir de forma fácil y simple git + GitHub.

• Registro de clave SSH en GitHub
  
  Para comenzar, vamos a crear una clave RSA de ssh para autenticar nuestro equipo contra GibHub. Para ello,

  shell> cd ~/.ssh
  shell> ssh-keygen -t rsa -C "user@empresa.com"
  

  Una vez generada, vamos al menú "Account Settings" y en la opción "SSH Keys/Add SSH key" añadimos el contenido de nuestra clave pública (~/.ssh/id_rsa.pub). Una vez subida, podemos verificar su correcto funcionamiento al intentar conectarnos por ssh a GitHub. 

  shell> ssh -T user@github.com
  Hi username! You've successfully authenticated, but GitHub does not provide shell access.
  

• Configurar nombre y e-mail
  
  Vamos a configurar el nombre de nuestro usuario de GitHub y el correo electrónico.

  shell> git config --global user.name "USER NAME"
  shell> git config --global user.email "user@empresa.com"

• Configurar el token de GitHub
  
  Este token no es más que un método para permitir el acceso a ciertas herramientas que no sean ssh al repositorio remoto. Para obtener dicho código vamos al menú de "Account Settings" y en la opción "Account Settings" copiamos el valor de "Your API token is".
  Una vez lo tenemos, configuramos nuestro git local para que identifique contra GitHub correctamente. Para ello,

  shell> git config --global github.user "USER NAME"
  shell> git config --global github.token TOKEN

• Creamos un nuevo proyecto en GitHub
  
• Inicializar repositorio local
  
  Para comenzar a trabajar con GitHub primero tenemos que crear un directorio local en nuestra máquina que luego se sincronizará con el remoto.

  shell> mkdir ~/PROY_1
  shell> cd ~/PROY_1
  

  Ahora, dentro de esta nueva carpeta de proyecto, inicializamos un nuevo repositoio git, tal como sigue.

  shell> git init
  

   En este punto, el repositorio únicamente es local y no se sincroniza con repositorios remotos.
• Agregar descripción del proyecto
  
  Este es un paso altamente recomendable, aunque no estricto en GitHub. Especialmente si tu proyecto va a quedar libre, es necesario agregar una pequeña descripción de qué va, para que la gente lo pueda leer y entender. Para ello, creamos dentro de la carpeta del proyecto, el fichero README.

  shell> vi README
  

  Ahora, añadimos dicho fichero al proyecto y realizamos nuestro primer commit. Este todavía sigue siendo local. Hay que recordar que git trabaja en local y luego sincroniza a remoto.

  shell> git add README
  shell> git commit -m 'first commit'

• Agregar ficheros al proyecto
  
  Esta es la parte más importante, ya que es sobre la que se hará el trabajo día a día. Dentro de la carpeta de nuestro proyecto, crearemos el código, las imágenes, los ficheros de configuración, etc. Todo lo que queramos y cada vez que añadamos algo nuevo, habrá que ejecutar estas opciones. La primera es para añadir los ficheros y la segunda es para realizar un commit.

  shell> git add .
  shell> git commit -m 'last change log'
  

  En caso de que no queramos añadir todas las carpetas y ficheros del proyecto a git, podemos pasarle de una en una.
  El número de commit's que se realicen dependerá del programador, pero cada nueva funcionalidad importante o cada parche aplicado es una buena opción, para así poder tener unos buenos métodos de trazado.
• Subir modificaciones a GitHub
  
  Esta es la parte más importante, ya que hasta aquí todo el como trabajar con git, del que recordemos, ya hemos hablado en alguna ocasión. Así que ahora vamos a ver cómo poder sincronizar nuestro repositorio local, con el repositorio remoto de GitHub.
• Asociar local con remoto
  
  Con la siguiente ejecución asociamos nuestro repositorio local al remoto de GitHub. Hay que establecer los nombres de usuario y del proyecto correctamente. En mi caso USER y PROY_1.

  shell> git remote add origin git@github.com:USER/PROY_1.git

• Sincronizar repositorios
  
  Y ahora simplemente sincronizamos todo el contenido local y remoto gracias a git. Esto lo tendremos que hacer cada vez que queramos publicar o subir algo nuevo.

  shell> git push -u origin master
  

Una vez tengamos la cuenta de GitHub creada y sincronizada, se podrán ver los archivos del proyecto en la siguiente URL: https://github.com/USER/PROY_1