Die erste Aspire-Starteranwendung erstellen und ausführen

Richte zunächst Aspire CLI und die C#-Voraussetzungen ein. Für eine neue Projektmappe liefert die Vorlage aspire-starter einen API-Dienst, ein Blazor-Frontend und einen AppHost, der beide verbindet. Für eine vorhandene Lösung gibt es die Aspire-13.4-Anleitung zum Ergänzen eines AppHost.

Starter erstellen und Dashboard öffnen

Führe diese Befehle im Verzeichnis aus, in dem die neue Projektmappe entstehen soll:

aspire new aspire-starter -n HelloAspire -o HelloAspire
cd HelloAspire
aspire run

Beantworte eventuelle Vorlagenabfragen. Der erste Befehl erzeugt die Projektmappe unter HelloAspire, der letzte startet ihren AppHost. Öffne die Dashboard-URL aus dem Terminal und dann in der Ressourcenliste den Endpunkt des Web-Frontends. Rufe die Wetterseite auf, um eine Anfrage vom Frontend zur API zu senden. Im Dashboard kannst du die Dienstprotokolle und den Trace dieser Anfrage untersuchen. Mit Ctrl+C im Terminal beendest du die Anwendung.

Im Starter stellt ApiService die Daten bereit, Web ruft sie ab und ServiceDefaults enthält gemeinsame Konfiguration. Der AppHost registriert die Projekte und verbindet das Frontend mit seinen Abhängigkeiten. Der aktuelle C#-Schnellstart zeigt die Vorlagenstruktur. Der Aspire-Überblick erklärt, wie ein Ressourcenverweis funktioniert.

Archiv: die .NET-8-Vorschau vom November 2023

Korrektur — 2. November 2026: Die obigen Schritte verwenden die Aspire CLI 13.x. Die Screenshots, der optionale Redis-Schalter und die API AddRedisContainer unten stammen aus der Vorschau von 2023. Ihr AppHost zielte auf net8.0 und verwendete Aspire.Hosting 8.0.0-preview.1.23557.2.

In Visual Studio 2022 Preview wurde damals .NET Aspire Starter Application ausgewählt und Use Redis for caching aktiviert. Der entsprechende CLI-Befehl lautete:

dotnet new aspire-starter --use-redis-cache --output Foo

Der AppHost verwies auf ApiService und Web. Beide nutzten ServiceDefaults, wie das ursprüngliche Abhängigkeitsdiagramm zeigt:

Der Vorschau-AppHost registrierte Redis als cache und die API als apiservice. Das Web-Frontend verwies auf beide. So sah die damalige API aus:

var builder = DistributedApplication.CreateBuilder(args);
var cache = builder.AddRedisContainer("cache");
var api = builder.AddProject<Projects.Foo_ApiService>("apiservice");
builder.AddProject<Projects.Foo_Web>("webfrontend")
    .WithReference(cache)
    .WithReference(api);
builder.Build().Run();

Das ursprüngliche Dashboard zeigte Projekte und Container zusammen. Im Trace einer Wetteranfrage waren die einzelnen Dienstaufrufe sichtbar: