qdrant-es-gateway
Qdrant ES Gateway: aplicación de búsqueda compatible con Elasticsearch en Rust, basada en el motor Qdrant. Aplica un subconjunto útil del API REST de Elasticsearch para búsquedas de aplicaciones (catálogos, documentación, tareas, tickets y contenido), no Kibana ni reemplazo completo.
Ficha actualizada 22 sept 2026, 20:54 · upstream 22 sept 2026, 20:24 · release v0.1.1
Qué es qdrant-es-gateway
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
El qdrant-es-gateway es una aplicación de búsqueda que expone un subconjunto deliberadamente útil del API REST de Elasticsearch, impulsado por el motor Qdrant. Está diseñado para búsquedas ordinarias como catálogos, documentación, tareas y contenido, no para Kibana, log o reemplazo completo de Elasticsearch.
La arquitectura se centra en una capa de gateway que decodifica cada segmento de la URL antes de mapear (index, ID de Elasticsearch) a un ID único de punto en Qdrant. Esto permite que el servicio sea stateless y escalable, mientras mantiene la durabilidad del estado mediante un esquema de persistencia basado en SQLite.
El proyecto soporta múltiples arquitecturas: Docker Compose para despliegue rápido, Helm Charts para entornos Kubernetes, imágenes GHCR para producción y pipelines CI/CD con generación automática de SBOMs (Software Bill of Materials) y attestaciones de seguridad.
- Búsqueda en catálogos de productos o servicios
- Búsqueda y filtrado de documentación técnica
- Gestión de tickets y solicitudes de soporte
- Búsqueda de contenido corporativo interno
- Procesamiento de datos analíticos con consultas rápidas
- APIs RESTful que requieren compatibilidad con clientes oficiales
- Soporta búsqueda en tiempo real mediante el motor Qdrant BM25, ofreciendo resultados instantáneos sin necesidad de indexación previa
- Diseñado como un gateway de capa superior: decodifica y mapea las peticiones antes de enviarlas a Qdrant, permitiendo una arquitectura desacoplada
- Soporta consultas complejas con bools (must/filter/must_not/should), ranking y paginación avanzada mediante cursor sort
- Proporciona compatibilidad con SDKs oficiales como el cliente Python de Elasticsearch para migraciones sin interrupciones
- Incluye herramientas de despliegue completas: Docker Compose, Helm Charts, imágenes GHCR, SBOMs y attestaciones de seguridad
- No soporta scripts, scroll o agregaciones arbitrarias en el lado del gateway; estas se rechazan con errores estructurados
- Las puntuaciones de búsqueda son basadas en BM25 de Qdrant, no en Lucene, lo que puede diferir en comportamientos de ranking
- La semántica de refresh/version/sequence es una aproximación y no garantiza consistencia estricta
- No soporta consultas de patrones complejos (wildcards, regex) ni búsquedas unidireccionales de alta cardinalidad
- Las agregaciones nativas son limitadas a facetas sobre campos keyword indexados; las agregaciones avanzadas requieren el lado del cliente
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Recomendación: usar Docker Compose para desarrollo y pruebas, Helm Charts para producción en Kubernetes,Configurar QDRANT_URL con la URL de conexión a Qdrant (por defecto 'http://localhost:6333' si no se usa un cluster externo),Asegurar que el puerto 9200 esté disponible y configurado como port forward en el cluster principal,Configurar QDRANT_API_KEY para proteger las credenciales de autenticación; nunca exponerlas en logs,Para catálogos write-heavy, activar DOCUMENT_PROJECTION=true para usar un segundo índice como fuente duradera,Activar ASYNC_SEARCH_PROJECTION=true solo si se requiere una capa stateless; combinar con un worker de reconciliación duradero,Verificar que Qdrant tenga suficiente memoria RAM (4GB+ recomendada) y disco SSD para manejar el tráfico de búsqueda,Implementar rate limiting en la API gateway para proteger contra ataques de DDoS o saturación de peticiones
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.