cf2ade186a
Add comprehensive integration tests for plan §8 requirements: - Document round-trip: 1000 docs indexed and retrieved, verified distributed across ≥2 nodes - Search covers all shards: 100 docs with unique keywords, each search returns 1 hit - Facet aggregation: 100 docs across 3 colors, facet counts sum to 100 - Offset/limit paging: 50 docs, 5 pages of 10 match single limit=50 query - Settings broadcast: synonyms propagated to all 3 nodes - Task polling: 500 doc batch, poll until succeeded - Node failure with RF=2: marked #[ignore], requires docker-compose-dev-rf2.yml All tests use docker-compose-dev stack (3 Meilisearch nodes + Miroir). Closes: bf-45zni Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com> |
||
|---|---|---|
| .. | ||
| integration.rs | ||
| README.md | ||
Miroir Integration Tests
End-to-end integration tests for Miroir with 3 Meilisearch nodes via docker-compose.
Per plan §8: Integration tests validate end-to-end behavior including:
- Document round-trip with distribution verification
- Search covers all shards
- Facet aggregation across shards
- Offset/limit paging consistency
- Settings broadcast to all nodes
- Task polling for large batches
- Node failure with RF=2
Prerequisites
Start the docker-compose dev stack:
cd /home/coding/miroir/examples
docker-compose -f docker-compose-dev.yml up -d
Wait for all services to be healthy (check with docker-compose ps).
Running Tests
All integration tests
cd /home/coding/miroir
cargo test --test integration -- --test-threads=1
Important: Use --test-threads=1 to prevent concurrent tests from interfering with each other (they share indexes).
Individual tests
cargo test --test integration document_round_trip -- --test-threads=1
cargo test --test integration search_covers_all_shards -- --test-threads=1
cargo test --test integration facet_aggregation -- --test-threads=1
cargo test --test integration offset_limit_paging -- --test-threads=1
cargo test --test integration settings_broadcast -- --test-threads=1
cargo test --test integration task_polling -- --test-threads=1
Node failure test (requires RF=2 stack)
The node_failure_rf2 test requires the RF=2 docker-compose stack with 6 nodes:
cd /home/coding/miroir/examples
docker-compose -f docker-compose-dev-rf2.yml up -d
Then run:
MIROIR_RF2_PORT=7700 cargo test --test integration node_failure_rf2 -- --test-threads=1 --ignored
Test Descriptions
| Test | Description | Expected Behavior |
|---|---|---|
document_round_trip |
Index 1000 documents, retrieve each by ID | All documents found; distributed across ≥2 nodes |
search_covers_all_shards |
Index 100 docs with unique keywords, search each | Every search returns exactly 1 hit |
facet_aggregation |
100 docs across 3 colors, facet by color | Facet counts sum to 100 |
offset_limit_paging |
50 docs, compare 5×paged vs single limit=50 | Same documents, same order, no duplicates |
settings_broadcast |
Add synonyms, verify on all 3 nodes | All nodes have synonyms; synonym search works |
task_polling |
Index 500 docs, poll until succeeded | Task succeeds; all 500 docs searchable |
node_failure_rf2 |
With RF=2, verify search works with 1 node down | All results returned; no degraded header |
Troubleshooting
Connection refused: Ensure docker-compose stack is running:
docker-compose -f ../docker-compose-dev.yml ps
Tests timeout: Increase health check timeout in ensure_healthy().
Index already exists: Tests clean up existing indices automatically.
Node failure test fails: Ensure the RF=2 stack is running with 6 nodes + Redis.