Inicia Qdrant desde una plantilla versionada
La plantilla oficial descarga el binario estático de Qdrant 1.19.0 para amd64 o arm64, verifica su suma de comprobación fijada y genera claves de API separadas para administrador y solo lectura.
Servicios de datos · Planes desde $10/mes
Despliega Qdrant.Protege el almacén vectorial y verifica la recuperación de información.
Inicia un servicio Qdrant de un solo nodo con una versión fijada, conserva las colecciones y las instantáneas de forma persistente, separa el acceso de administrador del de solo lectura y prueba consultas vectoriales representativas.
Conserva el repositorioInspeccionar la compilación y los registrosDominios personalizados y TLS
Despliegue de Adios
Versión candidata
Qdrant
CÓDIGO FUENTE
Git
REGION
de
ROUTE
HTTPS
01Código fuente recibido
02Compilación completada
03Entorno de ejecución iniciado
04Control de salud aprobado
Ruta promovida
production.adios.run
Un camino de producción para
Qdrant 1.19.0Base de datos vectorialREST + gRPCClaves generadasPersistencia
El camino de producción
Un proyecto Qdrant funcional aún necesita un lanzamiento seguro.
La aplicación o el servicio son solo una parte de producción. Las pruebas de compilación, el estado del entorno de ejecución, la salud, los secretos, los registros, las rutas y la versión promovida deben permanecer disponibles para inspección conjunta.
Decide la persistencia de forma explícita
Las colecciones, los índices y las instantáneas locales se almacenan en /app/qdrant-data, en almacenamiento persistente. Haz copias de seguridad de ese volumen y prueba la recuperación de instantáneas antes de depender de él para la recuperación de información en producción.
Mantén el estado del servicio visible para los operadores
Usa /healthz para comprobar la disponibilidad, prueba REST o gRPC con vectores y filtros representativos y transmite cada clave de API mediante HTTPS o una ruta de red privada.
Del código fuente al lanzamiento
Tres pasos mantienen el camino de despliegue disponible para revisión.
Usa el código fuente y el comportamiento de producción que ya tiene el proyecto. El manifiesto registra lo que la plataforma debe compilar o aprovisionar y cómo llega a estar listo el resultado.
- 01
Empieza con código fuente o una plantilla
Trae el repositorio existente o inspecciona y despliega una de las variantes exactas de plantillas iniciales enlazadas abajo.
$adios login - 02
Revisar el contrato de despliegue
Mantén los comandos, la versión del entorno de ejecución o servicio, el comportamiento de salud y las referencias a secretos en adios.yaml.
$git diff -- adios.yaml - 03
Desplegar e inspeccionar el resultado
Sigue las pruebas de compilación y ejecución, verifica la versión candidata y abre la ruta promovida o la conexión del servicio.
$adios up
adios.yaml
Tu proyectotype: database
env:
QDRANT__SERVICE__API_KEY: secret://QDRANT_API_KEY
QDRANT__SERVICE__READ_ONLY_API_KEY: secret://QDRANT_READ_ONLY_API_KEY
secrets:
QDRANT_API_KEY: secret://generate:64
QDRANT_READ_ONLY_API_KEY: secret://generate:64
build_cmd: sh /app/install-qdrant.sh
start_cmd: cd /app/qdrant-data && exec /app/qdrant-server --config-path /app/qdrant.yaml
port:
- 6333
- 6334
runtime:
health_path: /healthz
volumes:
- name: qdrant-data
target: /app/qdrant-data
persistent: trueEl proyecto inicial completo desactiva el clustering, las URL remotas de instantáneas y la telemetría de uso para su configuración deliberada de un solo nodo.
Puntos de partida desplegables
Empieza con Qdrant desde una plantilla cuando el repositorio no esté listo.
Inspecciona el proyecto inicial completo de Qdrant, clona su repositorio independiente o despliégalo directamente con la clave pública qdrant.
Servicios de datos
Qdrant 1.19.0
Qdrant 1.19.0 con datos vectoriales persistentes y claves generadas de administrador y de solo lectura.
Vector APIVersión del proyecto original
- Clave de plantilla
- qdrant
- Entorno de ejecución
- pinned binary
- Repositorio
- template-qdrant
- Ruta de código fuente
- .
git clone https://github.com/adiosdotdev/template-qdrant.git
cd template-qdrant
adios upAntes de la producción
Verifica la carga de trabajo.Después, promuévelo.
El primer lanzamiento más seguro empieza con una compilación o configuración de servicio reproducible y una vista previa que pruebe las dependencias que usará producción.
Listo cuando...
- Los clientes administradores y de solo lectura usan claves distintas.
- Las dimensiones vectoriales y las métricas de distancia son intencionales.
- Pasan las pruebas de escritura, filtros y búsqueda con datos representativos.
- Se documenta quién se encarga de las instantáneas y la restauración.
Previsualiza cuando…
- Un modelo de embeddings cambia la dimensión de los vectores.
- Reconstruir una colección o realizar una importación masiva cambia las necesidades de espacio en disco.
- La carga de trabajo necesita alta disponibilidad con varios nodos.
Preguntas, respuestas
Qué saber antes de desplegar Qdrant.
Revisa el límite del entorno de ejecución o servicio, la ruta de la plantilla, el comportamiento de fallos y las comprobaciones de producción antes de crear el primer lanzamiento.
¿Puedo desplegar Qdrant desde una plantilla oficial?
Sí. Elige la plantilla de Qdrant que coincida con la versión o configuración que necesites, guarda las credenciales como secretos de Adios y despliégala desde la consola o con adios up.
¿Usa almacenamiento persistente la plantilla de Qdrant?
Las colecciones, los índices y las instantáneas locales se almacenan en /app/qdrant-data, en almacenamiento persistente. Haz copias de seguridad de ese volumen y prueba la recuperación de instantáneas antes de depender de él para la recuperación de información en producción.
¿Qué puertos de Qdrant expone la plantilla?
La API REST y el panel usan el puerto 6333, mientras que gRPC usa el puerto 6334. La ruta HTTPS principal sirve la interfaz REST; conecta gRPC solo mediante una ruta de red aprobada.
¿Es este un despliegue de Qdrant en clúster?
No. El proyecto inicial establece explícitamente una base de un solo nodo. Diseña y prueba una topología multinodo específica cuando la carga de trabajo necesite alta disponibilidad más allá de conservar los datos tras un reinicio.
¿Dónde deben guardarse las contraseñas de la base de datos y del broker?
Guarda los valores sensibles en secretos de Adios y haz referencia a ellos con secret://NAME. No incluyas credenciales de producción directamente en adios.yaml ni las guardes en Git.
¿Qué debo verificar antes del tráfico de producción?
Verifica la autenticación, la conectividad de la aplicación, las escrituras y lecturas, la persistencia tras reiniciar, las expectativas de copia de seguridad o recuperación, la capacidad y el comportamiento ante fallos de cada aplicación dependiente.
Opciones de despliegue relacionadas
Conecta el resto de la pila.
Desplegar Typesense
Inicia un servidor Typesense con una versión fijada, conserva las colecciones y los documentos de forma persistente, protege la clave de administrador inicial y verifica la indexación y la búsqueda antes del lanzamiento.
Desplegar pgvector
Inicia PostgreSQL con la extensión pgvector, conecta una aplicación de embeddings, verifica las escrituras de vectores y las consultas de vecinos más cercanos, y prueba la persistencia.
Desplegar FastAPI
Despliega un servicio FastAPI con su destino de importación ASGI, instalación de dependencias, puerto de ejecución, endpoint de comprobación de estado, secretos y lanzamiento promocionado vinculados al código fuente.
Desplegar Node.js
Despliega un proceso web o worker persistente de Node.js a partir de sus scripts de paquetes existentes, con el estado del lanzamiento, los registros, los secretos, las rutas y el historial de Git vinculados al proyecto.
La primera versión
Desplegar Qdrant con el código fuente y las pruebas vinculados.
Parte del repositorio o de una plantilla, revisa el contrato de despliegue e inspecciona lo que se convierte en la versión promovida de producción.