# testcontainers-integration-tests

Скилл учит агента писать интеграционные тесты на .NET и xUnit с реальными базами и очередями в Docker вместо моков. Помогает проверять миграции, SQL-запросы и кэш без ложной уверенности.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 544 установки · ★ 1238
- Автор: Aaronontheweb
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/Aaronontheweb/dotnet-skills/tree/HEAD/skills/testcontainers/SKILL.md
- Обновлён: 2026-10-11
- HTML: https://affpapa.org/nevibecode/skills/testcontainers-integration-tests

## Что делает

Скилл настраивает интеграционное тестирование на C# с xUnit и Testcontainers 4.x. Вместо моков базы данных и брокеров сообщений агент генерирует код с живыми контейнерами SQL Server, PostgreSQL, Redis или RabbitMQ. Тесты проверяют ограничения схемы, индексы и реальный синтаксис SQL. Контейнеры запускаются со случайными портами, что исключает конфликты сетевых адресов.

Для работы нужен запущенный Docker. Старый синтаксис с `TestcontainersBuilder<T>` или методом `.WithImage()` компилироваться не будет: скилл строго требует передавать имя Docker-образа в конструктор билдера (например, `new PostgreSqlBuilder("postgres:latest")`). Проект должен подключать пакеты провайдеров из линейки 4.x, такие как `Testcontainers.MsSql`, `Testcontainers.PostgreSql` или `Testcontainers.Redis`.

Жизненный цикл контейнеров связывается с интерфейсом `IAsyncLifetime` в xUnit. Контейнер стартует в `InitializeAsync`, накатывает миграции и корректно освобождает ресурсы в `DisposeAsync`. Изоляция данных между прогонами опирается на переиспользование контейнеров или очистку через Respawn.

## Требования
- Работает с: Docker

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Aaronontheweb/dotnet-skills --skill testcontainers-integration-tests -a claude-code
```
```bash
npx skills add Aaronontheweb/dotnet-skills --skill testcontainers -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/testcontainers/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/testcontainers/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Aaronontheweb/dotnet-skills --skill testcontainers -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/testcontainers/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Aaronontheweb/dotnet-skills --skill testcontainers -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/testcontainers/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Aaronontheweb/dotnet-skills testcontainers
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/testcontainers/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Aaronontheweb/dotnet-skills --skill testcontainers -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/Aaronontheweb/dotnet-skills --path skills/testcontainers
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/testcontainers/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add Aaronontheweb/dotnet-skills --skill testcontainers -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/Aaronontheweb/dotnet-skills/tree/HEAD/skills/testcontainers/SKILL.md

## Когда брать
- проверить SQL-запросы и ограничения схемы на реальной СУБД
- протестировать миграции базы данных без моков
- настроить тесты кэширования в Redis с очисткой контейнера
- проверить отправку сообщений в RabbitMQ внутри тестов xUnit

## Примеры запросов агенту
- Напиши интеграционный тест xUnit для OrderRepository с использованием Testcontainers и PostgreSQL
- Добавь тест кэширования данных в Redis через Testcontainers 4.x
- Переведи моки базы данных в тестах на реальный контейнер MsSqlContainer

## Похожие
- [testcontainers](https://affpapa.org/nevibecode/skills/testcontainers.md) — скилл · 565 установок
- [java-testcontainers](https://affpapa.org/nevibecode/skills/java-testcontainers.md) — скилл · 1 установка
- [csharp-testing](https://affpapa.org/nevibecode/skills/csharp-testing.md) — скилл · 4500 установок
- [tdd](https://affpapa.org/nevibecode/skills/codewithmukesh-tdd.md) — скилл · 2800 установок
- [322-frameworks-spring-boot-testing-integration-tests](https://affpapa.org/nevibecode/skills/322-frameworks-spring-boot-testing-integration-tests.md) — скилл · 357 установок
- [testing](https://affpapa.org/nevibecode/skills/codewithmukesh-testing.md) — скилл · 2800 установок

Из того же набора: [aaronontheweb/dotnet-skills](https://affpapa.org/nevibecode/by/aaronontheweb/dotnet-skills.md) — 32 карточки

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md