Skip to content

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

1 watching

Forks

Latest commit

 

History

22 Commits

Folders and files

Repository files navigation

Jenkins y SonarQube con Docker Compose

Laboratorio local para construir proyectos con Jenkins y analizarlos con SonarQube.

Servicio Imagen base Acceso
Jenkins jenkins/jenkins:lts-jdk25 http://localhost:8080
SonarQube sonarqube:26.9.0.129388-community http://localhost:8081
PostgreSQL postgres:15.19 Solo red interna

Jenkins incluye Docker CLI, Buildx, Compose y los plugins de plugins.txt. Los datos se conservan en volúmenes Docker.

Requisitos

  • Docker con Compose v2 o posterior y acceso a /var/run/docker.sock.
  • Puertos 8080 y 8081 disponibles.
  • Como referencia, 4 CPU y 8 GiB de RAM para el laboratorio completo.

SonarQube requiere estos mínimos en el host Linux del daemon Docker:

sysctl vm.max_map_count fs.file-max

Si algún valor es menor, agrega estas líneas a /etc/sysctl.d/99-sonarqube.conf y aplica los cambios con sudo sysctl --system:

vm.max_map_count=524288
fs.file-max=131072

En Docker Desktop, estos ajustes corresponden a su VM Linux.

Arranque rápido

Ejecuta los comandos desde esta carpeta.

  1. Crea la configuración local:

    cp .env.example .env
    chmod 600 .env
  2. Obtén el grupo del socket Docker desde un contenedor:

    docker run --rm --entrypoint stat \
      --volume /var/run/docker.sock:/var/run/docker.sock:ro \
      jenkins/jenkins:lts-jdk25 -c '%g' /var/run/docker.sock
  3. Edita .env y completa:

    SONAR_DB_PASSWORD=tu_contrasena
    DOCKER_GID=grupo_numerico_del_paso_anterior

    Puedes generar una contraseña con openssl rand -hex 32. Si ya tienes una base de datos, usa su contraseña actual: cambiar .env no cambia la contraseña de una base existente.

  4. Construye Jenkins e inicia los servicios:

    docker compose config --quiet
    docker compose build --pull jenkins
    docker compose up -d
    docker compose ps

SonarQube puede tardar varios minutos en iniciar. Para consultar el progreso:

docker compose logs --tail=100 jenkins sonarqube db_sonar

Configurar Jenkins

Abre http://localhost:8080. En una instalación nueva, obtén la contraseña inicial:

docker exec devops-infra-jenkins-1 cat /var/jenkins_home/secrets/initialAdminPassword

Completa el asistente y crea tu usuario administrador. Los plugins de este proyecto ya están incluidos en la imagen.

El nombre del contenedor corresponde al proyecto devops-infra. Si cambias el nombre del proyecto con -p o COMPOSE_PROJECT_NAME, consulta el nombre con docker compose ps.

Para activar la protección CSP, entra en Administrar Jenkins → Seguridad → Content Security Policy, selecciona Set up now, activa Enforce Content Security Policy y guarda. Revisa que las páginas que usas funcionen correctamente. No necesitas instalar otro plugin.

Conectar SonarQube con Jenkins

Abre http://localhost:8081, entra con admin / admin y cambia la contraseña. Después, crea tu proyecto y un token de análisis.

  1. En Jenkins, guarda el token como credencial de tipo Texto secreto.
  2. En Administrar Jenkins → Sistema → SonarQube servers, agrega:
    • Nombre: sonarqube.
    • URL: http://sonarqube:9000.
    • Credencial: el token que guardaste.
  3. Si tu pipeline usa SonarScanner CLI, configura su instalación en Administrar Jenkins → Herramientas. El plugin no incluye el ejecutable; también puedes usar un agente que lo contenga o la integración de Maven/Gradle.
  4. Para usar waitForQualityGate, configura en SonarQube un webhook hacia http://jenkins:8080/sonarqube-webhook/, incluida la barra final.

Las URLs anteriores usan la red interna de Compose. Dentro de un contenedor, localhost apunta al propio contenedor.

Agentes y plugins

Puedes usar agentes Docker con Node, kubectl u otras herramientas de tu pipeline. kubernetes-cli proporciona withKubeConfig; kubectl debe estar en el agente que lo ejecute.

Los agentes Docker usan el daemon del host: sus montajes se resuelven en ese host. Tenlo en cuenta si montas archivos del workspace de Jenkins, que vive en un volumen.

Todos los plugins de plugins.txt usan latest. Para actualizar la imagen y resolver nuevamente sus versiones:

docker compose build --pull --no-cache jenkins
docker compose up -d --no-deps jenkins

Un volumen existente conserva sus plugins. Revisa también Administrar Jenkins → Plugins para actualizarlos; quitar una entrada de plugins.txt no desinstala un plugin del volumen.

Comandos habituales

Acción Comando
Ver servicios docker compose ps
Ver registros docker compose logs --tail=100 -f
Reiniciar Jenkins docker compose restart jenkins
Detener docker compose stop
Volver a iniciar docker compose start
Eliminar contenedores conservando datos docker compose down
Comprobar acceso a Docker desde Jenkins docker compose exec jenkins docker version

docker compose down --volumes elimina los datos del laboratorio.

Si Jenkins no puede acceder a Docker, revisa DOCKER_GID y recrea el contenedor con docker compose up -d --force-recreate jenkins. No uses chmod 666 sobre el socket como solución.

Si SonarQube no inicia, revisa sus registros, los parámetros del kernel, la contraseña de PostgreSQL y la memoria disponible.

Actualizar y respaldar

Antes de actualizar una instalación existente, respalda los datos y revisa la ruta de actualización de SonarQube. Algunas versiones requieren pasos intermedios. Una actualización mayor de PostgreSQL requiere una migración de datos.

Respaldo básico de Jenkins y la base de SonarQube

Espera a que terminen los builds. Ejecuta cada comando y comprueba que termine sin errores antes de continuar:

BACKUP_DIR="$PWD/backups/$(date +%Y%m%d-%H%M%S)"
mkdir -p "$BACKUP_DIR"
chmod 700 "$BACKUP_DIR"
docker compose stop jenkins sonarqube

docker run --rm --user root \
  --volume devops-infra_jenkins_home:/source:ro \
  --entrypoint tar jenkins/jenkins:lts-jdk25 \
  -czf - -C /source . > "$BACKUP_DIR/jenkins-home.tgz"

docker compose exec -T db_sonar pg_dump -U sonar -d sonar -Fc \
  > "$BACKUP_DIR/sonarqube-database.dump"

docker compose start jenkins sonarqube

Si cambiaste el nombre del proyecto, ajusta el nombre del volumen. Guarda también la configuración de Compose, .env y las extensiones externas que hayas instalado. Protege los respaldos: contienen credenciales y datos. Prueba su restauración en un entorno separado antes de depender de ellos.

Para descargar las imágenes de SonarQube y PostgreSQL declaradas en Compose:

docker compose pull sonarqube db_sonar
docker compose up -d

Seguridad

Este laboratorio escucha únicamente en 127.0.0.1. No está preparado para producción. El socket Docker permite controlar el host: ejecuta solo pipelines de confianza. No compartas .env, los respaldos ni la salida completa de docker compose config, que incluye la contraseña.

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors