Qué hace SonarQube
SonarQube es una plataforma de análisis estático: lee el código sin ejecutarlo y señala lo que puede romperse, filtrar datos o costar caro de mantener. Cada defecto se clasifica — bug, vulnerabilidad, punto sensible de seguridad que revisar, code smell — y remite a una regla documentada, con un ejemplo de corrección.
SonarSource publica la edición Community Build bajo licencia LGPL-3.0. Cubre una veintena de lenguajes, entre ellos Java, JavaScript y TypeScript, Python, PHP, C#, Go y Kotlin, además de la infraestructura como código (Terraform, Kubernetes, Dockerfile). Analiza la rama principal de cada proyecto; el análisis de ramas, de pull requests y de los lenguajes C y C++ corresponde a las ediciones comerciales.
Lo que SonarQube le aporta
- Un quality gate — un veredicto claro en cada análisis, que su pipeline puede esperar antes de desplegar.
- La seguridad en el ciclo — inyecciones, secretos en claro y configuraciones débiles detectados desde el commit.
- Reglas explicadas — cada defecto lleva su justificación y un ejemplo de corrección.
- Seguimiento en el tiempo — deuda técnica, código duplicado y cobertura de pruebas, versión tras versión.
- Su código en casa — nada sale de su VPS, ni el código ni los resultados.
- Una API completa — proyectos, tokens, quality gates y webhooks programables.
Revisión manual sola o SonarQube en su VPS
Desplace la tabla
| Revisión manual sola | Con SonarQube en su VPS | |
|---|---|---|
| Defectos repetitivos | Depende de la atención del revisor | Detectados en cada análisis |
| Fallos conocidos | Se ven si alguien los conoce | Reglas de seguridad aplicadas en todo |
| Decisión de desplegar | A ojo | Quality gate explícito |
| Evolución de la deuda | Impresión general | Mediciones por versión |
| Dónde vive el código | En su forja | En su forja y en su VPS |
Preparar el servidor
Prevea un VPS Ubuntu 24.04 con al menos 4 GB de RAM y 2 vCPU: SonarQube ejecuta tres procesos Java — el servidor web, el motor de cálculo que procesa los análisis y un Elasticsearch integrado. Instale Docker y el plugin Compose.
Dos ajustes del sistema importan. Elasticsearch pide vm.max_map_count en 524288 como mínimo: ajústelo en el host con sysctl -w vm.max_map_count=524288 y hágalo permanente en /etc/sysctl.d/99-sonarqube.conf. Y SonarQube se niega a arrancar cuando queda menos de un 10 % del disco libre: guarde margen.
Instalar SonarQube con Docker Compose
Preparar la carpeta y el archivo .env
El archivo guarda la contraseña de la base PostgreSQL.
mkdir -p /opt/sonarqube && cd /opt/sonarqube cat > .env <<EOF DB_PASSWORD=$(openssl rand -hex 16) EOF chmod 600 .envEscribir el archivo docker-compose.yml
Dos servicios: PostgreSQL y SonarQube. El puerto solo se publica en la interfaz local: únicamente nginx quedará expuesto a Internet.
services: db: image: postgres:17.12-alpine restart: unless-stopped environment: POSTGRES_DB: sonar POSTGRES_USER: sonar POSTGRES_PASSWORD: "${DB_PASSWORD}" volumes: - sonarqube-db:/var/lib/postgresql/data sonarqube: image: sonarqube:26.11.0.134175-community restart: unless-stopped depends_on: [db] environment: SONAR_JDBC_URL: "jdbc:postgresql://db:5432/sonar" SONAR_JDBC_USERNAME: sonar SONAR_JDBC_PASSWORD: "${DB_PASSWORD}" SONAR_TELEMETRY_ENABLE: "false" SONAR_ES_BOOTSTRAP_CHECKS_DISABLE: "true" ulimits: nofile: { soft: 131072, hard: 131072 } nproc: { soft: 8192, hard: 8192 } ports: - "127.0.0.1:9000:9000" volumes: - sonarqube-data:/opt/sonarqube/data - sonarqube-extensions:/opt/sonarqube/extensions - sonarqube-logs:/opt/sonarqube/logs volumes: sonarqube-db: {} sonarqube-data: {} sonarqube-extensions: {} sonarqube-logs: {}Arrancar y comprobar
El primer arranque crea el esquema de la base y los índices de búsqueda: cuente de dos a cinco minutos. El estado debe pasar a
UP.docker compose up -d docker compose logs -f sonarqube # esperar «SonarQube is operational» curl -s http://127.0.0.1:9000/api/system/statusSustituir la contraseña de fábrica
La cuenta
adminse crea con la contraseñaadmin. Sustitúyala antes de publicar la instancia. SonarQube exige al menos 12 caracteres con una mayúscula, una minúscula, un dígito y un carácter especial.NEW='<su-contraseña>' curl -fsS -u admin:admin -X POST http://127.0.0.1:9000/api/users/change_password \ --data-urlencode login=admin --data-urlencode previousPassword=admin \ --data-urlencode "password=$NEW" curl -s -u admin:admin http://127.0.0.1:9000/api/authentication/validate # {"valid":false}
No publique nunca una instancia con admin/admin
Mientras la contraseña de fábrica esté activa, cualquiera que encuentre su dirección se convierte en administrador y lee todo su código. Sustitúyala antes de abrir el proxy inverso y después cree una cuenta nominativa por desarrollador en Administración, Seguridad, Usuarios. Iniciar sesión es obligatorio por defecto para consultar cualquier cosa: mantenga ese ajuste activo.
Publicar SonarQube en HTTPS detrás de nginx
Obtenga un certificado con certbot y declare un server block que transmita la cabecera X-Forwarded-Proto:
server {
listen 443 ssl;
server_name sonarqube.example.com;
ssl_certificate /etc/letsencrypt/live/sonarqube.example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/sonarqube.example.com/privkey.pem;
client_max_body_size 50m;
location / {
proxy_pass http://127.0.0.1:9000;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto https;
}
}Después, en Administración, Configuración, General, indique la URL del servidor (https://sonarqube.example.com): SonarQube la escribe en sus enlaces, notificaciones y webhooks.
Analizar un primer proyecto
En Mi cuenta, Seguridad, genere un token de tipo Global Analysis Token. Desde la raíz de un proyecto, ejecute el escáner oficial en un contenedor, sin instalar nada en su equipo:
docker run --rm \
-e SONAR_HOST_URL=https://sonarqube.example.com \
-e SONAR_TOKEN=<token> \
-v "$PWD:/usr/src" \
sonarsource/sonar-scanner-cli \
-Dsonar.projectKey=mi-proyecto -Dsonar.sources=.El proyecto aparece en SonarQube con sus defectos, su deuda y el veredicto del quality gate. Para un proyecto Java construido con Maven o Gradle, use en su lugar el plugin del build, que lee las clases compiladas.
Bloquear un pipeline con el quality gate
Guarde SONAR_HOST_URL y SONAR_TOKEN en los secretos del repositorio. Con sonar.qualitygate.wait=true, el escáner espera el veredicto y falla si el quality gate está en rojo: el paso de despliegue siguiente no se ejecuta.
# .github/workflows/sonarqube.yml
name: sonarqube
on:
push:
branches: [main]
jobs:
analyse:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
with:
fetch-depth: 0
- name: Analyse SonarQube
run: |
docker run --rm -e SONAR_HOST_URL -e SONAR_TOKEN -v "$PWD:/usr/src" \
sonarsource/sonar-scanner-cli \
-Dsonar.projectKey=${{ github.event.repository.name }} \
-Dsonar.qualitygate.wait=true
env:
SONAR_HOST_URL: ${{ secrets.SONAR_HOST_URL }}
SONAR_TOKEN: ${{ secrets.SONAR_TOKEN }}El principio es el mismo en GitLab CI, Jenkins o Woodpecker: un paso que lanza el escáner con esas dos variables.
Copia de seguridad y actualización
Los resultados viven en PostgreSQL; los plugins añadidos, en el volumen sonarqube-extensions. Los índices de búsqueda se reconstruyen solos al arrancar y no necesitan copia de seguridad.
cd /opt/sonarqube
docker compose exec -T db pg_dump -U sonar sonar | gzip > sonar-$(date +%F).sql.gz
docker run --rm -v sonarqube_sonarqube-extensions:/src -v "$PWD:/dst" alpine \
tar czf /dst/extensions-$(date +%F).tar.gz -C /src .Para actualizar, haga primero la copia, cambie la etiqueta de la imagen y ejecute docker compose pull && docker compose up -d. Si SonarQube pide una migración de la base, abra https://su-dominio/setup y lánzela.
SonarQube en un clic en ServOrbit
El Marketplace de ServOrbit instala exactamente esta pila: la imagen oficial de SonarQube Community Build y PostgreSQL, puerto publicado solo en 127.0.0.1, contraseña de fábrica de la cuenta admin sustituida desde el primer arranque, URL del servidor declarada y HTTPS configurado en su dominio o en el subdominio gratuito del VPS. La contraseña de administrador aparece en su área de cliente.
servorbit.com/ma-es/blog/autoalojar-sonarqube-vps-calidad-codigo
