Skip to content

Latest commit

 

History

History
125 lines (97 loc) · 3.81 KB

spring-boot-ops.md

File metadata and controls

125 lines (97 loc) · 3.81 KB

Cheatsheet — Spring Boot ops (Labs 11, 14)

Verificación post-deploy (orden)

# Comando Qué verifica
1 curl .../actuator/health ¿Proceso + DB UP?
2 POST /api/notes ¿Negocio + JDBC OK? (smoke test)
3 printenv | grep SPRING ¿Config real del proceso?
4 docker compose logs app Evidencia de excepciones

Run

java -Xms256m -Xmx512m -jar app.jar
SPRING_PROFILES_ACTIVE=prod java -jar app.jar

Variables de entorno clave (Lab 11-C)

SPRING_DATASOURCE_URL=jdbc:mysql://HOST:3306/DB?useSSL=false&allowPublicKeyRetrieval=true
SPRING_DATASOURCE_USERNAME=appuser
SPRING_DATASOURCE_PASSWORD=***
SPRING_PROFILES_ACTIVE=prod          # perfil activo (dev/prod/test)
SERVER_PORT=8080
JAVA_TOOL_OPTIONS=-Xms128m -Xmx256m  # flags JVM sin cambiar ENTRYPOINT

Health — qué esperar

  • OK: "status":"UP" y db.status=UP
  • DB caída: db.status=DOWN o errores JDBC en logs
  • Nada en puerto: connection refused

Formatear JSON para lectura

curl -sS localhost:8080/actuator/health | python3 -m json.tool
curl -sS localhost:8080/actuator/health | jq .

Modelo de memoria JVM (Lab 11-D)

-Xms128m          # heap inicial (arranca con esto)
-Xmx256m          # heap máximo (techo, no puede crecer más)
-XX:+HeapDumpOnOutOfMemoryError          # dump al OOM
-XX:HeapDumpPath=/var/log/myapp/heap.hprof

Cálculo para VPS de 1GB

OS + buffers:    ~200MB
MySQL:           ~300MB
JVM heap (Xmx):  256MB
JVM overhead:    ~100MB (stack + metaspace + buffers nativos)
Total:           ~856MB → cabe en 1GB con margen

Memoria total JVM = heap + stack threads + metaspace + native buffers (siempre > Xmx)

HikariCP (pool de conexiones) — Lab 11-F

  • Pool mantiene N conexiones abiertas a MySQL
  • Si MySQL cae: pool detecta por timeout (~30s prod)
  • Si MySQL vuelve: pool reconecta automáticamente (sin restart de app)
  • "HikariPool - Connection is not available" = pool agotado

Anatomía de un log Spring Boot (Lab 11-E)

2026-08-03 16:00:05.123  INFO 1 --- [main] c.e.o.OpsLabApplication : Started
│                        │    │     │       │
timestamp                nivel PID  thread   clase

Niveles y triage

Nivel Significado Acción
INFO operación normal nada
WARN algo no ideal monitorear
ERROR problema real investigar
# Ranking de salud en 1 comando
grep -Eo 'ERROR|WARN|INFO' app.log | sort | uniq -c | sort -nr
# Mayoría INFO + pocos WARN + 0 ERROR = app sana

Diagnóstico diferencial (Lab 14)

Keyword en logs Causa Fix
Communications link failure MySQL no corre start mysql
Access denied for user password incorrecto (1045) sincronizar password
No space left on device disco lleno df -h, limpiar
OutOfMemoryError heap JVM lleno aumentar Xmx o fix leak
Address already in use puerto ocupado lsof, kill viejo
Too many connections pool/max_connections SHOW PROCESSLIST, ajustar
Connection timed out red o firewall verificar conectividad

Protocolo de diagnóstico (Lab 14)

1. Síntoma:   curl -w "http=%{http_code}" URL
2. Health:    curl actuator/health
3. Logs app:  docker compose logs --tail=80 app | grep -iE "error|exception"
4. Logs DB:   docker compose logs --tail=50 mysql
5. Diferencial: keyword → causa → fix específico
6. Fix:       aplicar
7. Verificar: health UP + API funciona
8. Documentar: informe con timeline

Lab rápido

cd ~/Projects/java-linux-ops-lab/docker && docker compose up -d
curl -sS localhost:8080/actuator/health | python3 -m json.tool
curl -sS -X POST localhost:8080/api/notes -H 'Content-Type: application/json' \
  -d '{"title":"t","body":"b"}'