Generar un gráfico y ejecutarlo localmente (Windows/macOS/Linux)

Generar un gráfico y ejecutarlo localmente (Windows/macOS/Linux)

Esta guía explica cómo generar un proyecto ZIP desde el constructor DEMO y ejecutarlo localmente con Docker.

  1. En la página principal, abre el constructor DEMO y elige un tipo de gráfico.
  2. Haz clic en Modificar gráfico.
  3. Rellena Series y Valores. Ajusta ejes y opciones si es necesario.
  4. Haz clic en Generar ZIP. En Confirmar, verifica que tu suscripción esté activa y que el contador de ZIP > 0.
  5. Descomprime el archivo descargado.
  6. Instala y ejecuta Docker Desktop desde docker.com.
  7. En la carpeta descomprimida, ejecuta el script central:
    • Windows: doble clic en run-docker-windows.bat
    • macOS/Linux:
      chmod +x ./run-docker-unix.sh
      ./run-docker-unix.sh
    Los scripts primero intentan iniciar contenedores sin recompilar. Si faltan imágenes, intentarán cargar base-images.tar (si existe) y, sólo si es necesario, harán un build único.
  8. Abre en el navegador:
    • Frontend: http://localhost:8081/
    • Backend: http://localhost:8080/

Consejo: Si tu plan incluye licencia offline, descárgala en Configuración y colócala en frontend/public/license.cwclic.

Avanzado (offline, rebuild, stop)

Preparación offline (hacer una vez con Internet)

En una máquina con Internet, ejecuta:

  • Windows: preload-base-images-windows.bat
  • macOS/Linux: ./preload-base-images-unix.sh

El script descarga las imágenes base de Docker y las empaqueta en base-images.tar. Copia ese archivo junto al proyecto en la máquina offline.

Cargar imágenes sin Internet

En la máquina offline (junto a docker-compose.yml):

  • Windows: load-base-images-windows.bat
  • macOS/Linux: ./load-base-images-unix.sh

Alternativamente, ejecuta el script central: intentará cargar base-images.tar si lo encuentra.

Forzar recompilación

  • Windows: run-docker-windows.bat rebuild
  • macOS/Linux: ./run-docker-unix.sh rebuild
  • o variable de entorno: CWC_REBUILD=1

Detener / limpiar

  • Detener contenedores: stop-docker-windows.bat o ./stop-docker-unix.sh
  • Limpieza completa (eliminar volúmenes) manual:
    docker compose down -v

Solución de problemas

  • Docker no está en ejecución: abre Docker Desktop y vuelve a intentar.
  • Puertos ocupados: edita los puertos en docker-compose.yml y reinicia.
  • Permisos (mac/linux): ejecuta chmod +x ./run-docker-unix.sh.
  • Sin Internet / error auth.docker.io: usa el flujo offline — prepara base-images.tar, cárgalo con load-base-images-* y ejecuta de nuevo el script central.