Este repositorio automatiza la instalación y configuración de herramientas esenciales para la integración continua y monitoreo, utilizando Vagrant, Docker, y Docker Compose.
Antes de comenzar, asegúrate de tener instaladas las siguientes herramientas en tu máquina:
Clona este repositorio en tu máquina local:
git https://github.com/fcongedo/jenkins-prometheus-grafana-sonarqube.git
cd jenkins-prometheus-grafana-sonarqubeNavega al directorio Vagrant y ejecuta:
vagrant upEste comando iniciará una máquina virtual y configurará automáticamente las siguientes herramientas dentro de contenedores Docker:
- Jenkins: http://localhost:8080
- SonarQube: http://localhost:9000
- Grafana: http://localhost:3000
- Prometheus: http://localhost:9090
Para conectarte a la máquina virtual:
vagrant sshCuando termines, puedes detener la máquina virtual ejecutando:
vagrant haltSi deseas eliminar completamente la máquina virtual:
vagrant destroyAl ejecutar vagrant up, se realizará automáticamente lo siguiente:
-
Ajuste de parámetros del sistema:
- Configuración de
vm.max_map_count.
- Configuración de
-
Instalación de Dependencias:
- Actualización de paquetes del sistema.
- Instalación de Docker y Docker Compose.
- Configuración de Docker para evitar el uso de
sudo.
-
Clonación del Repositorio:
- El código fuente se clona en la máquina virtual.
-
Construcción y Ejecución de Contenedores:
- Construcción de imágenes Docker.
- Inicio de los contenedores con los servicios configurados.
Al ejecutar vagrant up, verás el sigiuente progreso de instalación:
El acceso a Jenkins se puede hacer directamente en http://localhost:8080
El usuario y la contraseña por defecto son:
- Usuario: admin
- Contraseña: admin
El acceso a SonarQube se puede hacer directamente en http://localhost:9000
El usuario y la contraseña por defecto son:
- Usuario: admin
- Contraseña: Adm1nistr@tor
Puedes acceder a Grafana en http://localhost:3000
El usuario y la contraseña por defecto son:
- Usuario: admin
- Contraseña: admin
Puedes acceder a Prometheus en http://localhost:9090
1.🌐 Crear una Red Docker
- Este paso es opcional pero recomendable si necesitas una red personalizada para los contenedores. Puedes crear una red llamada back-tier con el siguiente comando:
docker network create back-tier || trueEste comando creará la red back-tier si no existe. Si ya está creada, el || true evitará errores y continuará ejecutándose.
2.⚙️ Construir las Imágenes Docker
- A continuación, construye las imágenes de Docker. Esto descargará las últimas versiones de las dependencias y las construirá sin usar imágenes de caché:
docker compose build --pull --no-cacheEste comando construirá las imágenes de todos los servicios definidos en el archivo docker-compose.yml.
3.⚙️ Ajustar Parámetro del Sistema
Antes de ejecutar Docker, necesitas ajustar el parámetro del sistema vm.max_map_count para evitar problemas con algunos contenedores, como el de Elasticsearch. Ejecuta el siguiente comando en tu terminal:
sudo sysctl -w vm.max_map_count=262144Este ajuste solo es necesario si estás ejecutando los servicios directamente con Docker.
4.🚀 Iniciar los Contenedores en Segundo Plano
- Una vez que las imágenes estén construidas, puedes iniciar los contenedores en segundo plano ejecutando:
docker compose up -dEsto levantará los contenedores definidos en docker-compose.yml en modo "desprendido" (detached), lo que significa que seguirán ejecutándose en segundo plano.
5.✅ Verificar los Contenedores en Ejecución
- Para verificar que los contenedores estén funcionando correctamente, puedes usar:
docker ps5.🛑 Detener los Contenedores
- Si deseas detener los contenedores, puedes usar el siguiente comando:
docker compose down -v- Si prefieres automatizar la instalación y configuración utilizando Ansible en lugar de Vagrant y Docker, sigue estos pasos.
- Requisitos Previos
-
Antes de ejecutar el playbook de Ansible, asegúrate de tener instaladas las siguientes herramientas:
- Clonar el Repositorio
- Clona este repositorio en tu máquina local:
git clone https://github.com/fcongedo/jenkins-prometheus-grafana-sonarqube.git
cd jenkins-prometheus-grafana-sonarqube- Ejecutar el Playbook de Ansible
-
En este paso, se instalarán y configurarán todos los servicios necesarios en la máquina remota utilizando Ansible. Asegúrate de tener Ansible instalado en tu máquina y de poder conectarte a la máquina remota (por ejemplo, si es localhost o una máquina virtual).
-
Ejecuta el siguiente comando para aplicar el playbook:
ansible-playbook ansible/playbook.yaml├── Vagrant/
├── jenkins/
├── prometheus/
├── grafana/
├── sonarqube/
├── app-java/
├── docker-compose.yml
└── README.md
Asegúrate de tener al menos 6 GB de RAM y suficiente espacio en disco para la máquina virtual.
Verifica que Docker esté correctamente instalado en la máquina virtual y que el servicio esté en ejecución.
Puedes ajustar los puertos, credenciales y volúmenes editando los archivos de configuración en el directorio Vagrant o docker-compose.yml.
Si deseas agregar plugins adicionales a Jenkins para que se instalen automáticamente al desplegar los contenedores, debes hacerlo modificando el archivo plugins.txt. Este archivo contiene la lista de plugins que Jenkins instalará al iniciarse. Añade los plugins que desees en este archivo antes de ejecutar el despliegue.
El archivo plugins.txt se encuentra en el siguiente directorio de tu proyecto:
├── jenkins/
│ └── plugins.txt
La carpeta app-java contiene una API de ejemplo con un archivo Jenkinsfile configurado. Esta API fue utilizada como demo para verificar que la configuración de Jenkins funciona correctamente en este entorno.
Para guías detalladas sobre cómo:
Generar un token en SonarQube.
Generar un token en Gmail.
Configurar el plugin Email-Ext con el token de Gmail.
Configurar SonarQube con su token.
Consulta la siguiente documentación: Guía de configuración detallada (PDF)
- Docker: Visitar la documentación de Docker
- Vagrant: Visitar la documentación de Vagrant
- Prometheus: Visitar la documentación de Prometheus
- Grafana: Visitar la documentación de Grafana
- SonarQube: Visitar la documentación de SonarQube