113 lines
3.4 KiB
Markdown
113 lines
3.4 KiB
Markdown
# Executor Integration Tests
|
|
|
|
This directory contains integration tests for the Attune executor service.
|
|
|
|
## Test Suites
|
|
|
|
### Policy Enforcer Tests (`policy_enforcer_tests.rs`)
|
|
Tests for policy enforcement including rate limiting, concurrency control, and quota management.
|
|
|
|
**Run**: `cargo test --test policy_enforcer_tests -- --ignored`
|
|
|
|
### FIFO Ordering Integration Tests (`fifo_ordering_integration_test.rs`)
|
|
Comprehensive integration and stress tests for FIFO policy execution ordering.
|
|
|
|
**Run**: `cargo test --test fifo_ordering_integration_test -- --ignored --test-threads=1`
|
|
|
|
## Prerequisites
|
|
|
|
1. **PostgreSQL Running**:
|
|
```bash
|
|
sudo systemctl start postgresql
|
|
```
|
|
|
|
2. **Database Migrations Applied**:
|
|
```bash
|
|
cd /path/to/attune
|
|
sqlx migrate run
|
|
```
|
|
|
|
3. **Configuration**:
|
|
Ensure `config.development.yaml` has correct database URL or set:
|
|
```bash
|
|
export ATTUNE__DATABASE__URL="postgresql://attune:attune@localhost/attune"
|
|
```
|
|
|
|
## Running Tests
|
|
|
|
### All Integration Tests
|
|
```bash
|
|
# Run all executor integration tests (except extreme stress)
|
|
cargo test -- --ignored --test-threads=1
|
|
```
|
|
|
|
### Individual Test Suites
|
|
```bash
|
|
# Policy enforcer tests
|
|
cargo test --test policy_enforcer_tests -- --ignored
|
|
|
|
# FIFO ordering tests
|
|
cargo test --test fifo_ordering_integration_test -- --ignored --test-threads=1
|
|
```
|
|
|
|
### Individual Test with Output
|
|
```bash
|
|
# High concurrency stress test
|
|
cargo test --test fifo_ordering_integration_test test_high_concurrency_stress -- --ignored --nocapture
|
|
|
|
# Multiple workers simulation
|
|
cargo test --test fifo_ordering_integration_test test_multiple_workers_simulation -- --ignored --nocapture
|
|
```
|
|
|
|
### Extreme Stress Test (10k executions)
|
|
```bash
|
|
# This test takes 5-10 minutes - run separately
|
|
cargo test --test fifo_ordering_integration_test test_extreme_stress_10k_executions -- --ignored --nocapture --test-threads=1
|
|
```
|
|
|
|
## Test Organization
|
|
|
|
- **Unit Tests**: Located in `src/` files (e.g., `queue_manager.rs`)
|
|
- **Integration Tests**: Located in `tests/` directory
|
|
- All tests requiring database are marked with `#[ignore]`
|
|
|
|
## Important Notes
|
|
|
|
- Use `--test-threads=1` for integration tests to avoid database contention
|
|
- Tests create unique data using timestamps to avoid conflicts
|
|
- All tests clean up their test data automatically
|
|
- Stress tests output progress messages and performance metrics
|
|
|
|
## Troubleshooting
|
|
|
|
### Database Connection Issues
|
|
```
|
|
Error: Failed to connect to database
|
|
```
|
|
**Solution**: Ensure PostgreSQL is running and connection URL is correct.
|
|
|
|
### Queue Full Errors
|
|
```
|
|
Error: Queue full (max length: 10000)
|
|
```
|
|
**Solution**: This is expected for `test_queue_full_rejection`. Other tests should not see this.
|
|
|
|
### Test Data Not Cleaned Up
|
|
If tests crash, manually clean up:
|
|
```sql
|
|
DELETE FROM attune.queue_stats WHERE action_id IN (
|
|
SELECT id FROM attune.action WHERE pack IN (
|
|
SELECT id FROM attune.pack WHERE ref LIKE 'fifo_test_pack_%'
|
|
)
|
|
);
|
|
DELETE FROM attune.execution WHERE action IN (SELECT id FROM attune.action WHERE pack IN (SELECT id FROM attune.pack WHERE ref LIKE 'fifo_test_pack_%'));
|
|
DELETE FROM attune.action WHERE pack IN (SELECT id FROM attune.pack WHERE ref LIKE 'fifo_test_pack_%');
|
|
DELETE FROM attune.pack WHERE ref LIKE 'fifo_test_pack_%';
|
|
```
|
|
|
|
## Documentation
|
|
|
|
For detailed test descriptions and execution plans, see:
|
|
- `work-summary/2025-01-fifo-integration-tests.md`
|
|
- `docs/testing-status.md` (Executor Service section)
|