mcpField
A
aspire

aspire

github.com/rysweetCloud & DevOps76116 installsUpdated 22w ago
Repository

About aspire

Aspire Orchestration is a skill for defining distributed application topology in code and orchestrating local runs and Azure deployment, aimed at microservices developers. It covers services written in different languages, dependency configuration, service discovery, and local diagnostics.

Key features

  1. 01Define application resource topology in code
  2. 02Run and orchestrate multiple services locally
  3. 03Configure dependencies such as databases and Redis
  4. 04Inspect logs, traces, and metrics
  5. 05Deploy to Azure Container Apps

Use cases

  1. 01Set up an AppHost for a multi-service application
  2. 02Bring Python, Node.js, or Go services into orchestration
  3. 03Inspect service logs and traces during local development
  4. 04Deploy an application to Azure with azd

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/rysweet/amplihack --skill aspire

After installing, type/aspirein Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

commands.md
examples.md
patterns.md
reference.md
troubleshooting.md

Details

From the project README

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
var redis = builder.AddRedis("cache").WithRedisCommander();
var api = builder.AddProject<Projects.Api>("api").WithReference(redis);

// RabbitMQ
var rabbitmq = builder.AddRabbitMQ("messaging");
var worker = builder.AddProject<Projects.Worker>("worker").WithReference(rabbitmq);

// Access in code (connection strings auto-injected)
builder.Services.AddStackExchangeRedisCache(options =>
{
    options.Configuration = builder.Configuration.GetConnectionString("cache");
});
Local Development
aspire run  # Starts all services

Dashboard (localhost:15888): Resources, logs, traces, metrics Hot Reload: Auto-rebuild on code changes Debugging: Attach to individual services via IDE

Cloud Deployment

See Azure deployment guide.

azd init  # Initialize Azure Developer CLI
azd up    # Deploy (generates Bicep → Azure Container Apps)
azd deploy -e production  # Deploy to specific environment

Generates: Bicep → Container Apps + networking + managed identities

Navigation Guide

When setting up projects:

  • examples.md lines 8-31 → Minimal project
  • examples.md lines 518-608 → Add Python service
  • examples.md lines 610-669 → Add Node.js service
  • examples.md lines 671-768 → Add Go service

When adding infrastructure:

  • reference.md lines 47-148 → Database APIs (PostgreSQL, Redis, MongoDB)
  • examples.md lines 39-95 → Redis integration
  • examples.md lines 102-176 → PostgreSQL integration

When deploying:

  • commands.md lines 215-288 → Full azd workflow
  • examples.md lines 387-515 → Azure deployment walkthrough
  • patterns.md lines 5-42 → HA configuration

When debugging:

  • troubleshooting.md lines 5-112 → Orchestration failures
  • troubleshooting.md lines 291-397 → Connection issues
  • commands.md lines 131-179 → Debug commands

Quick Reference

Essential commands: See commands.md for complete reference

Polyglot patterns:

builder.AddProject<Projects.Api>("api");  // .NET
builder.AddExecutable("python-api", "python", ".").WithArgs("app.py");  // Python
builder.AddExecutable("node-api", "node", ".").WithArgs("server.js");  // Node.js
builder.AddExecutable("go-svc", "go", ".").WithArgs("run", "main.go");  // Go

Service discovery: .WithReference(redis) in AppHost → GetConnectionString("cache") in service

Integration with Amplihack

Command: /ultrathink "Setup Aspire for microservices"

  • prompt-writer clarifies requirements → architect uses reference.md for API design
  • builder uses examples.md for implementation → reviewer checks patterns.md for best practices
  • tester uses troubleshooting.md for validation

Agent-Skill mapping:

  • architect → reference.md (API design)
  • builder → examples.md (implementation)
  • reviewer → patterns.md (best practices)
  • tester → troubleshooting.md (validation)
  • all agents → commands.md (CLI operations)

Comments

Markdown supported