Git, GitHub y For-and-Branch Git Workflow


GIT

Antes de empezar , debemos entender a Git como el corazón de GitHub: Git es un sistema de control de versiones desarrollado por Linus Torvalds (el hombre que creó Linux).

Cuando los desarrolladores hacen un nuevo proyecto, siempre continúan haciéndole modificaciones al código. Incluso después de la puesta en marcha de los proyectos, todavía necesitan actualizar las versiones, corregir errores, agregar nuevas funciones, etc.   El sistema de control de versiones ayuda a registrar los cambios realizados al código. Aún más, registra quién realizó los cambios y puede restaurar el código borrado o modificado.No hay códigos sobrescritos ya que Git guarda varias copias en el repositorio. .

HUB

Si Git es el corazón de GitHub, entonces Hub es su alma. El hub de GitHub es lo que convierte una línea de comandos, como Git, en la red social más grande para desarrolladores.

Además de contribuir a un determinado proyecto, GitHub le permite a los usuarios socializar con personas de ideas afines. Puedes seguir a las personas y ver qué hacen o con quién se conectan.

Repository

Un repositorio o “repo” es un directorio donde se almacenan los archivos de tu proyecto. Puede estar ubicado en el almacenamiento de GitHub o en un repositorio local en tu computadora. Puedes almacenar archivos de código, imágenes, audios o todo lo relacionado con el proyecto en el repositorio.

Branch

Branch, que se traduce como rama, es una copia de su repositorio. Puede utilizar la rama cuando quiera hacer un desarrollo de forma aislada.Trabajar en una rama no afectará el repositorio central u otras ramas. Si has completado el trabajo, puedes combinar tu rama con otras ramas y con el repositorio central mediante una pull request.

Pull Request

Pull request significa que les informas a los demás que has enviado al repositorio principal el cambio que hiciste en una rama. Los colaboradores del repositorio pueden aceptar o rechazar una pull request. Una vez abierta, puede discutir y revisar su trabajo con los colaboradores.

Estos  son los pasos para crear una pull request en GitHub:

  1. Vaya al repositorio y busca el menú Branch.
  2. En el menú Branch, elija la rama que contenga su aportacion.
  3. Haga clic en el botón New pull request al lado del menú Branch.
  4. Escriba el título y la descripción de tu pull request.
  5. Pulse el botón Create pull request.

Bifurcar un repositorio

Bifurcar un repositorio significa crear un nuevo proyecto basado en el repositorio existente. En términos simples, esto significa que copia un repositorio existente, hace los cambios necesarios, almacena la nueva versión como un nuevo repositorio y llama a esto su propio proyecto.

Esta es una muy buena función que propulsa el desarrollo del proyecto. Debido a que es un proyecto totalmente nuevo, el repositorio central no se verá afectado. Si el repositorio principal es actualizado, también puedes aplicar esa actualización a tu bifurcación actual.

Sigue estos pasos para bifurcar un repositorio en GitHub:

  1. Vaya al repositorio que quiere bifurcar.
  2. Haga clic en el botón Fork

GitHub no es solo para desarrolladores

GitHub es una excelente plataforma que cambia la forma en que trabajan los desarrolladores. Sin embargo, todo aquel que quiera administrar su proyecto de manera eficiente y trabajar en colaboración también puede usar GitHub.

Si su equipo trabaja en un proyecto que necesita actualizaciones constantes y quieres hacerle un seguimiento a los cambios realizados, GitHub es adecuado para usted. Hay otras alternativas como GitLab o BitBucket, pero GitHub debería estar entre sus opciones.

 

Instalar Git con apt-get

Una forma sencilla y rápida de instalar Git es usando el administrador de paquetes apt, pero la versión que será descargada puede que sea anterior a la versión más reciente de Git.

  1. Para comenzar debemos ejecutar las actualizaciones generales del sistema operativo y sus paquetes, en el caso de Ubuntu abrimos la terminal y ejecutamos el siguiente comando:
    $ sudo apt-get update
    
  2. Luego escribimos y ejecutamos el siguiente comando en la terminal:
    $ sudo apt-get upgrade
    
  3. Git se instala con el siguiente comando:
    $ sudo apt-get install git
    
  4. Para verificar que la instalación fue exitosa y qué versión de git está instalada escribimos:

     

    $ git --version
    

 

 

Configurar Git

