Commit Graph
1 Commits
Author SHA1 Message Date
Story Crater Bot 83b9dcf5f9 docs: OpenSearch Deployment & Operations Guide
Complete guide for OpenSearch + Dashboards production operations:

 Quick Start (5 steps):
  1. Verify cluster health (curl _cluster/health)
  2. Access Dashboards UI (port-forward 5601)
  3. Configure Memory Service (OPENSEARCH_HOSTS env var)
  4. Test vault endpoints (vault.riotpiao.com)
  5. Test hybrid search (/memory/query)

📊 Operations:
  - Health checks and monitoring
  - Troubleshooting: pods not starting, yellow/red status, connection issues
  - Performance tuning: JVM memory, shard config
  - Backup & recovery procedures
  - Security hardening checklist (production)

🔐 Security:
  - TODO items for production deployment
  - Dashboards password change
  - OpenSearch security plugin enable
  - OAuth2/SAML integration

📈 Integration:
  - Architecture diagram (pgvector + OpenSearch)
  - Query flow explanation
  - Graceful degradation scenarios
  - Dependency management

🔧 Useful Commands:
  - Health status queries
  - Index management
  - Pod logs and resource usage
  - PVC monitoring

Deployment checklist:
  Phase 1:  OpenSearch deployed
  Phase 2: 🔄 Configure Memory Service (NEXT)
  Phase 3: 🔄 Test endpoints
  Phase 4:  Production hardening
2026-08-27 21:12:10 -07:00