Control de Versiones

Se llama control de versiones a la gestión de los diversos cambios que se realizan sobre los elementos de algún producto o una configuración del mismo. Una versión, revisión o edición de un producto, es el estado en el que se encuentra el mismo en un momento dado de su desarrollo o modificación.

Aunque un sistema de control de versiones puede realizarse de forma manual, es muy aconsejable disponer de herramientas que faciliten esta gestión dando lugar a los llamados sistemas de control de versiones o VCS (del inglés Version Control System). Estos sistemas facilitan la administración de las distintas versiones de cada producto desarrollado, así como las posibles especializaciones realizadas (por ejemplo, para algún cliente específico).

Ejemplos de este tipo de herramientas son entre otros: CVS, Subversion, SourceSafe, ClearCase, Darcs, Bazaar, Plastic SCM, Git, SCCS, Mercurial, Perforce, Fossil SCM, Team Foundation Server.

El control de versiones es un sistema que registra los cambios realizados sobre un archivo o conjunto de archivos a lo largo del tiempo, de modo que puedas recuperar versiones específicas más adelante.

Los sistemas de control de versiones distribuidos (Distributed Version Control Systems o DVCSs en inglés). En un DVCS (como Git, Mercurial, Bazaar o Darcs), los clientes no sólo descargan la última instantánea de los archivos: replican completamente el repositorio. Así, si un servidor muere, y estos sistemas estaban colaborando a través de él, cualquiera de los repositorios de los clientes puede copiarse en el servidor para restaurarlo. Cada vez que se descarga una instantánea, en realidad se hace una copia de seguridad completa de todos los datos

Más información: https://es.wikipedia.org/wiki/Control_de_versiones

Qué es es control de versiones y porqué debería ser importante: https://git-scm.com/book/es/v1/Empezando-Acerca-del-control-de-versiones

Programas de control de versiones: https://es.wikipedia.org/wiki/Programas_para_control_de_versiones

Porqué git es el sistema de control de versiones más popular: https://hipertextual.com/archivo/2014/05/git-sistema-control-versiones/

Que es git y github

Git (pronunciado “guit”) es un software de control de versiones diseñado por Linus Torvalds, pensando en la eficiencia y la confiabilidad del mantenimiento de versiones de aplicaciones cuando éstas tienen un gran número de archivos de código fuente.

Git es uno de los sistemas de control de versiones más populares entre los desarrolladores. Y parte culpa de su popularidad la tiene GitHub, un excelente servicio de alojamiento de repositorios de software con este sistema, que lejos de quedarse en esta funcionalidad, ofrece hoy en día un conjunto de características muy útiles para el trabajo en equipo.

Más información: https://es.wikipedia.org/wiki/Git

Cuando buscas en internet cualquier cosa sobre programación, software libre o Arduino es muy probable que acabemos en la página de https://github.com/ donde podemos acceder al código fuente.

Al trabajar Arduino es importante que conozcamos que es github y conocer un poco qué es y cómo hacer ciertas operaciones sencillas con esta web. Para conseguir software y ver el código, no es necesario crearse una cuenta, sólo es necesario cuando vamos a subir nuestro propio código.

GitHub es una plataforma de desarrollo colaborativo para alojar proyectos utilizando el sistema de control de versiones Git. El código se almacena de forma pública, aunque también se puede hacer de forma privada, creando una cuenta de pago.

Github es el servicio elegido por proyectos de software libre como jQuery, reddit, Sparkle, curl, Ruby on Rails, node.js, ClickToFlash, Erlang/OTP, CakePHP, Redis, y otros muchos. Además, algunas de las grandes empresas de Internet, como Facebook, alojan ahí sus desarrollos públicos, tales como el SDK, librerías, ejemplos, etc. También Arduino https://github.com/arduino

GitHub aloja tu repositorio de código y te brinda herramientas muy útiles para el trabajo en equipo, dentro de un proyecto. Además de eso, puedes contribuir a mejorar el software de los demás. Para poder alcanzar esta meta, GitHub provee de funcionalidades para hacer un fork y solicitar pulls.

Realizar un fork es simplemente clonar un repositorio ajeno (genera una copia en tu cuenta), para eliminar algún bug, modificar cosas de él o hacer tu propia versión partiendo de un software libre. Una vez realizadas las modificaciones puedes enviar un pull request al dueño del proyecto. Éste podrá analizar los cambios que has realizado fácilmente, y si considera interesante tu contribución, adjuntarlo con el repositorio original.

Guía de 10 minutos para empezar con github: https://guides.github.com/activities/hello-world/