Lo primero que debemos hacer luego de terminar de instalar Git, es configurar nuestro perfil de Git con nuestro nombre y correo, es importante porque cada cambio que confirmemos estará asociado a esta información.

  1. Configura tu nombre de usuario con el comando que te mostramos a continuación y sustituye Nombre Apellido por tu nombre:
    git config --global user.name "Nombre Apellido"
    
  2. Configura tu correo electrónico de Git usando el siguiente comando, reemplazando el correo [email protected] por el tuyo:
    git config --global user.email [email protected]
    
  3. Si queremos validar lo que hemos configurado ejecutamos el siguiente comando y lo comprobamos:
    git config --list
    

Primeros pasos con Git usando un ejemplo 

 

Eche un vistazo al libro Pro Git 3 ] , que  es la principal fuente de información sobre Git.

Si no tiene una cuenta de GitHub, haga la guía Hello World en GitHub y cree una. Tenga en cuenta que para contribuir al proyecto PRMC se requiere una cuenta de GitHub. Observe que en la guía Hello World, la rama maestra se denomina rama principal . Por favor, cree un archivo README.md para el repositorio Hello World, como sugiere la guía.

Ahora, vamos a hacer lo mismo que hubiéramos hecho usando la interfaz web de GitHub (excepto  crear un Repo), pero ahora usando la terminal que será la interfaz más utilizada para tratar con Git.

Primero, si Git no está instalado en su host (intente ejecutar git en una terminal), instálelo con:   

sudo apt install git   

Clone (descargue) el repositorio de Hello World. Debe hacer clic en el botón “Código” (seleccione “https”, no “descargar un archivo zip”). Entonces ejecute: 

  cd hello_world 

Observe que se ha creado un nuevo directorio llamado como el nombre del repositorio en GitHub, y que dentro puede encontrar el archivo README.md escrito en Markdown .

Cree (y cambie a) una rama de funciones llamada improvement_readme . En tu terminal escriba: 

  git checkout - b better_readme   

Modifique el archivo README.md . Agregue, por ejemplo, un enlace a la guía Hello World. Utilice un editor ASCII ( nano , por ejemplo):   

nano README

 Vaya a la    la guia Hello World en n GitHub para consultar mas notas interesantes sobre el ejemplo:

https://guides.github.com/activities/hello-world/

Confirme su  modificación

  git commit -am "Providing the Hello World link"

    En su primera confirmación, se le pedirá:   

 git config --global user.email "[email protected].com"

 Por favor, ingrese dicha información.Después de la confirmación , su repositorio local está por delante de su repositorio de origen (copia en GitHub del) repositorio remoto. Esto significa que su local tiene modificaciones que el origen no tiene.

Sincronice su local y el origen usando push : 

  git push 

Tenga en cuenta que si no ha actualizado una clave SSH pública (o la clave privada correspondiente no está instalada correctamente en su computadora), el servidor de GitHub solicita su nombre de usuario y contraseña, y esto es algo que sucederá con cada inserción . Para evitar esta entrada repetitiva de su información de inicio de sesión de GitHub, debe iniciar sesión en GitHub utilizando criptografía de clave pública . Para eso, debe tener un par de claves, una pública y otra privada, y cargar la pública en GitHub.

El primer paso es verificar si ya tiene un par de claves (si está usando la distribución de Xubuntu recién instalada, obviamente no necesita verificar nada y puede ir directamente al siguiente paso). Simplemente revise su directorio $ HOME / .ssh con:  

 ls - l ~ /. ssh  

y si encuentra un par de archivos con casi el mismo nombre, y uno de  ellos termina en .pub , probablemente posea un par de claves SSH.

Creemos un par de claves (si no tienes una o si prefieres crear una nueva). Abra una terminal y escriba:  

 ssh - keygen - t rsa - b 4096 - C " your_email @ example . com "   

   utilizando la dirección de correo electrónico que proporcionó cuando creó su cuenta de GitHub. Luego, cuando se le solicite:   Introduzca un archivo en el que al guardar la clave (/ hogar / te /. Ssh / id_rsa ):         simplemente presione la tecla Enter para seleccionar dicho prefijo de salida. De lo contrario, escriba uno diferente, pero no cambie la ruta al directorio .ssh .

Ahora SSH debería solicitarle una frase de contraseña. Si escribe uno, se le pedirá cada vez que envíe sus confirmaciones a GitHub. Hay dos opciones para evitar esto:

