# aspire-integration-testing

Скилл для написания интеграционных тестов приложений .NET Aspire на xUnit: фикстуры, поднятие distributed application, поиск эндпоинтов.

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

## Что делает

Скилл описывает, как писать интеграционные тесты для приложений .NET Aspire на xUnit. Внутри — фикстура на `IAsyncLifetime`, которая поднимает `DistributedApplication` из AppHost, ждёт готовности ресурсов через health checks и отдаёт динамические HTTP-эндпоинты. Порты Aspire назначает сам (`127.0.0.1:0`), поэтому конфликтов между прогонами не будет.

Отдельно разобран неприятный момент: если каждый тест стартует свой `IHost`, стандартный host builder включает file watcher для перезагрузки конфигурации и на Linux упирается в лимит inotify. В скилле есть `TestEnvironmentInitializer` с `[ModuleInitializer]`, который выставляет `DOTNET_HOSTBUILDER__RELOADCONFIGONCHANGE` в `false` до запуска тестов. Это стоит завести сразу, иначе длинные прогоны начнут падать с ошибками файловых дескрипторов.

Для работы нужны пакеты `Aspire.Hosting.Testing`, `xunit`, `xunit.runner.visualstudio` и `Microsoft.NET.Test.Sdk`. Рядом лежат два справочных файла: `advanced-patterns.md` про поиск эндпоинтов, тесты с базой, Playwright и Respawn, и `ci-and-tooling.md` про CI/CD и Aspire CLI с MCP.

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

## Установка

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

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Aaronontheweb/dotnet-skills aspire-integration-testing
```

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

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

### Claude.ai

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

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

## Когда брать
- поднять distributed application из AppHost прямо в тесте
- дождаться готовности сервисов перед прогоном
- получить URL эндпоинта без хардкода порта
- прогнать UI-тесты Playwright против реального бэкенда
- проверить обмен сообщениями между сервисами

## Примеры запросов агенту
- Напиши интеграционный тест для AppHost на xUnit с фикстурой Aspire
- Добавь TestEnvironmentInitializer, чтобы отключить перезагрузку конфигурации в тестовых хостах
- Покажи, как через фикстуру получить эндпоинт ресурса `api` и сделать к нему запрос

## Похожие
- [testing](https://affpapa.org/nevibecode/skills/codewithmukesh-testing.md) — скилл · 2800 установок
- [planning-oracle-to-postgres-migration-integration-testing](https://affpapa.org/nevibecode/skills/planning-oracle-to-postgres-migration-integration-testing.md) — скилл · 1800 установок
- [testcontainers](https://affpapa.org/nevibecode/skills/testcontainers.md) — скилл · 565 установок
- [aspire](https://affpapa.org/nevibecode/skills/aspire.md) — скилл · 2800 установок
- [132-java-testing-integration-testing](https://affpapa.org/nevibecode/skills/132-java-testing-integration-testing.md) — скилл · 376 установок
- [322-frameworks-spring-boot-testing-integration-tests](https://affpapa.org/nevibecode/skills/322-frameworks-spring-boot-testing-integration-tests.md) — скилл · 357 установок

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

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

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