サーバー概要

laurus-server クレートは、Laurus 検索エンジン用の gRPC サーバーとオプションの HTTP/JSON ゲートウェイを提供します。エンジンをメモリに常駐させることで、コマンド実行ごとの起動オーバーヘッドを排除します。

機能

永続エンジン – インデックスはリクエスト間で開いたまま維持され、呼び出しごとの WAL リプレイが不要
フル gRPC API – インデックス管理、ドキュメント CRUD、コミット、検索（単発 + ストリーミング）
HTTP ゲートウェイ – gRPC と併用可能なオプションの HTTP/JSON ゲートウェイで REST スタイルのアクセスを提供
ヘルスチェック – ロードバランサーやオーケストレーター向けの標準ヘルスチェックエンドポイント
グレースフルシャットダウン – Ctrl+C / SIGINT で保留中の変更を自動的にコミット
TOML 設定 – オプションの設定ファイルと CLI・環境変数によるオーバーライド

アーキテクチャ

graph LR
    subgraph "laurus-server"
        GW["HTTP Gateway\n(axum)"]
        GRPC["gRPC Server\n(tonic)"]
        ENG["Engine\n(Arc&lt;RwLock&gt;)"]
    end

    Client1["HTTP Client"] --> GW
    Client2["gRPC Client"] --> GRPC
    GW --> GRPC
    GRPC --> ENG

gRPC サーバーは常に起動します。HTTP ゲートウェイはオプションで、HTTP/JSON リクエストを内部的に gRPC サーバーへプロキシします。

クイックスタート

# デフォルト設定で起動（gRPC ポート 50051）
laurus serve

# HTTP ゲートウェイ付きで起動
laurus serve --http-port 8080

# 設定ファイルを指定して起動
laurus serve --config config.toml

セクション

はじめに – 起動オプションと最初のステップ
設定 – TOML 設定、環境変数、優先順位
gRPC API リファレンス – 全サービスと RPC の完全な API ドキュメント
HTTP ゲートウェイ – HTTP/JSON エンドポイントリファレンス