Archivo

Entradas Etiquetadas ‘Jenkins’

2- Integración continua con Delphi (Jenkins)-Instalación

viernes, 8 de noviembre de 2019 Sin comentarios
Share Button

imageEn la anterior entrada empezamos con el tema de Integración continua. Vimos cómo crear y trabajar por encima con repositorios GIT.

A continuación os adjunto los links a las otras entradas de esta serie (las anteriores y las previstas):

1- Integración continua con Delphi (GIT)
2- Integración continua con Delphi (Jenkins) – Instalación
3- Integración continua con Delphi (Jenkins) – Primer proyecto
4- Integración continua con Delphi (DUnitX)

Una vez visto el paso previo de GIT, lo siguiente que necesitamos  en “montar” nuestro servidor de automatización. Para ello he escogido Jenkins. Jenkins en un “Servidor de Automatización” Open Source escrito en java y que está basado en Hudson.

Admite herramientas de control de versiones como CVS, Subversion, Git, Mercurial, Perforce y Clearcase y puede ejecutar proyectos basados en Apache Ant y Apache Maven, así como secuencias de comandos de consola y programas por lotes de Windows.

A continuación vamos a ver los pasos necesarios para instalar y configurar Jenkins.

INSTALACIÓN DE JENKINS

Una vez descargado el paquete correspondiente a nuestro sistema, comenzamos la instalación. Actualmente está disponible la versión v2.202, pero la verdad es que tanto las actualizaciones del sistema, como la de los múltiples plugins que posee son muy frecuentes.

image

Captura_2019-10-31 08_54_05

Jenkins se instala como un servicio de Windows y la instalación no tiene más opciones que el directorio de destino, que podemos dejar el que propone por defecto. El acceso se realiza a través de un navegador web y utiliza por defecto el puerto 8080.

Una vez finalizada la instalación podemos comprobar que la consola de Servicios de Windows que se ha instalado correctamente y que está “Iniciado”. Se abrirá una ventana del navegador a la dirección:   http://localhost:8080/

Lo primero que se nos solicita es un “Password de Inicialización”. Simplemente hemos de buscarlo en la ruta donde se nos indica y pegarlo en el espacio habilitado en la pantalla.

image

Lo siguiente que hace es instalar los plugins que la instalación propone por defecto y las dependencias que necesitan para funcionar. Posteriormente desde la configuración podemos instalar más según nuestras necesidades.

Entre los que se instalan por defecto podemos ver que está el de GIT y SVN; El de SSH y la extensión para poder enviar Mails. También los relacionados con pipelines.

image

Una vez completado este paso, nos pedirá definir el usuario Administrador:

image

Por último Jenkins nos pide que cambiemos la URL de localhost por la IP.

Una vez completada la configuración, podremos hacer “login” como administradores (con el usuario definido anteriormente) para poder acceder al “Panel de Control” de Jenkins, donde veremos una imagen como esta:

image

CONFIGURACION BÁSICA DE JENKINS

Lo siguiente es configurar lo mínimo para que Jenkins pueda automatizar un proyecto.

CUENTA DE INICIO

Este es un paso muy importante si queremos que posteriormente Jenkins compile correctamente los proyectos de Delphi, ya sea mediante línea de comandos o mediante el plugin de RAD Studio.  Por defecto, Jenkins instala el servicio para iniciarlo desde la “Cuenta local del Sistema”. Necesitamos cambiar esa cuenta a la de nuestro “usuario local”. Si no lo hacemos así, es posible que luego el compilador tenga problemas para encontrar las librerías que necesita.

Para ello, accedemos a la consola de administración de Servicios y seleccionamos las propiedades del servicio de Jenkins. En la pestaña de “Iniciar sesión” es necesario modificar la cuenta de inicio.

image

Debemos desactivar la «Cuenta del sistema» y colocar la del usuario con la que hemos iniciado la sesión. Tendremos que rellenar usuario y contraseña y una vez guardados los cambios reiniciar el servicio (desde la propia consola –Acción/Reiniciar-).