No ingrese ninguna contraseña (simplemente presionando la tecla Enter nuevamente en el paso anterior). Esto tiene el inconveniente de que si alguien roba tus claves, podría acceder a GitHub como si estuvieras tú.

Ingrese una frase de contraseña y configure ssh-agent para que usted la envíe a GitHub. Esta opción es la preferible porque se le pedirá la contraseña solo cuando se inicie ssh-agent ( Xfce lo hace por usted).

Ahora es el momento de comprobar si ssh-agent ya se está ejecutando en su ordenador  -Esto se puede hacer con:   

ps aux | grep ssh - agent

    y en el caso de Xubuntu, debería obtener algo similar a: 

      989 ?        Ss     0:00 /usr/bin/ssh-agent /usr/bin/im-launch startxfce4
     1433 pts/0    S+     0:00 grep --color=auto ssh-agent

Esto significa que hay dos procesos en cuya descripción existe la cadena ssh-agent . La primera entrada es el proceso del agente. El segundo es el grep ejecutándose al mismo tiempo que el ps .

Si el ssh-agent no se estaba ejecutando, se puede iniciar para que se ejecute en segundo plano con:

     eval "$ (ssh-agent -s)"

   pero no necesita hacer eso en su instalación de Xubuntu, porque (recuerde) el ssh-agent del entorno de escritorio Xfce lo inicia.

Con sus llaves, ejecuta:  

 ssh - agregar ~ /. ssh / id_rsa 

y se le pedirá la contraseña.

Vaya ahora a GitHub -> Configuración -> Claves SSH y GPG -> Nueva clave SSH. Abra una terminal y escriba:  

 cat . ssh / id_rsa . pub 

y copie y pegue el contenido de dicho archivo (que termina con su dirección de correo electrónico) dentro del espacio donde puede leer ” Empieza con ‘ssh-rsa’, … “. No olvide poner un título) al par de claves.

Cuando utilice la clave por primera vez (clonando un repositorio o presionando una confirmación), el cliente SSH le advertirá que no se puede establecer la autenticidad de github.com . Esto es normal y debería suceder solo una vez. Escriba sí . Si este problema persiste, entonces podría estar sufriendo un ataque de hombre en el medio .

Revise el flujo de trabajo de Fork y Branch Git . Básicamente, este “protocolo” explica que para contribuir a un repositorio de código abierto alojado por GitHub sin pertenecer al equipo de desarrollo, debe realizar algunos pasos de git (y algunos de ellos se encuentran a continuación).

Haga una bifurcación del proyecto PRMC . Llamaremos a este repositorio el upstream , cuya URL es

 [email protected]:Sistemas-Multimedia/PRMC.git

 Esta información se puede encontrar cuando clona PRMC. Sin embargo, tenga en cuenta que la acción de clonar PRMC es una pérdida de tiempo porque no puede contribuir directamente a ella (recuerde, debe clonar su propio repositorio).

Agregar el control remoto  upstream con: 

  git remote add upstream [email protected].com:Sistemas-Multimedia/PRMC.git

   Compruebe que todo ha funcionado con:   git remoto – v  donde debería ver dos controles remotos: origin y upstream . Algo parecido a:

 

     origin   [email protected]:you_at_GitHub/PRMC.git (fetch)
     origin   [email protected]:you_at_GitHub/PRMC.git (push)
     upstream [email protected]:Sistemas-Multimedia/PRMC.git (fetch)
     upstream [email protected]:Sistemas-Multimedia/PRMC.git (push)

Para actualizar su repositorio local:

git pull upstream master

Instalación de python en Linux


Muchos proyectos que manejan elementos multimedia están escritos actualmente en Python como por ejemplo el proyecto PRMC, que es una colección de módulos de Python escritos en Python [ 3 ] ), por lo lo tanto, necesitará un intérprete y saber cómo desarrollar / ejecutar programas Python ( módulos y paquetes ). .

La mayoría de los sistemas operativos actuales basados ​​en Unix (Linux, FreeBSD y OSX) utilizan Python para ejecutar algunas de sus “tareas diarias”, lo que significa que ya hay disponible un intérprete de Python. Sin embargo, normalmente es mejor utilizar nuestro propio intérprete porque:

  1. Podemos elegir la versión de Python y los paquetes.
  2. Podemos optimizar la compilación del intérprete en función de nuestras necesidades (por ejemplo, incluyendo soporte Tk o no).
  3. Por defecto, todos los paquetes de Python se instalarán en un repositorio diferente de los paquetes del sistema, lo que facilita el aislamiento de Python del sistema / usuario y la eliminación del intérprete.

