GitHub. Ejemplo de uso.
GitHub es una plataforma en la nube que te permite como usuario alojar proyectos a través de un sistema de control de versiones Git. El código puede almacenarse de manera privada o pública aunque normalmente está abierto. El objetivo de esta red es poder compartir tus proyectos con el objetivo que otros desarrolladores puedan trabajar en conjunto reparando bugs o implementando nuevas funcionalidades.
Yo, personalmente, soy un apasionado de utilizar Git ya que considero que es el software de control de versiones mejor diseñado del momento. Realmente, desde el principio que lo utilice, note la herramienta muy eficiente, confiable y me permitió trabajar con un gran número de archivos. Su propósito es llevar registro de los cambios aplicados en un proyecto y poder coordinar el trabajo que varias personas sobre los archivos compartidos en un repositorio de código.
Ejemplo de uso. Creación de un proyecto en GitHub
Para exponer sus beneficios, he decidido poner una serie de comandos básicos que os van ayudar a tomar la decisión de utilizar esta herramienta.
Partiendo desde la consideración que seguramente ya estas registrado en la web https://github.com/, el primer paso es crear un nuevo repositorio y rellenar la siguiente imagen
Subir el proyecto a Github
Utilizaremos el propio Git para subir el proyecto a nuestro repositorios Github. Ten en cuenta que el si estás en Linux o Mac usarás el terminal del propio sistema operativo, pero si estás en Windows usarás "Git Bash" que es el terminal de línea de comandos que se instala cuando instalas Git, que es mucho mejor que el terminal básico que viene con Windows.
Una vez tienes Git instalado, tienes que ir a traves del terminal a la carpeta de tu proyecto. Una vez allí generas tú repositorio en local con la orden "init". En mi caso, al utilizar un entorno de programación Pycharm, el siguiente paso es crear un fichero .gitignore con el comando touch .gitignore y añadir la carpeta .idea como excepción. EL objetivo de este comando es omitir del proyecto la carpeta .idea que no posee ningún valor
Luego, realizamos el comando "add ." para agregar todos los archivos de la carpeta (menos los ficheros incluidos en el .gitignore) y lanzamos el comando git commit -m "first commit" para almacenar el proyecto.
El código implementado hasta el momento es el siguiente:
echo "# Nombre del proyecto" >> README.md
git init
git add .
git commit -m "primer commit"
Si continuamos con nuestro objetivo, el siguiente punto es poder crear diferentes ramas para permitan el trabajo colaborativo en el proyecto. En nuestro caso, vamos a crear la rama principal la que tendrá la última versión del programa, la rama Main. Posteriormente añadimos la url dónde se almacena el proyecto y subimos toda la información con el comando push.
El código implementado en esta sección es el siguiente:
git branch -M main
git remote add origin https://github.com/usuario_github/nombre_repositorio.git
git push -u origin main
Ahora ya puedes tener la tranquilidad de poder modificar tu proyecto sabiendo que existe una copia en la nube fácilmente replicable.
Pasos adicionales recomendados en la operativa con Git
Dentro de las metodologías correctas de trabajo con git, se considera necesario poner un documento explicativo del proyecto llamado README.md
El creado por defecto realmente posee muy poca información y deseo modificarlo. Para ello, mi recomendación es crear una nueva rama a partir de la principal con el siguiente comando:
git checkout -b modificar_readme
git commit -a -m "modifico el codigo"
Una vez creada, el siguiente punto sería modificar el fichero README.md. Terminada esta tarea, el siguiente punto es replicar los cambios de la rama modificar_readme a la rama Main con la ejecución de los siguientes comandos:
git checkout main
git merge modificar_readme
Actualizando 76656d5..2523a89
Fast-forward
README.md | 47 ++++++++++++++++++++++++++++++++++++++++++++---
requirements.txt | 1 +
2 files changed, 45 insertions(+), 3 deletions(-)
create mode 100644 requirements.txt
git push
Cómo se puede observar, el proceso termina con un push, es decir, con un volcado en la nube de nuestro proyecto
El resultado de esta modificaión es un archivo README.md nuevo, que cumple la sintaxis Markdown y que podéis consultar en la siguiente url https://github.com/al118345/envio_email
Por último, y si te has equivocado o quieres borrar todo el trabajo realizado, siempre tienes la opción de eliminar la carpeta .git con todo el contenido.
sudo rm -r .git