image

CONFIGURAR GIT

En la entrada anterior vimos cómo instalar y realizar tareas con GIT. Si estamos instalando el Servidor de Jenkins en una máquina diferente, también deberemos instalarlo aquí. En este caso sin necesidad de herramientas gráficas (TortoiseGIT/GITExtensions) ya que Jenkins no las necesita.

Accedemos a “Administrar Jenkins”/”Global Tool Configuration”. En la sección de GIT necesitamos configurar el path de acceso al ejecutable.

image

INSTALAR EL PLUGIN DE RAD STUDIO

A la hora de compilar nuestros proyectos, hay diferentes alternativas. Podemos utilizar directamente la herramienta de MSBuild, también ficheros .BAT donde llamemos al compilador con los parámetros necesarios o utilizar el plugin existente para RAD Studio.

Este plugin para Jenkins nos permite configurar el path de RAD Studio (o diferentes versiones que tengamos instaladas), de forma que también se pueden compilar los proyectos desde él.

Basta con instalar el plugin de RAD Studio desde la sección de “Administrar Plugins”.

image

Y configurarlo desde “Administrar Jenkins”/”Global Tool Configuration”. Como he dicho podemos configurar varias versiones de RAD Studio si deseamos compilar proyectos de diferentes versiones y luego utilizar en cada proyecto la que corresponda.

image

CONFIGURACIÓN PARA ENVÍO DE CORREOS

Lo siguiente que podemos configurar es el envío de correo, para obtener información por correo de las diferentes tareas y su resultado que se realizan en el servidor. Se puede hacer desde: “Administrar Jenkins”/”Configurar el sistema”.

Las configuraciones varían según el servidor a utilizar. Por ejemplo, una configuración para utilizar cuentas de GMail sería la siguiente (habilitando el uso de aplicaciones externas en la cuenta de GMail):

image

En la parte inferior aparece un botón para generar un mail de prueba. Si la prueba es satisfactoria, aparecerá el texto que hay en el recuadro y en la cuenta de Mail configurada, recibiréis un correo de prueba. Si queremos configurar otro servidor de correo, bastará modificar los parámetros de conexión (usuario, puerto, SSL,…).

Hasta aquí esta segunda entrada. Si necesitemos configurar alguna cosa más, lo haremos sobre la marcha, pero los elementos más importantes son los que hemos visto aquí.

Como siempre los comentarios, sugerencias y criticas “constructivas” son bienvenidas.

Hasta la próxima!!

Share Button
Categories: CI, Delphi, GIT, Jenkins, TDD Tags: , , , ,

1- Integración continua con Delphi (GIT)

lunes, 4 de noviembre de 2019 3 comentarios
Share Button

Voy a dedicar varias entradas a hablar de Integración Continua con Delphi (a partir de ahora escribiré en algunos sitios CI –Continuous Integration– para abreviar).

Para no extenderme mucho voy a intentar dividir esta entrada en tres/cuatro entregas. Cada una de ellas centrada en un “pieza” importante de las que vamos repasar. Esta es la idea inicial, pero es posible que a medida que vaya desarrollando las otras, la cosa pueda cambiar.

1- Integración continua con Delphi (GIT)
2- Integración continua con Delphi (Jenkins) – Instalación
3- Integración continua con Delphi (Jenkins) – Primer proyecto
4- Integración continua con Delphi (DUnitX)

image

Una definición de Integración Continua (que puede ser un término muy amplio) podría ser esta:

La integración continua es una práctica de desarrollo de software mediante la cual los desarrolladores combinan los cambios en el código en un repositorio central de forma periódica, tras lo cual se ejecutan pruebas y se generan versiones automáticas.

Es algo así como ir encadenando los diferentes pasos que habitualmente hacemos (o deberíamos hacer manualmente) de una forma automatizada.

 

VENTAJAS DE LA CI

¿Porqué utilizar Integración continua?

