aspire-integration-testing

1# Integration Testing with .NET Aspire + xUnit
2 
3## When to Use This Skill
4 
5Use this skill when:
6- Writing integration tests for .NET Aspire applications
7- Testing ASP.NET Core apps with real database connections
8- Verifying service-to-service communication in distributed applications
9- Testing with actual infrastructure (SQL Server, Redis, message queues) in containers
10- Combining Playwright UI tests with Aspire-orchestrated services
11- Testing microservices with proper service discovery and networking
12 
13## Reference Files
14 
15- [advanced-patterns.md](advanced-patterns.md): Endpoint discovery, database testing, Playwright, conditional config, Respawn, service communication, message queues
16- [ci-and-tooling.md](ci-and-tooling.md): CI/CD integration, custom resource waiters, Aspire CLI with MCP
17 
18## Core Principles
19 
201. **Real Dependencies** - Use actual infrastructure (databases, caches) via Aspire, not mocks
212. **Dynamic Port Binding** - Let Aspire assign ports dynamically (`127.0.0.1:0`) to avoid conflicts
223. **Fixture Lifecycle** - Use `IAsyncLifetime` for proper test fixture setup and teardown
234. **Endpoint Discovery** - Never hard-code URLs; discover endpoints from Aspire at runtime
245. **Parallel Isolation** - Use xUnit collections to control test parallelization
256. **Health Checks** - Always wait for services to be healthy before running tests
26 
27## High-Level Testing Architecture
28 
29```
30┌─────────────────┐                    ┌──────────────────────┐
31…