aspire-integration-testing

Orchestrate end-to-end integration tests for .NET Aspire applications with xUnit.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/tvcosta/ai-customer-service --skill aspire-integration-testing-tvcosta
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: aspire-integration-testing
Source: https://github.com/tvcosta/ai-customer-service/tree/main/.claude/skills/aspire-integration-testing
Command: npx skills add https://github.com/tvcosta/ai-customer-service --skill aspire-integration-testing-tvcosta

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Enable reliable, real-infrastructure integration testing for .NET Aspire applications using xUnit, ensuring endpoints, service discovery, and cross-service interactions behave correctly in realistic environments.

Core Features & Use Cases

  • Simplified test fixtures and distributed application setup using Aspire.Hosting.Testing
  • Endpoint discovery and dynamic port binding to avoid hard-coded URLs
  • Health checks and readiness waits to guarantee stable test runs in containers
  • Guidance for testing ASP.NET Core apps with real databases, caches, and messaging

Quick Start

Create an AspireAppFixture implementing IAsyncLifetime, start the DistributedApplication, and perform a health-check against the discovered endpoint.

Frequently Asked Questions about aspire-integration-testing

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run integration tests for .NET Aspire applications with real dependencies?

Run .NET Aspire integration tests by orchestrating a distributed application with xUnit, utilizing real infrastructure like live databases and caches in containers to validate cross-service interactions and endpoint behavior.

How does endpoint discovery work in Aspire integration testing?

Endpoint discovery in Aspire integration testing uses dynamic port binding to avoid hard-coded URLs, automatically resolving service addresses for ASP.NET Core applications running with live dependencies in containers.

How do I ensure stable xUnit test runs when testing distributed applications in containers?

Ensure stable xUnit test runs for distributed applications by applying health checks and resource readiness waits, which guarantee that live databases, caches, and messaging services are fully initialized before tests execute.

What packages do I need to set up xUnit test fixtures for .NET Aspire?

Setting up xUnit test fixtures for .NET Aspire requires Aspire.Hosting.Testing, xunit, xunit.runner.visualstudio, and Microsoft.NET.Test.Sdk to orchestrate end-to-end testing with real infrastructure dependencies.

Can I test ASP.NET Core services with live databases and caches using Aspire.Hosting.Testing?

Yes, you can test ASP.NET Core services with live databases and caches using Aspire.Hosting.Testing, which supports running distributed applications with real infrastructure components in containers for reliable end-to-end validation.