aspire

name	aspire
description	Aspire orchestration for cloud-native distributed applications in any language (C#, Python, Node.js, Go). Handles dependency management, local dev with Docker, Azure deployment, service discovery, and observability dashboards. Use when setting up microservices, containerized apps, or polyglot distributed systems.
version	1.0.0
source_urls	["https://learn.microsoft.com/dotnet/aspire/get-started/aspire-overview","https://learn.microsoft.com/dotnet/aspire/fundamentals/setup-tooling","https://github.com/dotnet/aspire","https://learn.microsoft.com/dotnet/aspire/database/postgresql-component","https://learn.microsoft.com/dotnet/aspire/caching/stackexchange-redis-component","https://learn.microsoft.com/dotnet/aspire/deployment/azure/aca-deployment","https://learn.microsoft.com/dotnet/aspire/service-discovery/overview","https://learn.microsoft.com/dotnet/aspire/fundamentals/dashboard"]
activation_keywords	["aspire","distributed app","microservices","service discovery","apphost","cloud-native","orchestration"]
auto_activate	true
token_budget	1800

Aspire Orchestration

Overview

Code-first orchestration for polyglot distributed apps. AppHost defines topology, aspire run orchestrates locally, azd deploy deploys to Azure.

Auto-activates on keywords: aspire, microservices, distributed app, service discovery, orchestration

Quick Start

# Install .NET 8+ and Aspire workload
# See: https://learn.microsoft.com/dotnet/aspire/fundamentals/setup-tooling
dotnet workload update
dotnet workload install aspire

# Create AppHost (orchestrates services in ANY language)
dotnet new aspire-apphost -n MyApp

# Basic AppHost - orchestrate Python, Node.js, .NET services
var builder = DistributedApplication.CreateBuilder(args);
var redis = builder.AddRedis("cache");

// Python service
var pythonApi = builder.AddExecutable("python-api", "python", ".").WithArgs("app.py").WithReference(redis);

// Node.js service
var nodeApi = builder.AddExecutable("node-api", "node", ".").WithArgs("server.js").WithReference(redis);

// .NET service
var dotnetApi = builder.AddProject<Projects.Api>("api").WithReference(redis);

builder.Build().Run();

# Run (orchestrates ALL languages)
aspire run  # Dashboard opens at http://localhost:15888

Core Workflows

Project Setup

dotnet new aspire-apphost -n MyApp
dotnet new webapi -n MyApp.Api
dotnet add MyApp.AppHost reference MyApp.Api

AppHost: Resource topology in Program.cs ServiceDefaults: Shared config (logging, telemetry, resilience) Services: Your apps (APIs, workers, web apps)

Dependency Configuration

// PostgreSQL
var postgres = builder.AddPostgres("db").AddDatabase("mydb");
var api = builder.AddProject<Projects.Api>("api").WithReference(postgres);


 redis = builder.AddRedis().WithRedisCommander();
 api = builder.AddProject<Projects.Api>().WithReference(redis);


 rabbitmq = builder.AddRabbitMQ();
 worker = builder.AddProject<Projects.Worker>().WithReference(rabbitmq);


builder.Services.AddStackExchangeRedisCache(options =>
{
    options.Configuration = builder.Configuration.GetConnectionString();
});