En github podemos encontrar el código fuente de software libre que usamos a diario como el servidor web apache: https://github.com/apache/httpd y por supuesto el del IDE de Arduino https://github.com/arduino/Arduino

Y también grandes compañías como Google o Microsoft publican parte de su código en github: https://github.com/google y https://github.com/Microsoft

Otro ejemplo para el que usaremos github con Arduino es para conseguir las librerías de Arduino que nos sirven para manejar algunos dispositivos o nos facilitan la programación. Los distribuidores de hardware como https://www.sparkfun.com/ tienen su repositorio https://github.com/sparkfun donde podemos descargar las librerías para manejar el hardware que les compramos.

Más información de github:

Instalación de SourceTree

Git se usa mediante comandos, pero para facilitar su uso usaremos una herramienta llamada SourceTree y que podremos encontrar en https://www.sourcetreeapp.com/

Para ello debemos descargar la aplicación y en el proceso de instalación cuando se solicite no olvidar instalar la versión propia de git. No instalar svn (subversion). Opcionalmente conectar ninguna cuenta de github, pero no es necesario..

Para instalar SourceTree es necesario tener una cuenta en Atlassian o crearla.

Tutorial de instalación de SourceTree: https://confluence.atlassian.com/get-started-with-sourcetree/install-sourcetree-847359094.html

Para poder seguir con las prácticas crearse una cuenta en github y mandar un correo a aprendiendoarduino@gmail.com con el nombre de la cuenta para añadirlo a la organización: https://github.com/curso-programacion-arduino

Get started con sourcetree https://confluence.atlassian.com/get-started-with-sourcetree/get-started-with-sourcetree-847359026.html

Entender el interfaz de Sourcetree: https://confluence.atlassian.com/get-started-with-sourcetree/understand-the-interface-847359069.html

Hello World github

Para empezar con github hagamos el hello world: https://guides.github.com/activities/hello-world/

Hagamos los siguientes pasos cada uno con su cuenta de github:

  • Paso 1: Crear un repositorio
  • Paso 2: Crear una branch/rama
  • Paso 3: Hacer cambios y hacer commit
  • Paso 4: Hacer un Pull Request
  • Paso 5: Hacer un Merge del Pull Request

Todo esto que hemos hecho en la web de github, son operaciones que se pueden hacer con git por comando desde el ordenador o con una herramienta gráfica con SourceTree

Clonar un Repositorio

Clonar un repositorio, significa hacer una copia exacta en nuestro ordenador de un repositorio que hay en un servidor. Un repositorio, depósito o archivo es un sitio centralizado donde se almacena y mantiene información digital, habitualmente bases de datos o archivos informáticos.

Para clonar el repositorio con SourceTree debemos seguir estos pasos:

  • Click en el botón “Clone/New”
  • Click en “Clone repository”
  • En source URL poner la url de nuestro repositorio que lo encontramos en:

  • En Destination Path poner la ruta donde clonarlo. Podemos usar la ruta configurada en las propiedades de Arduino que por defecto es C:\Users\nombre_usuario\Documentos\Arduino\Curso_Programacion
  • En Name poner el nombre del Repositorio.
  • Y procedemos a clonar el repositorio.

Tutoriales de como clonar un repositorio:

Crear un repositorio local: https://confluence.atlassian.com/get-started-with-sourcetree/create-a-local-repository-847359103.html

Ejercicio: hacer con SourceTree lo mismo que se ha hecho con el Hello World en gitgub

  • Paso 1: Clonar el repositorio hello world que hemos hecho en nuestra cuenta de github. Ver como tenemos todos los pasos hechos en la web en local.
  • Paso 2: Crear una branch/rama nueva llamada “dev” en SourceTree
  • Paso 3: Hacer un cambio en el fichero readme.md poniendo nuestro nombre, hacer commit en SourceTree y hacer push de esos cambios al servidor.
  • Paso 5: Hacer un Merge de la nueva rama.

Trabajar Usando git

Trabajar usando git: https://confluence.atlassian.com/get-started-with-sourcetree/work-using-git-847359053.html

Operaciones básicas git:

Un pull request es una petición que el propietario de un fork de un repositorio hace al propietario del repositorio original para que este último incorpore los commits que están en el fork. Pull request es el corazón de la colaboración donde podemos hacer una modificación y proponerla al dueño

NOTA: la opción fetch es similar a pull, pero no copia los datos en local, sino que solo consulta en qué estado se encuentra nuestra copia local respecto al servidor. Es recomendable hacerlo antes del pull para ver en qué punto nos encontramos.

Más información:

Ejercicio: clonar el repositorio de la librería timer en nuestro ordenador en la carpeta librerías.

