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.
storage:
persistence:
provider: MONGODB
mongodb:
uri: mongodb://localhost:27017
database: sofycorestorage:
persistence:
provider: MYSQL # o MARIADB
mysql:
host: localhost
port: 3306
database: sofycore
username: sofycore
password: 'cambiar'
tls: false # true verifica el certificado y el nombre del servidorstorage:
persistence:
provider: SQLITE
sqlite:
file: storage/sofycore.db # relativo a la carpeta del pluginRedis
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
| Clave | Por defecto | Significado |
|---|---|---|
pool.maximum-size | 8 | Conexiones máximas por servidor para SQL y Redis |
pool.workers | 4 | Operaciones simultáneas (de 1 a maximum-size; SQLite usa siempre una) |
pool.queue-capacity | 256 | Operaciones pendientes antes de rechazar trabajo nuevo |
pool.timeout-ms | 5000 | Tiempo de conexión, espera y lectura |
pool.health-interval-seconds | 30 | Intervalo de comprobación de salud |
cache.ttl-seconds | 300 | Caché 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.