Verificando autenticación…

Saltar al contenido principal

OOMKilled en GitLab CI/CD - Build de React falla por memoria

Problemas o Consultas Comunes​

  • Error OOMKilled al compilar proyectos React en GitLab CI/CD
  • Build falla por falta de memoria durante la compilación
  • Pipeline se interrumpe con error de memoria insuficiente
  • Múltiples proyectos afectados por el mismo problema de memoria

Solución​

El error OOMKilled (Out Of Memory Killed) ocurre cuando el proceso de build consume más memoria de la disponible en el runner de GitLab CI/CD. Este problema afecta especialmente a builds de React que requieren más recursos durante la compilación.

Pasos para resolver:

  1. Optimizar configuración del pipeline:

    # En .gitlab-ci.yml, agregar configuración de memoria
    build:
      script:
        - export NODE_OPTIONS="--max-old-space-size=4096"
        - npm run build

  2. Reducir uso de memoria en el build:

    • Usar --max-old-space-size para aumentar límite de memoria de Node.js
    • Considerar builds incrementales
    • Optimizar dependencias y imports

  3. Configuración de runner:

    • Solicitar aumento de memoria en runners compartidos
    • Considerar uso de runners dedicados para builds pesados

  4. Alternativas de optimización:

    • Dividir el build en etapas más pequeñas
    • Usar cache de dependencias para reducir tiempo de build
    • Implementar builds paralelos si es posible

Equipo responsable: ANDES Entrega Ambiente típico: PROD Ticket de referencia: ANDES-503