Démarrer Typesense à partir d'un modèle versionné
Le modèle officiel télécharge le binaire Typesense 30.2 pour amd64 ou arm64, vérifie sa somme de contrôle fixée et génère la clé administrateur initiale hors du dépôt.
Services de données · offres à partir de $10/mois
Déployer Typesense.Gardez la recherche rapide et la clé d'administrateur privée.
Démarrez un serveur Typesense à version fixe, conservez les collections et les documents sur un stockage persistant, protégez la clé administrateur initiale et vérifiez l’indexation ainsi que la recherche avant le lancement.
Conserver le dépôtExaminer la compilation et les journauxDomaines personnalisés et TLS
Déploiement Adios
Version candidate
Typesense
SOURCE
Git
REGION
de
ROUTE
HTTPS
01Source reçue
02Compilation terminée
03Environnement d’exécution démarré
04Vérification de santé réussie
Route promue en production
production.adios.run
Une mise en production adaptée à
Typesense 30.2Recherche en texte intégralRecherche vectorielleClé généréePersistance
Le parcours de mise en production
Même opérationnel, un projet Typesense doit être mis en production en toute sécurité.
L’application ou le service ne représente qu’une partie de la production. Les résultats de compilation, l’état d’exécution, les contrôles de santé, les secrets, les journaux, les routes et la version promue doivent pouvoir être examinés ensemble.
Faire de la persistance une décision explicite
Les collections, documents et index sont stockés sur le volume persistant /app/typesense-data. Sauvegardez cet état et testez la restauration avant de faire de la recherche une dépendance critique.
Garder l'état de service visible pour les opérateurs
Utilisez /health pour vérifier la disponibilité, testez des imports et des requêtes représentatifs et créez des clés limitées à la recherche et au périmètre autorisé, au lieu d’exposer la clé administrateur dans le code du navigateur.
Du code source à la mise en production
Trois étapes vous permettent de vérifier le parcours de déploiement.
Utilisez le code source et le fonctionnement en production déjà définis pour le projet. Le manifeste décrit ce que la plateforme doit compiler ou provisionner et les critères à remplir pour que le résultat soit prêt.
- 01
Commencer par la source ou un modèle
Importez le dépôt existant, ou examinez et déployez l’une des variantes de modèles précisément référencées ci-dessous.
$adios login - 02
Revoir le contrat de déploiement
Consignez dans adios.yaml les commandes, la version de l’environnement d’exécution ou du service, les critères de santé et les références aux secrets.
$git diff -- adios.yaml - 03
Déployer et inspecter le résultat
Suivez les résultats de compilation et d’exécution, vérifiez la version candidate, puis ouvrez la route ou la connexion de service promue en production.
$adios up
adios.yaml
Votre projettype: 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: trueLe modèle complet fixe aussi les sommes de contrôle SHA-256 propres à chaque architecture, réserve de l’espace disque pour la restauration et fixe l’adresse Raft du nœud unique sur l’interface de boucle locale, afin de conserver une identité de pair stable après redémarrage.
Points de départ déployables
Démarrer Typesense à partir d'un modèle lorsque le dépôt n'est pas prêt.
Examinez le modèle Typesense complet, clonez son dépôt autonome ou déployez-le directement avec la clé publique typesense.
Services de données
Typesense 30.2
Typesense 30.2 avec des données de recherche persistantes et une clé d'administrateur générée.
Search APIVersion du projet d’origine
- Clé du modèle
- typesense
- Environnement d’exécution
- pinned binary
- Dépôt
- template-typesense
- Emplacement de la source
- .
git clone https://github.com/adiosdotdev/template-typesense.git
cd template-typesense
adios upAvant production
Vérifier la charge de travail.Puis promouvez la version en production.
Pour sécuriser la première mise en production, partez d’une compilation ou d’une configuration de service reproductible et d’un aperçu qui sollicite les dépendances réellement utilisées en production.
Prêt quand...
- La clé de l'administrateur est stockée à l'extérieur de Git.
- Les clients web utilisent une clé limitée à la recherche et à son périmètre autorisé.
- L’importation et la recherche de documents représentatifs fonctionnent correctement.
- Les responsabilités en matière de sauvegarde et de restauration sont documentées.
Prévisualiser quand...
- Le schéma, le tokenizer, le jeu de synonymes ou les dimensions des vecteurs changent.
- Un import massif peut consommer la majeure partie de l’espace disque disponible.
- La recherche devient indispensable à une opération d’écriture de l’application.
Les réponses à vos questions
Ce qu’il faut savoir avant de déployer Typesense.
Vérifiez les limites de l’environnement d’exécution ou du service, le chemin du modèle, le comportement en cas d’échec et les contrôles de production avant de créer la première version.
Puis-je déployer Typesense à partir d’un modèle officiel ?
Oui. Choisissez le modèle Typesense correspondant à la version ou à la configuration souhaitée, stockez les identifiants dans des secrets Adios et déployez-le depuis la console ou avec adios up.
Le modèle Typesense utilise-t-il un stockage persistant ?
Les collections, documents et index sont stockés sur le volume persistant /app/typesense-data. Sauvegardez cet état et testez la restauration avant de faire de la recherche une dépendance critique.
Un navigateur peut-il utiliser la clé de Typesense générée ?
Non. La valeur générée est la clé administrateur initiale. Conservez-la sur des serveurs de confiance et utilisez l’API de gestion des clés Typesense pour créer une clé limitée à la recherche et au périmètre autorisé pour les clients web.
Le modèle supporte-t-il la recherche vectorielle ?
Oui. Typesense peut stocker et interroger des champs vectoriels en complément de la recherche textuelle. Validez les dimensions, la génération des embeddings, le comportement des filtres et la latence de requêtes représentatives avant le lancement.
Où stocker les mots de passe de la base de données et du broker ?
Stockez les valeurs sensibles dans les secrets Adios et référencez-les avec secret://NAME. Ne placez pas les identifiants de production directement dans adios.yaml et ne les enregistrez pas dans Git.
Que dois-je vérifier avant de recevoir du trafic de production ?
Vérifiez l’authentification, la connectivité applicative, les écritures et lectures, la persistance après redémarrage, les besoins de sauvegarde ou de restauration, la capacité et le comportement en cas d’échec de chaque application dépendante.
Autres options de déploiement
Connectez le reste de votre stack.
Déployer Qdrant
Démarrez un service Qdrant à version fixe sur un seul nœud, conservez les collections et les snapshots sur un stockage persistant, séparez l’accès administrateur de l’accès en lecture seule et testez des requêtes vectorielles représentatives.
Déployer pgvector
Démarrez PostgreSQL avec l’extension pgvector, connectez une application utilisant des embeddings, vérifiez les écritures vectorielles et les recherches de plus proches voisins, puis testez la persistance.
Déployer Node.js
Déployez un processus web ou un worker Node.js persistant à partir de ses scripts de packages existants, avec les contrôles de santé de la version, les journaux, les secrets, le routage et l’historique Git associés.
Déployer Python
Exécutez une application web ou un worker Python en conservant le fichier de dépendances, la commande du processus, la route de contrôle de santé et la configuration alimentée par des secrets avec le code source.
La première version
Déployer Typesense avec le code source et les éléments de vérification associés.
Partez du dépôt ou d’un modèle, vérifiez le contrat de déploiement et examinez la version qui sera promue en production.