Crie e execute seu primeiro aplicativo com o Aspire

Prepare a CLI do Aspire e os pré-requisitos para C#. Em uma solução nova, o template aspire-starter fornece um serviço de API, um frontend Blazor e um AppHost que conecta os dois. Se já existe uma solução, siga o guia do Aspire 13.4 para adicionar um AppHost aos projetos existentes.

Crie o aplicativo e abra o dashboard

Execute os comandos no diretório onde deseja criar a solução:

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

Responda às perguntas do template, se aparecerem. O primeiro comando cria a solução em HelloAspire. O último executa o AppHost. Abra a URL do dashboard exibida no terminal e depois o endpoint do frontend na lista de recursos. Visite a página de previsão do tempo para enviar uma requisição do frontend à API. No dashboard, examine os logs dos serviços e o rastreamento dessa requisição. Para encerrar a aplicação, pressione Ctrl+C no terminal.

No template, ApiService fornece os dados, Web os consome e ServiceDefaults contém a configuração comum. O AppHost registra os projetos e conecta o frontend às dependências. O guia de início rápido em C# mostra a estrutura do template e a introdução ao Aspire explica as referências a recursos.

Arquivo: a prévia do .NET 8 de novembro de 2023

Correção — 2 de novembro de 2026: os passos acima usam a CLI do Aspire 13.x. As capturas, a opção de Redis e a API AddRedisContainer abaixo pertencem à prévia de 2023. O AppHost tinha como destino net8.0 e referenciava Aspire.Hosting 8.0.0-preview.1.23557.2.

No Visual Studio 2022 Preview, o tutorial original selecionava .NET Aspire Starter Application e habilitava Use Redis for caching. O comando equivalente era:

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

O AppHost referenciava ApiService e Web. Os dois projetos compartilhavam ServiceDefaults, como mostra o diagrama original de dependências:

O AppHost da prévia registrava Redis como cache e a API como apiservice. O frontend referenciava ambos. A API da época tinha esta forma:

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

O dashboard original exibia os projetos e o contêiner juntos. Abrir o rastreamento de uma requisição de previsão do tempo mostrava as chamadas individuais aos serviços: