testcontainers-integration-tests

1# Integration Testing with TestContainers
2 
3## When to Use This Skill
4 
5Use this skill when:
6- Writing integration tests that need real infrastructure (databases, caches, message queues)
7- Testing data access layers against actual databases
8- Verifying message queue integrations
9- Testing Redis caching behavior
10- Avoiding mocks for infrastructure components
11- Ensuring tests work against production-like environments
12- Testing database migrations and schema changes
13 
14## Reference Files
15 
16- [database-patterns.md](database-patterns.md): SQL Server, PostgreSQL, and migration testing examples
17- [infrastructure-patterns.md](infrastructure-patterns.md): Redis, RabbitMQ, multi-container networks, container reuse, and Respawn
18 
19## Core Principles
20 
211. **Real Infrastructure Over Mocks** - Use actual databases/services in containers, not mocks
222. **Test Isolation** - Each test gets fresh containers or fresh data
233. **Automatic Cleanup** - TestContainers handles container lifecycle and cleanup
244. **Fast Startup** - Reuse containers across tests in the same class when appropriate
255. **CI/CD Compatible** - Works seamlessly in Docker-enabled CI environments
266. **Port Randomization** - Containers use random ports to avoid conflicts
27 
28## TestContainers 4.x API
29…