Ya hemos hablado en nuestro Blog sobre Git, incluso aprendimos a instalarlo en nuestras computadoras. Puedes consultar este contenido en este enlace: Instalando y Configurando Git en Windows, Linux y Mac
Otro tema relacionado con Git es GitHub. Pero, ¿qué es GitHub? ¿Es lo mismo que Git? Responderemos a estas preguntas en este artículo.
¿Qué es GitHub?
Lo primero importante que siempre debemos recordar es que GitHub no es lo mismo que Git. Como aprendimos en otro artículo, Git es un sistema de control de versiones que gestiona nuestro código y los cambios que ocurren en él. En cambio, GitHub es una plataforma donde podemos alojar los proyectos que creamos. Esta plataforma fue creada en 2008 y hoy pertenece a Microsoft (su compra por la Gigante de Software ocurrió en 2018). Cada proyecto agregado a GitHub se almacena en un repositorio. Usamos Git para realizar la carga y descarga de los archivos de nuestro proyecto. Así vemos que GitHub no es lo mismo que Git, pero necesita de Git para existir.
GitHub, junto con StackOverflow, son considerados dos de las grandes “redes sociales de programadores”. Podemos agregar en nuestro perfil los proyectos que desarrollamos, y así toda la comunidad de desarrolladores podrá acceder a ellos. Por eso podemos decir que GitHub puede ser considerado nuestro portafolio, y muchas empresas incluso pueden preguntar cuál es nuestro perfil en GitHub al analizar una oferta de trabajo.
En este artículo aprenderemos a crear una cuenta en GitHub y también a crear nuestro primer repositorio.
Creando una cuenta en GitHub
El sitio de GitHub es github.com.
En la página de inicio veremos a nuestra derecha un formulario de registro, donde podemos informar el nombre de usuario que deseamos, nuestro correo electrónico y una contraseña. Debemos completar estos datos y hacer clic en el botón de registro, como vemos a continuación:
En la página siguiente comenzaremos nuestro proceso de registro. Veremos algún tipo de verificación, como un captcha o un pequeño juego, para confirmar que no somos robots, como vemos a continuación:
La siguiente etapa será elegir si deseamos el plan gratuito o de pago dentro de esta plataforma:
Puede que sea necesario validar tu correo electrónico usando un código que será enviado a tu Bandeja de Entrada. Después de estos pasos, nuestra cuenta en GitHub estará creada y validada con éxito!
¡Ahora podemos crear nuestro primer repositorio!
Creando un repositorio
Después de estar logueados en GitHub, veremos un botón con la imagen de un signo de más (+) en la parte superior derecha de la plataforma. Al hacer clic en él, se mostrará un menú desplegable y elegiremos la primera opción, “Nuevo repositorio”:
Seremos redirigidos a una página de creación de un repositorio. Debemos informar el nombre del repositorio que deseamos y una descripción para él. Por último, haremos clic en el botón “Crear repositorio”:
Solo un detalle: también seleccionamos la casilla para iniciar el repositorio con un archivo README. Este archivo contendrá una descripción de nuestro repositorio. Esta descripción puede ser corta y concisa. Sin embargo, si deseamos, podemos agregar más información en este archivo. Los grandes proyectos utilizan el archivo README para crear incluso una documentación del proyecto, con enlaces y tutoriales.
Después de crear nuestro repositorio, veremos la siguiente página:
Esta página representa nuestro repositorio, ya alojado en GitHub. Muy simple, ¿no crees?
Con seguridad deseamos agregar más archivos a nuestro repositorio. Podríamos editar los archivos directamente en la plataforma. Sin embargo, si nuestro proyecto se vuelve muy grande, puede volverse inviable editar los archivos solamente en el servidor. Es en este momento donde entra en escena Git. Podemos usar esta herramienta para realizar la descarga del código que está en la nube, creando un repositorio local en nuestra computadora. Luego, haremos cambios en él localmente y entonces añadiremos la nueva versión del proyecto a la nube.
Para ello, primero procederemos a descargar el repositorio. Pero, al usar Git, no usamos la expresión “realizar una descarga”, sino “realizar un clon”, ya que vamos a clonar el contenido del repositorio remoto en nuestro local. Para ello, usaremos el comando git clone e informaremos el enlace de nuestro repositorio. Podemos obtener esta información haciendo clic en “Clone or download” y eligiendo la opción de copiar:
Ahora trabajaremos con la línea de comando. Será necesario tener Git instalado para ello. Puedes acceder al artículo en el que enseñamos su instalación a través del enlace que está al inicio de este artículo.
Si lo deseas, puedes abrir tu Terminal predeterminado o Git Bash en el Escritorio. Ejecutaremos el siguiente comando:
git clone https://github.com/anthony1910/first-repository.git
Solo recordando que la dirección de tu repositorio será diferente de la mía :)
Este comando creará una carpeta llamada first-repository, que será nuestro repositorio local. Para nuestro ejemplo, crearemos un archivo llamado index.php dentro de esta carpeta. Su contenido será el siguiente:
<?php
echo 'Este archivo está en mi primer repositorio';
Este nuevo archivo representa un cambio en nuestro repositorio. Ahora necesitamos agregar esta nueva versión del proyecto al repositorio remoto. Usaremos algunos otros comandos de Git que nos ayudarán en este proceso.
El primero de ellos es git add. Añade nuestros archivos a lo que llamamos “staging area”, una expresión que puede ser traducida como “área de preparación”. Añadir archivos a esta área muestra nuestra intención de incorporarlos al repositorio remoto. Vamos a usar este comando en nuestra Terminal:
git add index.php
Ten en cuenta que informamos solo el archivo index.php. Sin embargo, en proyectos grandes tendremos muchos archivos. Para no tener que incluir uno por uno, podemos informar la opción “--all”, que añade todos los archivos al staging area de una vez:
git add --all
Después de añadir este archivo al área de preparación, necesitamos describir el cambio que acabamos de realizar, documentando que esa modificación fue hecha por nosotros. Para ello usamos el comando git commit. Este espera un parámetro llamado “-m”, que representa el mensaje de ese commit. Vamos a ejecutarlo con el comando a continuación:
git commit -m 'Primer Commit'
Ten en cuenta que es importante que nuestro mensaje esté entre comillas si contiene más de una palabra en su contenido. También es interesante notar cómo el recurso de commit puede ser útil para nosotros. Si hay un buen estándar para los commits y si tus mensajes son bien descriptivos, tendremos en nuestras manos un excelente sistema de registro de cambios, algo muy deseado en cualquier empresa o proyecto.
Ahora que ya hemos informado una descripción para nuestra modificación, necesitamos de hecho “subir” la nueva versión a GitHub. Usaremos el comando git push para ello. Un parámetro que espera es el nombre del remote del repositorio y el otro parámetro es el nombre de la rama que queremos enviar. Por defecto, usaremos el comando a continuación:
git push -u origin master
En este contexto “origin” es nuestro remote y “master” es nuestra rama principal. Solo un detalle: también usamos la opción “-u”, que creará una referencia de seguimiento para esta rama.
Después de ejecutar este comando veremos el siguiente resultado en nuestra Terminal:
¡Nuestro push fue exitoso, excelente!
Al ser el primer commit de nuestro proyecto no ocurrió ningún error. Sin embargo, a medida que el proyecto crezca y sufra cambios de varios miembros de nuestro equipo, podremos visualizar un error que solicitará que actualicemos nuestro repositorio local con el contenido del repositorio remoto. Para hacer esto, podemos usar el comando git pull. Tiene la misma estructura que git push:
git pull origin master
Si incluso después de ejecutar este comando el error persiste, puedes usar un comando alternativo, que explicamos en este artículo: Git: fallo al enviar los commits al repositorio remoto.
Volviendo a nuestro proyecto, ¿está realmente este nuevo archivo en nuestro GitHub? Si regresamos a la página de nuestro repositorio y la actualizamos, veremos lo siguiente:
Vemos que nuestro archivo index.php ya está en nuestro repositorio en la nube, y el mensaje de nuestro commit también está en GitHub. Muy bien, ¡todo salió bien!
Este es el proceso que usamos para mantener nuestro proyecto siempre actualizado.
Con esto ahora podemos crear nuestros propios proyectos o contribuir a proyectos de código abierto. Como mencionamos al principio, esto puede ser nuestro portafolio personal.
¿Te gustaría leer más sobre Git y GitHub en nuestro Blog? ¿O hay algún otro tema que te gustaría que tratáramos aquí? Puedes enviar tus sugerencias haciendo clic en este enlace: Sugerencias
Hasta el próximo artículo :)