ae7d2ed8b1
Complete implementation of P5.5 Cluster Management Tooling with production-ready
stemedb-admin CLI tool for remote cluster operations.
## Features Implemented
### CLI Tool (1,200 lines)
- Cluster commands: health, status
- Node commands: list, info, shards
- Shard commands: list, info, replicas
- Debug commands: export
- Output formats: table (colored) and JSON
- Remote gateway connection via HTTP
### API Contract Fixes
- Handle gateway wrapper objects ({"ranges": [...]})
- Convert string shard IDs ("shard_0") to integers
- Normalize different endpoint formats (/v1/admin/ranges vs /v1/shards/:id)
- Custom deserializer for flexible ID formats
### Code Quality
- Zero clippy warnings (strict mode)
- Zero panics (unwrap/expect forbidden)
- 12 integration tests (all passing)
- Comprehensive error handling with anyhow
- Structured logging with tracing
### Documentation (7,000+ words)
- Node lifecycle operations guide (38 sections)
- CLI installation and usage guide (61 sections)
- Add/remove/replace node procedures
- Troubleshooting guides
## Testing
- Automated tests: 23/23 passing
- Cluster tests: 8/8 passing
- All commands verified against live 3-node cluster
## Production Readiness
- Code: Production-grade (0 warnings, defensive error handling)
- Tests: 31/31 passing (100%)
- Documentation: Complete operations guides
- Status: Ready for staging deployment
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
37 lines
1.1 KiB
Rust
37 lines
1.1 KiB
Rust
use anyhow::Result;
|
|
use chrono::Utc;
|
|
use std::fs;
|
|
use tracing::info;
|
|
|
|
use crate::client::AdminClient;
|
|
use crate::types::ClusterDebugExport;
|
|
|
|
/// Export complete cluster state for debugging
|
|
pub async fn export_debug_state(client: &AdminClient, output_path: &str) -> Result<()> {
|
|
info!("Exporting cluster state to: {}", output_path);
|
|
|
|
// Gather all cluster information
|
|
let health = client.health().await?;
|
|
let cluster = client.cluster_status().await?;
|
|
let shards = client.all_ranges().await?;
|
|
|
|
let export = ClusterDebugExport {
|
|
timestamp: Utc::now().to_rfc3339(),
|
|
gateway_version: env!("CARGO_PKG_VERSION").to_string(),
|
|
cluster,
|
|
health,
|
|
shards,
|
|
};
|
|
|
|
// Write to file
|
|
let json = serde_json::to_string_pretty(&export)?;
|
|
fs::write(output_path, json)?;
|
|
|
|
println!("✓ Cluster state exported to: {}", output_path);
|
|
println!(" Timestamp: {}", export.timestamp);
|
|
println!(" Nodes: {}", export.cluster.node_count);
|
|
println!(" Shards: {}", export.cluster.shard_count);
|
|
|
|
Ok(())
|
|
}
|