aspire

Adding a Service to AppHost

```csharp

// In AppHost.cs - Add project with resource references

var myService = builder.AddProject("my-service")

.WithReference(redis) // Service discovery

.WithReference(walletDb) // Database connection

.WithEnvironment("JwtSettings__SigningKey", jwtSigningKey); // Shared config

```

Consuming Aspire in a Service

```csharp

// In Program.cs - Every service starts with this

var builder = WebApplication.CreateBuilder(args);

builder.AddServiceDefaults(); // OpenTelemetry, health checks, discovery

builder.AddRedisOutputCache("redis"); // Reference by resource name

builder.AddRedisDistributedCache("redis");

var app = builder.Build();

app.MapDefaultEndpoints(); // /health and /alive

```

| Concept | Usage | Example |

|---------|-------|---------|

| Resource Name | Identifier for service discovery | "redis", "tenant-service" |

| WithReference | Injects connection string/URL | .WithReference(postgres) |

| WithEnvironment | Pass config to service | .WithEnvironment("Key", value) |

| WithExternalHttpEndpoints | Expose outside Aspire network | .WithExternalHttpEndpoints() |

| AddServiceDefaults | Shared Aspire configuration | builder.AddServiceDefaults() |

Database Resources

```csharp

// PostgreSQL with multiple databases

var postgres = builder.AddPostgres("postgres").WithPgAdmin();

var tenantDb = postgres.AddDatabase("tenant-db", "sorcha_tenant");

var walletDb = postgres.AddDatabase("wallet-db", "sorcha_wallet");

// MongoDB for document storage

var mongodb = builder.AddMongoDB("mongodb").WithMongoExpress();

var registerDb = mongodb.AddDatabase("register-db", "sorcha_register");

// Redis for caching

var redis = builder.AddRedis("redis").WithRedisCommander();

```

Service Dependencies

```csharp

// Service references other services for discovery

var validatorService = builder.AddProject("validator-service")

.WithReference(redis)

.WithReference(walletService)

.WithReference(registerService)

.WithReference(peerService)

.WithReference(blueprintService);

```

Health Endpoints

```csharp

// ServiceDefaults provides these automatically

app.MapHealthChecks("/health"); // Readiness - all checks

app.MapHealthChecks("/alive", new HealthCheckOptions

{

Predicate = r => r.Tags.Contains("live") // Liveness - tagged checks only

});

```

• [patterns](references/patterns.md) - AppHost patterns, resource configuration
• [workflows](references/workflows.md) - Adding services, debugging, deployment

• See the dotnet skill for .NET 10 patterns
• See the minimal-apis skill for endpoint configuration
• See the redis skill for cache configuration
• See the postgresql skill for database patterns
• See the mongodb skill for document storage
• See the docker skill for containerization

> Fetch latest .NET Aspire documentation with Context7.

How to use Context7:

1. Use mcp__context7__resolve-library-id to search for "aspire"
2. Prefer website documentation (IDs starting with /websites/) over source code repositories when available
3. Query with mcp__context7__query-docs using the resolved library ID

Library ID: /dotnet/docs-aspire _(High reputation, 3264 code snippets)_

Recommended Queries:

• "AppHost service orchestration configuration"
• "service discovery WithReference patterns"
• "OpenTelemetry observability setup"
• "health checks readiness liveness"