En Windows, debe instalar Python, sí o sí, desde el sitio web oficial . Sin embargo, tenga en cuenta que esta “guía” solo contempla la instalación de Python en máquinas con sistema operativo basado en Unix.

Instalación de Python.

         sudo apt-get install -y build-essential libssl-dev zlib1g-dev libbz2-dev libreadline-dev libsqlite3-dev wget curl llvm libncurses5-dev libncursesw5-dev xz-utils tk-dev libffi-dev liblzma-dev python-openssl git
         cd
         curl https://pyenv.run | bash
         cat << EOF >> ~/.bashrh
         export PATH="$HOME/.pyenv/bin:$PATH"
         eval "$(pyenv init -)"
         EOF
         source ~/.bashrc
         pyenv install -v 3.8.5
         pyenv virtualenv 3.8.5 tm

 

  • Recuerde que necesitará activarlo cuando quiera trabajar en este proyecto:   
        pyenv activate tm

 Es una buena idea agregar esto al archivo ~ / .bashrc .

  • Instale un IDE para programar con Python. Recomiendo a Thonny si no está acostumbrado a ningún otro.
     pip instalar thonny  

Recursos de programación Python.

Si ni domina Python para seguir este curso puede  seguir algún tutorial de programación de Python, como The Python Tutorial 1 ] sobre todo si se da cuenta de que el lenguaje es un revés para ti.

Si necesita comenzar con Python desde cero, una introducción a Python como este taller de YAPT 2 ] también podría ser útil. 

También puede consultar también el tutorial de Python de ZetCode .

Aquí otros enlaces interesantes sobre Python:

[1]   El tutorial de Python .

[2]   YAPT .

[3]   Sitio web de Python .

Instalar Xubuntu en un USB


La siguiente “guía” le ayuda a instalar Xubuntu en una unidad USB externa , que debe tener al menos 8GB de capacidad (la instalación mínima de Xubuntu 20.04 necesita alrededor de 5GB). También necesitará un disco USB externo temporal con al menos 4GB para arrancar desde él la imagen de instalación de Xubuntu (o para grabar un disco óptico ).

Por supuesto si tiene un ordenador con suficientes recursos (al menos 8 GB de RAM), también puedes instalar Xubuntu en una máquina virtual (VirtualBox, por ejemplo). En este caso, necesitará al menos 4 GB de RAM y 8 GB de espacio en disco a Xubuntu.

Xubuntu es un sistema operativo Linux basado en Ubuntu y desarrollado por la comunidad.

Xubuntu es un sistema operativo elegante y fácil de usar. Xubuntu incluye Xfce, que es un entorno de escritorio estable, ligero y configurable.

Es ideal para quien quiera lo mejor de sus PCs, portátiles y netbooks dándoles un aspecto moderno y obteniendo funcionalidades suficientes y eficientes para el día a día. Además, funciona bien en máquinas antiguas.

Para más información, visite el sitio web de Xubuntu.

Acerca del nombre

La «X» en Xubuntu proviene de Xfce, el ambiente de escritorio de Xubuntu. Así también la palabra «ubuntu» muestra la dependencia y el uso del núcleo de Ubuntu, que a su vez representa el núcleo filosófico del sistema operativo. Un significado aproximado de la palabra ubuntu es «humanidad hacia los demás». Para conocer más sobre la filosofía e ideales detrás de Ubuntu y Xubuntu puede ir a la página Filosofía de Ubuntu [En inglés].

Además de utilizar el núcleo de Ubuntu, Xubuntu también utiliza la infraestructura proporcionada y patrocinada por Canonical Ltd., una compañía fundada por Mark Shuttleworth.

 Instalación de Xubuntu en un pen-drive USB

