Comece Qdrant a partir de um modelo versionado
O modelo oficial baixa o binário estático Qdrant 1.19.0 para amd64 ou arm64, verifica seu checksum fixado e gera chaves API separadas de administrador e de somente leitura.
Inicie um serviço Qdrant de nó único com versão fixada, persista coleções e snapshots, separe o acesso administrativo do acesso somente leitura e teste consultas vetoriais representativas.
Versão candidata
Qdrant
FONTE
Git
REGION
de
ROUTE
HTTPS
01Código-fonte recebido
02Compilação concluída
03Ambiente de execução iniciado
04Verificação de saúde aprovada
Rota promovida
production.adios.run
Um caminho até a produção para
O caminho até a produção
A aplicação ou o serviço é apenas uma parte da produção. As evidências de compilação, o estado do ambiente de execução, a saúde, os segredos, os logs, as rotas e a versão promovida devem poder ser examinados em conjunto.
O modelo oficial baixa o binário estático Qdrant 1.19.0 para amd64 ou arm64, verifica seu checksum fixado e gera chaves API separadas de administrador e de somente leitura.
Coleções, índices e snapshots locais ficam em /app/qdrant-data, no armazenamento persistente. Faça backup desse volume e teste a recuperação de snapshots antes de depender dele para buscas em produção.
Use /healthz para verificar a prontidão, teste REST ou gRPC com vetores e filtros representativos e transmita todas as chaves API apenas por HTTPS ou por um caminho de rede privada.
Do código-fonte à versão publicada
Use o código-fonte e o comportamento de produção que o projeto já tem. O manifesto registra o que a plataforma deve compilar ou provisionar e como verificar se o resultado está pronto.
Traga o repositório existente ou examine e implante uma das variantes específicas de projeto inicial vinculadas abaixo.
$adios loginMantenha os comandos, a versão do ambiente de execução ou do serviço, o comportamento das verificações de saúde e as referências a segredos em adios.yaml.
$git diff -- adios.yamlAcompanhe as evidências de compilação e execução, verifique a versão candidata e abra a rota promovida ou a conexão do serviço.
$adios uptype: 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: truePontos de partida prontos para implantação
Examine o projeto inicial Qdrant completo, clone seu repositório independente ou implante-o diretamente com a chave pública qdrant.
Serviços de dados
Qdrant 1.19.0 com dados vetoriais persistentes e chaves geradas de administrador e somente leitura.
git clone https://github.com/adiosdotdev/template-qdrant.git
cd template-qdrant
adios upAntes da produção
O caminho mais seguro para a primeira implantação começa com uma compilação ou configuração de serviço reproduzível e uma prévia que teste as dependências que serão realmente usadas em produção.
Respostas às suas perguntas
Revise os limites do ambiente de execução ou do serviço, o caminho do modelo, o comportamento em caso de falha e as verificações de produção antes de criar a primeira versão.
Sim. Escolha o modelo Qdrant correspondente à versão ou configuração necessária, armazene as credenciais como segredos Adios e implante pelo console ou com adios up.
Coleções, índices e snapshots locais ficam em /app/qdrant-data, no armazenamento persistente. Faça backup desse volume e teste a recuperação de snapshots antes de depender dele para buscas em produção.
A API REST e o painel usam a porta 6333, enquanto gRPC usa a porta 6334. A rota HTTPS principal serve a interface REST; conecte gRPC somente por um caminho de rede aprovado.
Não. O projeto inicial define explicitamente uma configuração básica de nó único. Projete e teste uma topologia dedicada com vários nós quando a carga de trabalho exigir alta disponibilidade além da persistência após reinícios.
Armazene valores sensíveis nos segredos Adios e faça referência a eles com secret://NAME. Não coloque credenciais de produção diretamente em adios.yaml nem as versione no Git.
Verifique autenticação, conectividade da aplicação, gravações e leituras, persistência após reinícios, expectativas de backup ou recuperação, capacidade e comportamento de falha de cada aplicação dependente.
Outros caminhos de implantação
Inicie um servidor Typesense com versão fixada, persista coleções e documentos, proteja a chave de administrador inicial e verifique a indexação e a busca antes do lançamento.
Inicie PostgreSQL com a extensão pgvector, conecte uma aplicação de embeddings, verifique gravações de vetores e consultas de vizinhos mais próximos e teste a persistência.
Implante um serviço FastAPI com o alvo de importação ASGI, a instalação de dependências, a porta de execução, o endpoint de saúde, os segredos e a versão promovida vinculados ao código-fonte.
Implante um processo web ou worker Node.js persistente a partir dos scripts de pacote existentes, com a saúde da versão, os logs, os segredos, o roteamento e o histórico Git vinculados.
A primeira versão
Comece pelo repositório ou por um modelo, revise o contrato de implantação e examine o que será promovido à versão de produção.