Como instalar a CLI do Aspire para um AppHost em C#

Para um AppHost em C# com Aspire 13.x, instale o SDK do .NET 10 e a CLI do Aspire. No terminal, confira se há um SDK 10.x listado, instale a CLI como ferramenta global do .NET e verifique se o shell a encontra:

dotnet --list-sdks
dotnet tool install --global Aspire.Cli
aspire --version

Se o último comando não encontrar aspire, reabra o terminal e confira se o diretório de ferramentas globais do .NET está no PATH. Para usar um gerenciador de pacotes do Windows, Homebrew ou outro método, consulte o guia de instalação da CLI. Escolha um método de instalação.

Um AppHost que inicia um contêiner de Redis ou de banco de dados também precisa de um runtime de contêineres em execução. Docker Desktop e Podman são opções. Os pré-requisitos do Aspire explicam a configuração do runtime e distinguem o SDK necessário ao AppHost em C# dos frameworks de destino dos serviços que ele executa.

Por que instruções antigas instalam um workload do Aspire

Correção — 2 de novembro de 2026: dotnet workload install aspire era o comando de instalação da prévia do .NET 8 de novembro de 2023. O Aspire 9 moveu os templates para pacotes NuGet e eliminou a necessidade do workload. O comando e as capturas abaixo documentam a configuração anterior:

dotnet workload install aspire

Na prévia, o Visual Studio Installer oferecia o componente opcional .NET Aspire SDK (Preview) no workload de desenvolvimento web. A segunda imagem mostra o instalador do Docker Desktop para Windows daquela época.

Quando aspire --version funcionar, crie seu primeiro aplicativo de exemplo com Aspire. Para entender o papel do AppHost, veja como o Aspire conecta os serviços.