WeKnora: respuestas sustentadas, memoria acotada y operación consciente
Desplegar WeKnora: imágenes identificadas, servicios acotados y recuperación de datos
Distingue Compose, Lite y desarrollo; entiende imágenes en caché, migraciones y componentes opcionales.
Qué aprenderás
- Elige la forma antes de añadir servicios
- Actualizar el checkout no reemplaza una imagen antigua
- Salud, función y recuperación son tres pruebas
Antes de empezar
- Conceptos básicos de HTTP y contenedores
- Documentos, pasajes y proveedores de modelos
Separar ingesta, recuperación, respaldo y alcance de memoria para diseñar aceptación basada en evidencia.
Conclusiones clave
- Servicios centrales y perfiles opcionales cuestan distinto.
- Al actualizar importa descargar la versión seleccionada.
- La salud no sustituye pruebas funcionales y de recuperación.
Elige la forma antes de añadir servicios
La instalación distingue Compose estándar con PostgreSQL y Redis, Lite con SQLite y coordinación en memoria, y desarrollo con procesos de aplicación en el host. Marca la aplicación de escritorio como no publicada oficialmente en esta revisión. No todas las rutas de empaquetado tienen igual madurez.
Empieza con servicios centrales y añade perfiles por una necesidad concreta. La estimación inicial de hardware de la guía no garantiza capacidad para inferencia local, grandes documentos escaneados o una pila completa de observabilidad. Dimensiona modelos y parsing por separado.
Actualizar el checkout no reemplaza una imagen antigua
Selecciona WEKNORA_VERSION en la configuración revisada, descarga las imágenes correspondientes y recrea los servicios pertinentes. El README advierte que up por sí solo puede reutilizar caché y dejar la versión visible atrás. La revisión citada en este artículo tampoco fija tu etiqueta o digest de imagen.
Genera y guarda secretos en el entorno de despliegue; no los publiques en artículos ni commits. Los puertos documentados son valores predeterminados, no prueba de acceso privado. Revisa interfaces y cortafuegos, y conserva acceso interno hasta verificar los controles.
Salud, función y recuperación son tres pruebas
Un backend saludable es el primer paso. Comprueba modelos, procesa un documento sintético, recupera el pasaje esperado y abre la cita. Dentro del contenedor, localhost apunta al contenedor; la guía usa host.docker.internal para Ollama del host, cuya disponibilidad debe verificarse en la plataforma elegida.
Las migraciones automáticas hacen que actualizar sea más que intercambiar imágenes. Respalda base de datos, archivos y configuración necesaria, y prueba restauración antes de migrar datos importantes. No uses eliminación de volúmenes o limpieza de base como solución rutinaria. Aquí no ejecutamos despliegue ni restauración.
Cómo elegir
| Criterio | Opción A | Opción B |
|---|---|---|
| Best when | You need predictable behavior and easy auditing | You need adaptive optimization and have reliable telemetry |
| Main risk | May leave performance on the table | Can become difficult to explain or debug |
Pasos de implementación
- 1
Elige estándar, Lite o desarrollo.
- 2
Revisa secretos, versión y puertos.
- 3
Prueba la ruta documental sintética.
- 4
Valida respaldo y restauración antes de migrar.
Ejemplo para copiar
docker compose ps
curl http://localhost:8080/healthPreguntas frecuentes
¿Por qué no cambia la interfaz tras actualizar?
La guía advierte que up puede reutilizar imágenes; verifica etiqueta y descarga.
¿Debo activar full al empezar?
Solo si necesitas esos servicios y has revisado recursos y seguridad.
Fuentes
- WeKnora / README.mdFuente verificada 2026-09-14
- WeKnora / website-docs/01-getting-started/02-installation.mdFuente verificada 2026-09-14
- WeKnora / website-docs/01-getting-started/03-quickstart.mdFuente verificada 2026-09-14