m0xx25/centinela repository overview

⁠Centinela — Docker Hub

Imagen: m0xx25/centinela:latest

Descripción

• Contenedor que sirve el frontend de Centinela: SPA construida con Vite y servida por Nginx. Ideal para desplegar el frontend estático en entornos Docker-friendly.

Tags

• latest (principal). Se recomienda publicar tags semánticos por release como v1.0.0 para despliegues reproducibles.

Cómo obtener la imagen

• Pull: docker pull m0xx25/centinela:latest

Ejecución rápida (PowerShell)

docker run -d --name centinela-frontend -p 8080:80 m0xx25/centinela:latest

• Accede a http://localhost:8080.

Puertos expuestos

• 80 — puerto HTTP dentro del contenedor (mapeable al host).

Variables de entorno

• No requiere variables de entorno para la versión estática por defecto. Si necesitas configurar la BASE_URL o rutas base en build, hazlo durante la construcción del bundle de Vite.

Persistencia y volúmenes

• No es necesario persistir datos. Para sobrescribir la configuración de Nginx puedes montar un archivo:

docker run -d -p 8080:80 -v C:\mi-nginx\default.conf:/etc/nginx/conf.d/default.conf:ro --name centinela-frontend m0xx25/centinela:latest

Ejemplo docker-compose.yml (mínimo)

version: "3.8"
services:
  centinela-frontend:
    image: m0xx25/centinela:latest
    ports:
      - "8080:80"
    restart: unless-stopped

Construir localmente

• Desde la raíz del proyecto (ejemplo):

cd Frontend
docker build -t m0xx25/centinela:local .

Qué contiene esta imagen

• Build del frontend con Vite (Frontend/src, index.html).
• Nginx configurado para servir la SPA (Frontend/nginx.conf).

Consejos de despliegue

• Use un proxy inverso (Traefik, Nginx) para HTTPS y balanceo.
• Versiona la imagen por tag (v1.0.0) para despliegues reproducibles.
• Si la app consume la API backend, asegúrate de configurar CORS y la URL base en tiempo de build o mediante un envsubst en el entrypoint de Nginx.

Contribuir

• Para bugs o contribuciones, abre issues o PRs en el repositorio (https://github.com/M0xX18/Centinela).

Licencia

• Revisa el repositorio para la licencia aplicada. Añade una licencia apropiada si planeas distribuir públicamente.