Utilizar esta metodología, como muchas otras, a priori puede generar una sensación de pérdida de tiempo y un trabajo extra, pero a la larga la automatización de tareas suele traer ventajas que al principio pueden no ser evidentes, pero que pasado un tiempo se hacen visibles.

¿Qué nos puede aportar introducir esta metodología en nuestros desarrollos?

  • Obtenemos mejoras en el rendimiento a la hora de desarrollar aplicaciones. Se dedica menos tiempo a tareas manuales y repetitivas. Se evita que con el tiempo se dejen de hacer cosas como las pruebas automáticas, ya que no hay que hacerlas manualmente.
  • Minimiza los errores. Al automatizar tareas, éstas se pueden realizar con más frecuencia. Además, si aparecen errores se detectan con más rapidez y permite corregirlos más rápido.
  • Se generan actualizaciones de nuestro software (builds, compilaciones, releases,…) con mayor rapidez y frecuencia. Se pueden realizar entregas (si son necesarias) de forma más continuada.
  • Documentación e historial de las versiones generadas, resultados de los tests, cambios,…
  • Concede al desarrollo una mayor seguridad y confiabilidad, y eso repercute en la confianza del equipo de trabajo.

COMPONENTES PARA CI

Para completar el proceso de Integración Continua vamos a explicar las siguientes piezas con las que vamos a trabajar.

image

  • Sistema de control de versiones (en nuestro caso GIT –github-)
  • Test Unitarios  (en nuestro caso con DUnitX)
  • Compilaciones y pruebas automatizadas (Utilizaremos Jenkins)

SISTEMA DE CONTROL DE VERSIONES (GIT)

Ya he hablado otras veces del Control de Versiones en el blog.
Hoy en día lo considero imprescindible para un programador, independientemente de que trabaje de forma individual o en equipo. En realidad para un equipo es imprescindible, pero a nivel individual también nos aporta muchas ventajas. Seguridad, historial de cambios, metodología de trabajo,…
Hay diferentes Sistemas de Control de Versiones. Posiblemente los que más utilizamos son SVN y GIT. Aunque las arquitecturas y la forma de trabajo tienen algunas diferencias, la base es la misma.image

Para este artículo utilizaré GIT, pero los pasos son muy similares si trabajáis con otro.

Para ilustrar el artículo voy a explicar los pasos básicos para crear una cuenta en github,  crear un repositorio y subir allí nuestro proyecto.

Utilizaremos https://github.com/gitbucket/gitbucket

Podemos crear una cuenta con el «Plan Individual», suficiente para realizar las pruebas.
Seleccionaremos nuestra experiencia en programación (¿?¿?¿? no tengo muy claro para qué nos solicitan esta información –aunque no es obligatoria-).

image

Y «Host a project (repository)» como uso que le vamos a dar al repositorio.

image

Después de validar la cuenta a través del email, podremos crear un nuevo Repositorio (almacén de datos).

  • Inicializaremos con un fichero de Readme (plantilla)
  • Seleccionaremos si queremos un repositorio Privado/Público. Independiente para nuestras pruebas (yo personalmente lo he creado como privado).
  • “Add .gitIgnore”, nos permite seleccionar un fichero de “ignore” con la plantilla para Delphi. Significa que ya van configurados los ficheros que GIT debe ignorar para subir al repositorio. Por ejemplo, los ficheros:  .exe, .dll, .dcu, .map, .tds, etc, etc, etc,…
  • Seleccionaremos también una licencia de las disponibles.

Y ya podemos crear el repositorio.

image

Accedemos a la pantalla del Repositorio. En la sección de <Code> tenemos un fichero .gitignore, la licencia y el fichero Readme, acordes a lo que seleccionamos al crear el repositorio.
Si desplegamos el botón de [Clone or Download] tendremos la URL del repositorio. En mi caso es la siguiente:
https://github.com/NeftaliBlog/Ejemplos.git

CLIENTES GIT PARA WINDOWS

