Как установить Aspire CLI для AppHost на C#

Для AppHost на C# в Aspire 13.x установите .NET 10 SDK и Aspire CLI. В терминале убедитесь, что в списке есть SDK 10.x, установите CLI как глобальный инструмент .NET и проверьте, что оболочка его находит:

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

Если последняя команда не находит aspire, откройте терминал заново и проверьте, что каталог глобальных инструментов .NET входит в PATH. Способы установки через диспетчер пакетов Windows, Homebrew и другие варианты описаны в руководстве по установке CLI. Достаточно одного способа.

Если AppHost запускает Redis или базу данных в контейнере, понадобится работающая среда выполнения контейнеров. Подойдут Docker Desktop или Podman. В требованиях Aspire описана настройка среды и различие между SDK для AppHost на C# и целевыми платформами запускаемых служб.

Почему в старых инструкциях устанавливают рабочую нагрузку Aspire

Исправление — 2 ноября 2026 г.: команду dotnet workload install aspire использовали в предварительной версии для .NET 8 в ноябре 2023 года. Начиная с Aspire 9 шаблоны поставляются в пакетах NuGet, а рабочая нагрузка больше не требуется. Команда и снимки экрана ниже показывают прежнюю установку:

dotnet workload install aspire

В предварительной версии Visual Studio Installer предлагал необязательный компонент .NET Aspire SDK (Preview) в составе рабочей нагрузки веб-разработки. На втором снимке показан тогдашний установщик Docker Desktop для Windows.

Когда заработает aspire --version, создайте стартовое приложение Aspire. Роль AppHost объясняется в статье о том, как Aspire связывает службы.