Inicia Typesense desde una plantilla versionada
La plantilla oficial descarga el binario de Typesense 30.2 para amd64 o arm64, verifica su suma de comprobación fijada y genera la clave de administrador inicial fuera del control de versiones.
Servicios de datos · Planes desde $10/mes
Despliega Typesense.Mantén la búsqueda rápida y la clave de administrador privada.
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.
Conserva el repositorioInspeccionar la compilación y los registrosDominios personalizados y TLS
Despliegue de Adios
Versión candidata
Typesense
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
Typesense 30.2Búsqueda de texto completoBúsqueda vectorialClave generadaPersistencia
El camino de producción
Un proyecto Typesense 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 documentos y los índices se almacenan en el volumen persistente /app/typesense-data. Haz copias de seguridad de ese estado y ensaya su recuperación antes de que la búsqueda sea una dependencia crítica.
Mantén el estado del servicio visible para los operadores
Usa /health para comprobar la disponibilidad, prueba importaciones y consultas representativas y crea claves con permisos limitados a búsquedas, en lugar de exponer la clave de administrador en el código del navegador.
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: search
secrets:
TYPESENSE_API_KEY: secret://generate:64
build_cmd: sh /app/install-typesense.sh
start_cmd: exec /app/typesense-server
port: 8108
env:
TYPESENSE_API_KEY: secret://TYPESENSE_API_KEY
TYPESENSE_DATA_DIR: /app/typesense-data
TYPESENSE_PEERING_ADDRESS: 127.0.0.1
runtime:
health_path: /health
volumes:
- name: typesense-data
target: /app/typesense-data
persistent: trueEl proyecto inicial completo también fija sumas de comprobación SHA-256 específicas de cada arquitectura, reserva espacio libre en disco para la recuperación y fija la dirección Raft del nodo único a la interfaz loopback para que los reinicios conserven una identidad de par estable.
Puntos de partida desplegables
Empieza con Typesense desde una plantilla cuando el repositorio no esté listo.
Inspecciona el proyecto inicial completo de Typesense, clona su repositorio independiente o despliégalo directamente con la clave pública typesense.
Servicios de datos
Typesense 30.2
Typesense 30.2 con datos de búsqueda persistentes y una clave de administrador generada.
Search APIVersión del proyecto original
- Clave de plantilla
- typesense
- Entorno de ejecución
- pinned binary
- Repositorio
- template-typesense
- Ruta de código fuente
- .
git clone https://github.com/adiosdotdev/template-typesense.git
cd template-typesense
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...
- La clave de administrador está almacenada fuera de Git.
- Los clientes del navegador usan una clave con permisos limitados a búsquedas.
- Los documentos representativos se importan y se buscan correctamente.
- Se documenta quién se encarga de las copias de seguridad y la restauración.
Previsualiza cuando…
- Cambia el esquema, el tokenizador, el conjunto de sinónimos o la dimensión de los vectores.
- Una importación masiva puede consumir la mayor parte del espacio disponible en disco.
- La búsqueda pasa a ser necesaria para una ruta de escritura de la aplicación.
Preguntas, respuestas
Qué saber antes de desplegar Typesense.
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 Typesense desde una plantilla oficial?
Sí. Elige la plantilla de Typesense 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 Typesense?
Las colecciones, los documentos y los índices se almacenan en el volumen persistente /app/typesense-data. Haz copias de seguridad de ese estado y ensaya su recuperación antes de que la búsqueda sea una dependencia crítica.
¿Puede un navegador usar la clave de Typesense generada?
No. El valor generado es la clave de administrador inicial. Consérvala en servidores de confianza y usa la API de claves de Typesense para crear una clave con permisos limitados a búsquedas para los clientes del navegador.
¿La plantilla soporta la búsqueda de vectores?
Sí. Typesense puede almacenar y consultar campos vectoriales junto con la búsqueda de texto. Valida las dimensiones, la generación de embeddings, el comportamiento de los filtros y la latencia de consultas representativas antes del lanzamiento.
¿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 Qdrant
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.
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 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.
Desplegar Python
Ejecuta una aplicación web o un worker de Python con el archivo de dependencias, el comando del proceso, la ruta de comprobación de estado y la configuración mediante secretos junto al código fuente.
La primera versión
Desplegar Typesense 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.