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.
- Docker con Compose v2 o posterior y acceso a
/var/run/docker.sock. - Puertos
8080y8081disponibles. - 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-maxSi 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.
Ejecuta los comandos desde esta carpeta.
-
Crea la configuración local:
cp .env.example .env chmod 600 .env
-
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 -
Edita
.envy 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.envno cambia la contraseña de una base existente. -
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_sonarAbre 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/initialAdminPasswordCompleta 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.
Abre http://localhost:8081, entra con admin / admin y cambia la contraseña.
Después, crea tu proyecto y un token de análisis.
- En Jenkins, guarda el token como credencial de tipo Texto secreto.
- En Administrar Jenkins → Sistema → SonarQube servers, agrega:
- Nombre:
sonarqube. - URL:
http://sonarqube:9000. - Credencial: el token que guardaste.
- Nombre:
- 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.
- Para usar
waitForQualityGate, configura en SonarQube un webhook haciahttp://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.
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 jenkinsUn 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.
| 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.
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 sonarqubeSi 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 -dEste 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.