Add production rollout tooling and semantic index ops docs
Capture the production plugin rollout workflow and Qdrant validation steps so operations stay repeatable. Also harden redMCP stdio/schema compatibility to keep diverse MCP clients and validators working.
This commit is contained in:
@@ -38,6 +38,28 @@ SEMANTIC_INDEX_OVERLAP_MINUTES=15
|
||||
Keep `OPENAI_API_KEY`, `QDRANT_URL`, `REDMINE_URL`, and `REDMINE_API_KEY` in the
|
||||
existing `.env` workflow or in the service manager environment.
|
||||
|
||||
Current WireGuard addressing used by this environment:
|
||||
|
||||
- production server: `10.11.0.100`
|
||||
- LAN server: `10.11.0.105`
|
||||
|
||||
If Qdrant stays on the LAN server, set:
|
||||
|
||||
```sh
|
||||
QDRANT_URL=http://10.11.0.105:6333
|
||||
```
|
||||
|
||||
Keep Qdrant bound to the WireGuard/LAN path only and protect it with
|
||||
`QDRANT_API_KEY`.
|
||||
|
||||
From the production server, run `./validate_qdrant.py` to verify Qdrant liveness,
|
||||
readiness, auth, and a minimal create/upsert/read/delete round trip.
|
||||
|
||||
```sh
|
||||
QDRANT_API_KEY=... ./validate_qdrant.py
|
||||
./validate_qdrant.py --skip-write-test
|
||||
```
|
||||
|
||||
For production-style deployment, use `/opt/semantic-index` for code,
|
||||
`/etc/semantic-index.env` for service environment, `/var/lib/semantic-index`
|
||||
for refresh state, and `/var/log/semantic-index` for refresh logs. Systemd
|
||||
|
||||
Reference in New Issue
Block a user