Suponiendo que haya decidido usar Xubuntu 20.04 en un disco USB, estos son los pasos que debe realizar (para instalar Xubuntu en una partición de disco de su computadora, las instrucciones son casi las mismas):

  1. Descargue la imagen de instalación desde aquí .
  2. “Grabe” la unidad USB de 4GB con la imagen. Dependiendo de su sistema operativo actual, use las siguientes instrucciones para Windows , OSX , Ubuntu (y derivados) , o la consola para todos los Linux.
  3. Inicie la imagen desde el puerto USB. Este paso depende de su ordenador. La mayoría de las PC pueden elegir el dispositivo de inicio presionando la tecla F12 cuando la PC se está iniciando. En una Mac, debe mantener presionada la tecla alt cuando se está iniciando.
  4. Seleccione la opción Probar Xubuntu sin instalar .
  5. Cuando el sistema operativo se esté ejecutando, con fi gure la red.
  6. Inserte también la unidad USB de 8GB donde se instalará Xubuntu.
  7. Seleccione Instalar Xubuntu 20.04 LTS .
  8. Seleccione inglés como idioma utilizado durante la instalación y el sistema instalado. Esto le ayudará en caso de que necesite buscar información en Internet, proporcionando las descripciones de los errores en inglés.
  9. Seleccione la distribución de su teclado (probablemente español ).
  10. Abra una terminal y escriba:   df – h para ver todas las particiones de disco montadas y su capacidad. Tenga en cuenta que no se debe montar ninguna partición de / dev / sda (el disco duro) (aunque puede hacerlo, no es necesario montar ninguna partición del disco duro), la partición / dev / sdb1 (con Xubuntu image) debe montarse y, finalmente, si Thunar (el administrador de archivos predeterminado en Xubuntu) ha reconocido la primera partición de la segunda unidad USB externa , debe aparecer como / dev / sdc1. Esta partición debe desmontarse para instalar en ella Xubuntu. De todos modos, si continúa con el proceso de instalación sin desmontarlo, el instalador le pedirá que lo haga. En esta descripción, se ha supuesto que su ordenador  solo tiene un disco duro.
  11. Elija Descargar actualizaciones mientras instala Xubuntu e Instale software de terceros para gráficos y hardware Wi-Fi y formatos de medios adicionales , para tener acceso al último software disponible para Ubuntu (y sus derivados).
  12. Elija Borrar disco e instale Xubuntu . Ignore las funciones avanzadas. Espere un par de minutos
  13. Seleccione la unidad correspondiente a la unidad USB de 8 GB ( / dev / sdc ). ¡No elija / dev / sda (el disco principal de su ordenador  pues podria borrar su contenido)! Seleccione / dev / sdc !!
  14. En este punto de la instalación, debe considerar (dependiendo de la cantidad de memoria RAM instalada en su computadora y el tamaño de la unidad USB) crear una partición específica para realizar el intercambio. La regla del pulgar es crear una partición con el mismo tamaño que la RAM. Sin embargo, probablemente no pueda hacer eso en una unidad USB de 8 GB porque se necesitan al menos 5 GB para una instalación de Xubuntu. De todos modos, tenga en cuenta que este paso es opcional porque siempre puede realizar el intercambio en un archivo (un proceso un poco más lento que usar la partición dedicada). Tenga en cuenta también que PRMC requiere solo algunos MB de memoria para ejecutarse y, por lo tanto, probablemente no necesitará intercambiar ninguna página de memoria en absoluto. Si decide crear una partición de intercambio específica, haga clic en “herramienta avanzada de particionamiento” y realice las modificaciones que desee, y también verifique que el cargador de arranque ( GRUB ) esté instalado en / dev / sdc1 . Pero recuerde, todas las acciones descritas en este punto son opcionales (excepto seleccionar / dev / sdc1 para GRUB).
  15. Haga clic en Instalar ahora. Algo parecido a: Si continúa, los cambios que se enumeran a continuación se escribirán en los discos. De lo contrario, podrá realizar más cambios manualmente. ADVERTENCIA: Esto destruirá todos los datos de las particiones que haya eliminado, así como de las particiones que se formatearán. Se cambian las tablas de particiones de los siguientes dispositivos:  SCSI8 (0,0,0) (sdc) Se formatearán las siguientes particiones:  partición # 1 de SCSI8 (0,0,0) (sdc) como ESP  partición # 2 de SCSI8 (0,0,0) (sdc) como ext4
  16. Elija su zona horaria.
  17. Configure su cuenta personal, nombre de host y proceso de registro.
  18. Espere a que finalice la instalación y arranque su nuevo Xubuntu. No se preocupe si grub etiqueta Xubuntu como Ubuntu. Esto es normal.