Crea y ejecuta tu primera aplicación de Aspire

Prepara primero la CLI de Aspire y los requisitos para C#. Para una solución nueva, la plantilla aspire-starter proporciona un servicio de API, un frontend Blazor y un AppHost que los conecta. Si ya tienes una solución, sigue la guía de Aspire 13.4 para añadir un AppHost a proyectos existentes.

Crear la aplicación y abrir el dashboard

Ejecuta estos comandos desde el directorio donde quieres crear la solución:

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

Responde a las preguntas de la plantilla si aparecen. El primer comando crea la solución en HelloAspire. El último ejecuta su AppHost. Abre la URL del dashboard que aparece en la terminal y luego el endpoint del frontend en la lista de recursos. Visita la página del tiempo para enviar una petición del frontend a la API. En el dashboard, inspecciona los registros y la traza de esa petición. Pulsa Ctrl+C en la terminal para detener la aplicación.

En la plantilla, ApiService sirve los datos, Web los consume y ServiceDefaults proporciona la configuración común. El AppHost registra los proyectos y conecta el frontend a sus dependencias. La guía de inicio rápido de C# muestra la estructura y la introducción a Aspire explica cómo funciona una referencia a un recurso.

Archivo: la preview de .NET 8 de noviembre de 2023

Corrección — 2 de noviembre de 2026: los pasos anteriores usan la CLI de Aspire 13.x. Las capturas, la opción de Redis y la API AddRedisContainer siguientes corresponden a la preview de 2023. Su AppHost apuntaba a net8.0 y referenciaba Aspire.Hosting 8.0.0-preview.1.23557.2.

En Visual Studio 2022 Preview, la guía original seleccionaba .NET Aspire Starter Application y activaba Use Redis for caching. El comando equivalente era:

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

El AppHost referenciaba ApiService y Web. Ambos proyectos compartían ServiceDefaults, como muestra el diagrama original:

El AppHost de la preview registraba Redis como cache y la API como apiservice. El frontend referenciaba ambos recursos. Esta era la API de entonces:

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();

El dashboard original mostraba los proyectos y el contenedor. Al abrir la traza de una petición del tiempo se veían las llamadas individuales a los servicios: