Aspire — Orchestration d'applications distribuées polyglotte

Aspire est une chaîne d'outils polyglotte, code-first pour construire des applications distribuées observables et prêtes pour la production. Elle orchestre des conteneurs, des exécutables et des ressources cloud à partir d'un seul projet AppHost — que les charges de travail soient en C#, Python, JavaScript/TypeScript, Go, Java, Rust, Bun, Deno ou PowerShell.

Modèle mental : L'AppHost est un chef d'orchestre — il ne joue pas des instruments, il indique à chaque service quand démarrer, comment se trouver les uns les autres, et surveille les problèmes.

Le matériel de référence détaillé se trouve dans le dossier references/ — chargez à la demande.

Références

1. Recherche dans la documentation Aspire

L'équipe Aspire fournit un serveur MCP qui met à disposition des outils de documentation directement dans votre assistant IA. Voir MCP Server pour les détails de configuration.

Aspire CLI 13.2+ (recommandé — dispose de la recherche de docs intégrée)

Si vous exécutez Aspire CLI 13.2 ou ultérieur (aspire --version), le serveur MCP inclut les outils de recherche de docs :

Ces outils ont été ajoutés dans PR #14028. Pour mettre à jour : aspire update --self --channel daily.

Pour en savoir plus sur cette approche, consultez le post de David Pine : https://davidpine.dev/posts/aspire-docs-mcp-tools/

Aspire CLI 13.1 (outils d'intégration uniquement)

Sur 13.1, le serveur MCP fournit la recherche d'intégration mais pas la recherche de docs :

Pour les requêtes de docs générales sur 13.1, utilisez Context7 comme source principale (voir ci-dessous).

Fallback : Context7

Utilisez Context7 (mcp_context7) quand les outils MCP de docs Aspire ne sont pas disponibles (13.1) ou que le serveur MCP n'est pas en cours d'exécution :

Étape 1 — Résoudre l'ID de la bibliothèque (une fois par session) :

Appelez mcp_context7_resolve-library-id avec libraryName: ".NET Aspire".

Étape 2 — Requête docs :

libraryId: "/microsoft/aspire.dev", query: "Python integration AddPythonApp service discovery"
libraryId: "/communitytoolkit/aspire", query: "Golang Java Node.js community integrations"

Fallback : Recherche GitHub (quand Context7 n'est aussi pas disponible)

Recherchez dans le référentiel de docs officiel sur GitHub :

• Docs repo : microsoft/aspire.dev — chemin : src/frontend/src/content/docs/
• Source repo : dotnet/aspire
• Samples repo : dotnet/aspire-samples
• Community integrations : CommunityToolkit/Aspire

2. Prérequis et installation

# Linux / macOS
curl -sSL https://aspire.dev/install.sh | bash

# Windows PowerShell
irm https://aspire.dev/install.ps1 | iex

# Vérifier
aspire --version

# Installer les templates
dotnet new install Aspire.ProjectTemplates

3. Templates de projet

4. Quick Start AppHost (Polyglotte)

L'AppHost orchestre tous les services. Les charges de travail non-.NET s'exécutent en tant que conteneurs ou exécutables.

var builder = DistributedApplication.CreateBuilder(args);

// Infrastructure
var redis = builder.AddRedis("cache");
var postgres = builder.AddPostgres("pg").AddDatabase("catalog");

// API .NET
var api = builder.AddProject<Projects.CatalogApi>("api")
    .WithReference(postgres).WithReference(redis);

// Service ML Python
var ml = builder.AddPythonApp("ml-service", "../ml-service", "main.py")
    .WithHttpEndpoint(targetPort: 8000).WithReference(redis);

// Frontend React (Vite)
var web = builder.AddViteApp("web", "../frontend")
    .WithHttpEndpoint(targetPort: 5173).WithReference(api);

// Worker Go
var worker = builder.AddGolangApp("worker", "../go-worker")
    .WithReference(redis);

builder.Build().Run();

Pour les signatures d'API complètes, voir Polyglot APIs.

5. Concepts clés (résumé)

6. Référence rapide CLI

Commandes valides dans Aspire CLI 13.1 :

Référence complète des commandes avec drapeaux : CLI Reference.

7. Motifs courants

Ajouter un nouveau service

1. Créer votre répertoire de service (n'importe quel langage)
2. Ajouter à l'AppHost : Add*App() ou AddProject<T>()
3. Câbler les dépendances : .WithReference()
4. Contrôler les health checks : .WaitFor() si nécessaire
5. Exécuter : aspire run

Migration depuis Docker Compose

1. aspire new aspire-apphost-singlefile (AppHost vide)
2. Remplacer chaque service docker-compose par une ressource Aspire
3. depends_on → .WithReference() + .WaitFor()
4. ports → .WithHttpEndpoint()
5. environment → .WithEnvironment() ou .WithReference()

8. URLs clés