Saltar al contenido

Configuración

Configuración del almacenamiento

Configura MongoDB, MySQL, MariaDB o SQLite y Redis para sofyCore, dimensiona los pools de conexiones y entiende la caché.

Elegir un proveedor

storage.persistence.provider elige MONGODB (predeterminado), MYSQL, MARIADB o SQLITE. Solo se lee la sección del proveedor elegido; las demás son plantillas. Cambiar de proveedor no mueve los datos.

config.ymlYAML
storage:
  persistence:
    provider: MONGODB
    mongodb:
      uri: mongodb://localhost:27017
      database: sofycore

Redis

config.ymlYAML
storage:
  redis:
    uri: redis://localhost:6379
    key-prefix: 'sofycore:'

El prefijo se añade a todas las claves y canales. Todos los servidores de una misma network deben usar el mismo Redis y el mismo prefijo.

Pools y límites

ClavePor defectoSignificado
pool.maximum-size8Conexiones máximas por servidor para SQL y Redis
pool.workers4Operaciones simultáneas (de 1 a maximum-size; SQLite usa siempre una)
pool.queue-capacity256Operaciones pendientes antes de rechazar trabajo nuevo
pool.timeout-ms5000Tiempo de conexión, espera y lectura
pool.health-interval-seconds30Intervalo de comprobación de salud
cache.ttl-seconds300Caché de registros compartida en Redis (1–86400)

Los pools son por servidor: con diez servidores y ocho conexiones SQL cada uno, la base puede recibir hasta ochenta conexiones. Dimensiónalos según tu base de datos.

Comportamiento ante fallos

Todo el I/O de base de datos y Redis se ejecuta en hilos de trabajo acotados, nunca en el hilo principal. Si falla la conexión inicial, se detecta una caída real o una comprobación de salud encuentra el servicio caído, sofyCore rechaza trabajo nuevo y se desactiva en el hilo del servidor. Restaura el servicio y reinicia; no hay reactivación automática.