Avvia Typesense da un modello versionato
Il modello ufficiale scarica il binario Typesense 30.2 per amd64 o arm64, verifica il checksum fissato e genera la chiave di amministrazione iniziale fuori dal controllo di versione.
Servizi di dati · piani da $10/mese
Distribuisci Typesense.Mantieni la ricerca veloce e la chiave di amministrazione privata.
Avvia un server Typesense con versione bloccata, conserva raccolte e documenti, proteggi la chiave di amministrazione iniziale e verifica indicizzazione e ricerca prima del lancio.
Mantieni il repositoryEsamina compilazione e logDomini personalizzati e TLS
Distribuzione con Adios
Versione candidata
Typesense
SORGENTE
Git
REGION
de
ROUTE
HTTPS
01Codice sorgente ricevuto
02Compilazione completata
03Ambiente di esecuzione avviato
04Controllo di integrità superato
Route promossa
production.adios.run
Un percorso verso la produzione per
Typesense 30.2Ricerca full-textRicerca vettorialeChiave generataPersistenza
Il percorso di produzione
Un progetto Typesense funzionante ha ancora bisogno di un rilascio sicuro.
L'applicazione o il servizio è solo una parte della produzione. Le evidenze della compilazione, lo stato dell'ambiente di esecuzione, l'integrità, i segreti, i log, le route e la versione promossa devono restare consultabili insieme.
Scegli esplicitamente come gestire la persistenza
Raccolte, documenti e indici si trovano sul volume persistente /app/typesense-data. Esegui un backup di questo stato e prova il ripristino prima che la ricerca diventi una dipendenza critica.
Mantieni lo stato del servizio visibile agli operatori
Usa /health per verificare la prontezza, testa importazioni e query rappresentative e crea chiavi di sola ricerca con ambito limitato, invece di esporre la chiave di amministrazione nel codice del browser.
Dal codice sorgente al rilascio
Tre passaggi mantengono il percorso di distribuzione verificabile.
Usa il codice sorgente e il comportamento di produzione già previsti dal progetto. Il manifesto indica cosa la piattaforma deve compilare o provisionare e come verificare che il risultato sia pronto.
- 01
Parti dal codice sorgente o da un modello
Porta il repository esistente oppure esamina e distribuisci una delle varianti dei modelli iniziali indicate nei link qui sotto.
$adios login - 02
Verifica il contratto di distribuzione
Mantieni in adios.yaml i comandi, la versione dell'ambiente di esecuzione o del servizio, il comportamento dei controlli di integrità e i riferimenti ai segreti.
$git diff -- adios.yaml - 03
Distribuisci e verifica il risultato
Segui le evidenze della compilazione e dell'esecuzione, verifica la versione candidata e apri la route promossa o la connessione al servizio.
$adios up
adios.yaml
Il tuo progettotype: 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: trueIl modello iniziale completo fissa anche checksum SHA-256 specifici per architettura, riserva spazio libero sul disco per il ripristino e imposta l'indirizzo Raft del singolo nodo su loopback, così i riavvii mantengono stabile l'identità del peer.
Punti di partenza pronti per la distribuzione
Avvia Typesense da un modello quando il repository non è pronto.
Esamina il modello iniziale Typesense completo, clona il repository autonomo oppure distribuiscilo direttamente con la chiave pubblica typesense.
Servizi di dati
Typesense 30.2
Typesense 30.2 con dati di ricerca persistenti e una chiave amministratore generata.
Search APIVersione upstream
- Chiave modello
- typesense
- Ambiente di esecuzione
- pinned binary
- Repository
- template-typesense
- Percorso sorgente
- .
git clone https://github.com/adiosdotdev/template-typesense.git
cd template-typesense
adios upPrima della produzione
Verifica il carico di lavoro.Poi promuovilo.
Il primo rilascio più sicuro parte da una compilazione o configurazione del servizio riproducibile e da un'anteprima che mette alla prova le dipendenze effettivamente usate in produzione.
Sei pronto quando…
- La chiave dell'amministratore viene memorizzata al di fuori di Git.
- I client nel browser usano una chiave limitata alla sola ricerca e al relativo ambito autorizzato.
- I documenti rappresentativi vengono importati e ricercati correttamente.
- Le responsabilità di backup e ripristino sono documentate.
Verifica in anteprima quando…
- Cambiano lo schema, il tokenizer, l'insieme dei sinonimi o la dimensione dei vettori.
- Un'importazione di massa può consumare la maggior parte dello spazio su disco disponibile.
- La ricerca diventa necessaria per un'operazione di scrittura dell'applicazione.
Risposte alle tue domande
Cosa sapere prima di distribuire Typesense.
Verifica i limiti dell'ambiente di esecuzione o del servizio, il percorso del modello, il comportamento in caso di errore e i controlli di produzione prima di creare il primo rilascio.
Posso distribuire Typesense da un modello ufficiale?
Sì. Scegli il modello Typesense corrispondente alla versione o configurazione necessaria, salva le credenziali come segreti Adios e distribuiscilo dalla console o con adios up.
Il modello Typesense usa archiviazione persistente?
Raccolte, documenti e indici si trovano sul volume persistente /app/typesense-data. Esegui un backup di questo stato e prova il ripristino prima che la ricerca diventi una dipendenza critica.
Un browser può usare la chiave Typesense generata?
No. Il valore generato è la chiave di amministrazione iniziale. Mantienila su server fidati e usa l'API delle chiavi Typesense per creare una chiave di sola ricerca con ambito limitato per i client nel browser.
Il modello supporta la ricerca vettoriale?
Sì. Typesense può archiviare e interrogare campi vettoriali insieme alla ricerca testuale. Verifica dimensioni, generazione degli embedding, comportamento dei filtri e latenza di query rappresentative prima del lancio.
Dove devono essere memorizzate le password di database e broker?
Conserva i valori sensibili nei segreti Adios e referenziali con secret://NAME. Non inserire credenziali di produzione direttamente in adios.yaml e non salvarle in commit Git.
Cosa devo verificare prima del traffico di produzione?
Verifica autenticazione, connettività dell'applicazione, scritture e letture, persistenza dopo il riavvio, requisiti di backup o ripristino, capacità e comportamento in caso di errore di ogni applicazione dipendente.
Percorsi di distribuzione correlati
Collega il resto dello stack.
Distribuisci Qdrant
Avvia un servizio Qdrant a nodo singolo con versione bloccata, conserva raccolte e snapshot, separa l'accesso amministrativo da quello di sola lettura e testa query vettoriali rappresentative.
Distribuisci pgvector
Avvia PostgreSQL con l'estensione pgvector, collega un'applicazione che usa embedding, verifica le scritture vettoriali e le query dei vicini più prossimi e testa la persistenza.
Distribuisci Node.js
Distribuisci un processo web o un worker Node.js persistente dagli script di pacchetto esistenti, mantenendo associati integrità del rilascio, log, segreti, routing e cronologia Git.
Distribuisci Python
Esegui un'app web o un worker Python mantenendo il file delle dipendenze, il comando del processo, la route di integrità e la configurazione protetta da segreti accanto al codice sorgente.
Il primo rilascio
Distribuisci Typesense con il codice sorgente e le evidenze associati.
Parti dal repository o da un modello, verifica il contratto di distribuzione ed esamina la versione promossa in produzione.