Instructivo para descarga del código fuente

Transcripción

1 AGESIC Software Público Uruguayo Instructivo para descarga del código fuente Versión 3.0 Febrero 2014

2 Guía para la descarga y actualización del código fuente Los repositorios de código fuente de los proyectos publicados en el catálogo de software público son gestionados con la herramienta GitLab, dicha herramienta proporciona un entorno web que motiva la contribución colaborativa de los desarrolladores. Dichos repositorios utilizan git, un gestor de código fuente libre y distribuído diseñado para gestionar todo tipo de proyectos, desde pequeños a muy grandes, con velocidad y eficiencia. Existen diversas maneras y muchas herramientas para descargar localmente y actualizar un proyecto git, a continuación les mostraremos el uso de algunas de ellas utilizando la interfaz web de GitLab, la terminal de su Sistema Operativo y también utilizando software que brinda una completa interfaz gráfica (GUI) para la tarea. Descarga utilizando la interfaz web de GitLab En la página "Home" de cada proyecto se puede descargar el contenido del repositorio con todas sus ramas (o descargar sólo una rama específica) comprimido en un archivo utilizando el botón de "Download" que se destaca en la siguientes capturas de pantalla:

3

4 Descarga usando Git en terminal en GNU/Linux, Windows, MacOS, OS X o Solaris Para instalar git ingresar a allí encontrará la descarga adecuada para su Sistema Operativo (SO), en GNU/Linux git ya se encuentra disponible para ser instalado directamente desde el gestor de paquetes de la distribución, en gran mayoría de las distribuciones. Una vez instalado, dependiendo del SO, tendrá la opción de utilizar git en la terminal o en GUI, este ejemplo muestra el uso de la herramienta en la terminal o "Git Bash" como lo nombra el instalador de Windows debido al entorno y tipo de terminal que utiliza para disponibilizar la herramienta al usuario. El comando git clave para la descarga local de un repositorio es el comando clone. En la documentación de git se puede tener una descripción exahustiva de todos los comandos de git y de la herramienta en general, se recomienda su lectura. A continuación usaremos este comando para la descarga de uno de nuestros proyectos públicos: $ git clone Si se ejecutó correctamente usted ya posee una copia local del árbol de código fuente del proyecto en el directorio gitlab. Descarga con Interfaces gráficas Git posee interfaces gráficas (GUI) aunque recomendamos que el usuario intente utilizar la terminal, las interfaces gráficas no ofrecen nada más de lo que ya ofrecen los comandos de git. Windows La instalación predeterminada de git para Windows que se descarga en ofrece una GUI, el procedimiento para clonar el proyecto es muy similar al visto anteriormente en la terminal, hacemos click en "clonar un repositorio" y

5 luego le indicamos su ubicación remota y la ubicación local hacia donde lo clonaremos, lo que se ve reflejado en las siguientes capturas de pantalla: Windows, MacOS, Linux (git-cola) Git-cola es una sencilla y poderosa GUI multiplataforma para utilizar git, análogamente a la GUI presentada en el punto anterior, para clonar un proyecto hay que proceder de igual manera, lo que se muestra en las siguientes dos capturas de pantalla tomadas usando gitcola en Ubuntu GNU/Linux:

6 Actualización (subida) de código fuente al repositorio La subida de código se realiza usando las mismas herramientas; en git, el concepto de subir un cambio a un repositorio se llama push cada push sube al repositorio uno o máscommits, cada commit es un conjunto de cambios al árbol de código que quedan registrados por el usuario con un mensaje alusivo por ejemplo "Agrego archivo de README" o "Fix del bug #123". Una de las diferencias a tener presente con los gestores de código no distribuídos es que por lo general en los SCM distribuídos los commits son locales y luego se pushea a los repositorios remotos que pueden ser varios y no solamente uno como en los SCM no distribuídos. Esto se debe a que en los SCM distribuídos cada repositorio -local o servidor- contiene una réplica completa. Push usando Git en terminal en GNU/Linux, Windows, MacOS, OS X o Solaris Se recomienda leer esta sección del libro de Git, podríamos resumir la subida de, por ejemplo, un nuevo archivo al repositorio con los siguientes comandos: $ git add README.md $ git commit -m "Agrego archivo de README"

7 $ git push Por supuesto que para esto ya tenemos que tener un repositorio clonado siguiendo los pasos de la sección anterior o un repositorio creado por nosotros localmente con el comando git init, el comando add puede recibir nombres con comodines como por ejemplo *.c o *.py o nombres de directorio para agregar todo el directorio, un caso particular que agrega todo sería el git add., para obtener una ayuda de cada comando ejecutar git help seguido del comando, ej.: git help add. Push usando interfaz gráfica en Windows Usando la GUI tanto en Windows como en GNU/Linux la idea es la misma, agregamos las modificaciones, commiteamos y pusheamos, lo que se puede ver claramente en esta serie de capturas de pantalla: Paso 1: Tenemos el archivo nuevo aun no agregado al repositorio.

8 Paso 2: Agregamos el archivo al repositorio. Paso 3: Se puede ver cómo los cambios están en la zona de "staged", prontos para ser commiteados.

9 Paso 4: Commiteamos los cambios con un mensaje alusivo. Paso 5: Ahora subimos los cambios realizados con Push.

10 Paso 6: Diálogo que permite opciones para el Push, mantenemos todo como está y presionamos "Push". Paso 7: Push realizado exitosamente.