/CI-Service

Open Source Continuous Integration Solution for academic purposes

Primary LanguageShell

CI-Service

Este es un pequeño proyecto en el que busco ejemplificar un sistema de integración continua mediante la interacción de herramientas open source al alcance de todos.

Arquitectura

En CI-Service están implicadas las siguientes tecnologías:

  • Vagrant: Para definir la máquina Centos donde correrán los contenedores, está preparado para montar toda la arquitectura tras un proxy corporativo en caso de ser necesario.
  • Docker Compose: De cara a ejecutar cada uno de los contenedores, se ha definido la instanciación de los contedores y los volúmenes donde estos operan.
  • Docker para ejecutar las distintas aplicaciones implicadas y crear los esclavos necesarios:
    • GitLab
    • Jenkins
      • Agente o esclavo Centos donde ejecutar las tareas de CI
    • Nexus
    • SonarQube
      • Postgresql
    • Portainer: Portal que nos permitirá administrar y monitorizar desde un dashboard todo el Docker Engine en ejecución.

Funcionamiento de CI

Esta arquitectura de CI contiene un proyecto de ejemplo definido para demostrar la lógica de funcionamiento:

  • En GitLab tenemos un proyecto "scala-maven" donde se ha definido en un Jenkinsfile la lógica a ejecutar por Jenkins
  • Jenkins monitoriza los cambios en el repositorio de Gitlab para el Job "scala-maven"
    • Si se detectasen cambios se procede a:
      • Descargar el repositorio
      • Compilar
      • Hacer pruebas unitarias
      • Hacer un análisis de código estático (SonarQube)
      • Publicar el artefacto en Nexus

Detalles de arquitectura

Los servicios que se instancian son los siguientes:

  • Vagrant: Define una máquina Centos que correrá Docker CE
    • Docker Engine
      • Portainer: Gestión de Docker CE mediante el dashboard
      • GitLab: Gestión del código fuente con Git
      • Jenkins: Orquestados
      • Nexus: Repositorio de artefactos
      • Postgresql: BBDD para almacenar los informes publicados en Sonar
      • SonarQube: Portal para representar los informes de calidad de código

Listado de servicios y puertos

Servicio Ruta Host:Puerto
Portainer http://192.168.50.10:9000/
GitLab http://192.168.50.10:8030/
Jenkins http://192.168.50.10:8080/
Nexus http://192.168.50.10:8081/nexus/
SonarQube http://192.168.50.10:8020/

Usuarios y contraseñas

Los usuarios siempre son de administración y puede ser: root ó admin Las contraseñas siempre es la misma: ciservice

En el caso de Sonar el token creado para acceder a este servicio desde otras aplicaciones es: 5f94f7762e88a8559fbc618abc02d4685dabc4b9

Como empezar

Requisitos

Requisitos de HW

  • CPU compatible con HiperV
  • La máquina virtual en Vagrant ha sido definida con 8 GB de RAM, por lo que un equipo de al menos 8GB es necesario

Requisitos de SW

  • Virtualbox : Como software de virtualización
  • Vagrant : De cara a definir la máquina virtual que ejecutará los distintos contenedores

Iniciar CI-Service

Tenemos 4 script para iniciar CI-Service según las siguientes circunstancias:

Sistema Operativo Windows

  • En el caso estandar ejecutamos "install-windows.bat"
  • En caso de estár tras un firewall corporativo useramos "install-windows-withproxy.bat"
    • Editamos el fichero incluyendo los datos del proxy corporativo
    • Ejecutamos el script

Sistema Operativo tipo Unix

  • En el caso estandar ejecutamos "install-unix.sh"
  • En caso de estár tras un firewall corporativo useramos "install-unix-withproxy.sh"
    • Editamos el fichero incluyendo los datos del proxy corporativo
    • Ejecutamos el script

Autor

Pablo Toledo