Hay herramientas para Windows que facilitan el trabajo con GIT (también para SNV) y también hay quien prefiere trabajar desde la línea de comandos; Eso ya va a gusto de cada uno.
Yo trabajo habitualmente con dos; GitExtensions y TortoiseGIT. Os dejo un par de imágenes de los menús de trabajo y los links para descargarlas.

Básicamente son herramientas que nos ofrecen un entorno visual para todas las opciones que posee GIT. Al final casi todas ellas acaban mostrándonos al realizar una operación, el comando de GIT correspondiente a la acción.

GITExtensionshttps://github.com/gitextensions/gitextensions

image

TortoiseGIT –  https://tortoisegit.org/

image

Lo primero que tenemos que hacer es Clonar nuestro repositorio de Github en nuestra máquina local. De esta forma podremos comenzar a gestionar proyectos. Para ello podemos utilizar la opción de Clonar (Git Clone) de las herramientas comentadas anteriormente.

Una vez clonado, añadimos nuestro proyecto dentro del repositorio y realizamos un Add. Con esto conseguiremos añadir los ficheros

Si utilizamos GitExtensions (a la que corresponde esta pantalla de clone)

image

Si lo hacemos con TortoiseGIT será la que veis a continuación:

image

Si el proceso se ha completado con éxito, nos aparecerá una ventana similar a esta (GITExtensions) y tendremos en local una copia exacta a nuestro repositorio de GitHub.

image

Y si revisamos el contenido del directorio, debería aparecer algo como lo que se ve a continuación. Ahora ya tenemos “un Clon” (una copia) de nuestro repositorio de github en local.

Repositorio github:   https://github.com/NeftaliBlog/Ejemplos

Repositorio en LocalD:\PROYECTOS\Ejemplos Blog

(En mi caso yo lo he colocado aquí, vosotros tendréis otro directorio local a vuestro gusto)

image

AÑADIR PROYECTO AL REPOSITORIO

Lo siguiente que vamos a hacer es crear un nuevo proyecto y añadirlo a nuestro repositorio. Para esto, he creado un proyecto de “hola mundo” (dentro de nuestro repositorio local).  Además he añadido una unit con las 4 funciones matemáticas básicas (suma resta, multiplicación y división), que luego nos servirá para diseñar test Tests Unitarios con DUnitX sobre estas funciones.

Realizaremos los pasos para añadirlo. No es la finalidad de este artículo repasar en profundidad el uso de GIT, así que no voy a entrar en más detalles. Los pasos a realizar son: ADD, COMMIT y PUSH.

Con esto conseguiremos subir nuestro proyecto desde nuestro repositorio local al de github.

image

Llegados a este punto, ya tenemos un repositorio local y nuestro repositorio de github sincronizados. Si a partir de ahora otro miembro del equipo quiere incorporarse al mismo proyecto bastaría con replicar los pasos en su equipo para “Clonar” el repositorio en su máquina. Cada uno trabaja en su repositorio local hasta que necesita integrar cambios en el repositorio de GIT.

A difencia de otras veces, no adjunto los ficheros del proyecto ya que podéis descargarlos directamente del repositorio de github.

BIBLIOGRAFÍA Y LINKS RELACIONADOS

Si queréis revisar más documentación sobre el tema, a continuación os dejo algunos links…

https://www.ender.es/2010/02/integracion-continua-proyectos-delphi-en-hudson/
https://aws.amazon.com/es/devops/continuous-integration/
https://www.youtube.com/watch?v=dhKGmp6KsNs
https://chapmanworld.com/2015/01/18/use-radstudio-with-jenkins-no-plugin/
http://thundaxsoftware.blogspot.com/2011/07/continuous-integration-for-your-delphi.html
https://christerblog.wordpress.com/2010/04/25/using-hudson-to-build-delphi-projects/
http://www.nickhodges.com/post/Getting-Hudson-set-up-to-compile-Delphi-Projects.aspx

Como siempre los comentarios, sugerencias y criticas “constructivas” son bienvenidas.

Hasta la próxima!!

Share Button
Categories: CI, Delphi, GIT, Jenkins, TDD Tags: , , , ,