Organizaciones en github

Además de las cuentas de usuario, GitHub tiene Organizaciones. Al igual que las cuentas de usuario, las cuentas de organización tienen un espacio donde se guardarán los proyectos, pero en otras cosas son diferentes. Estas cuentas representan un grupo de gente que comparte la propiedad de los proyectos, y además se pueden gestionar estos miembros en subgrupos. Normalmente, estas cuentas se usan en equipos de desarrollo de código abierto.

Para el curso vamos a usar la organización https://github.com/curso-programacion-arduino donde todos los alumnos deben ser miembros de ella.

Las organizaciones se asocian con individuos mediante los equipos, que son simplemente agrupaciones de cuentas de usuario y repositorios dentro de la organización, y qué accesos tienen esas personas sobre cada repositorio.

Más información: https://git-scm.com/book/es/v2/GitHub-Gesti%C3%B3n-de-una-organizaci%C3%B3n

Uso de GIT en el curso

Durante el curso vamos a usar el sistema de control de versiones git y la plataforma de github para publicar el código que realicemos en el curso, ver las soluciones a los ejercicios y colaborar entre todos para resolver las prácticas propuestas.

Requisitos para realizar las prácticas:

Todos los ejercicios se subirán a la organización de github: https://github.com/curso-programacion-arduino y cada ejercicio tendrá su repositorio correspondiente con el formato EjercicioXX. La url a clonar es: “https://github.com/curso-programacion-arduino/EjercicioXX.git

Para hacer cualquiera de los ejercicios, el primer paso es clonar el repositorio del ejercicio y guardarlo en la ruta C:\Users\ThinkTIC\Documentos\Arduino\EjercicioXX, así podrán localizarse rápidamente en el IDE de Arduino. Dentro de este directorio el alumno creará el sketch con su solución al problema con el nombre Ejercicio_XX_NombreAlumno

Una vez hecho el ejercicio hacer un commit (no olvidar pasar a stage los fichero) y se publicará en github en la organización https://github.com/curso-programacion-arduino

Pasos:

  • Clonar el repositorio en el ordenador
  • Hacer el ejercicio con el nombre  EjercicioXX-Nombre. Recordar que se debe subir el fichero EjercicioXX-Nombre.ino dentro de una carpeta llamada EjercicioXX-Nombre
  • Hacer commit indicando en el commit el nombre del alumno.

Luego todos los alumnos podrán ver las soluciones propuestas por cada uno y comprobaremos que para un mismo problema hay infinitas soluciones. También el profesor pondrá su solución (no tiene porque ser la mejor) y hacer correcciones a los códigos propuestos por los alumnos.

NOTA: los ejercicios del repositorio https://github.com/jecrespo/aprendiendoarduino-Curso_Programacion_Arduino son las soluciones a los ejercicios, pero lo que subamos a la organización de github: https://github.com/curso-programacion-arduino son las prácticas que hará cada alumno y su solución.

Práctica con git

Ejercicio: Usando SourceTree hacer las siguientes tareas

  • Dentro del directorio clonado crear un sketch de Arduino que parpadee los cuatro leds a la vez del montaje de prácticas y llamarlo EjercicioXX-Nombre (poniendo vuestro nombre). Recordar que se debe subir el fichero EjercicioXX-Nombre.ino dentro de una carpeta llamada EjercicioXX-Nombre. ¡Importante! aseguraros de que nadie pone el mismo nombre sino puede haber conflictos.
  • Hacer un commit y un push
  • Hacer un pull para sincronizar el repositorio con las soluciones de los compañeros. ¡Atención!, es posible que tengamos que hacer un pull para sincronizar el directorio antes de hacer el push (el commit siempre lo hace) porque se han subido nuevas actualizaciones al servidor antes de la nuestra. Para resolverlo hacer fetch, ver lo que hay en el servidor, luego pull para sincronizar y finalmente push para subir mis cambios.
  • Comprobar que tengo en mi ordenador el código del resto de compañeros.
  • Comprobar que puedo moverme entre los diferentes commits hechos.
Anuncios

Responder

Introduce tus datos o haz clic en un icono para iniciar sesión:

Logo de WordPress.com

Estás comentando usando tu cuenta de WordPress.com. Cerrar sesión / Cambiar )

Imagen de Twitter

Estás comentando usando tu cuenta de Twitter. Cerrar sesión / Cambiar )

Foto de Facebook

Estás comentando usando tu cuenta de Facebook. Cerrar sesión / Cambiar )

Google+ photo

Estás comentando usando tu cuenta de Google+. Cerrar sesión / Cambiar )

Conectando a %s