Упражнение. Создание проекта .NET Aspire

Завершено

Прежде чем приступить к работе с новой службой для последнего проекта вашей компании, необходимо проверить наличие всех необходимых компонентов для .NET Aspire. Лучшим способом проверки является создание нового проекта .NET Aspire с помощью начального шаблона.

В упражнении вы установите все необходимые компоненты, а затем создадите новое приложение .NET Aspire Starter. Затем вы увидите, как добавить компонент кэширования с помощью Redis в приложение. Наконец, вы протестируете приложение и быстро изучите панель мониторинга Aspire.

Visual Studio

Выберите эту вкладку, чтобы просмотреть действия, описанные в этом упражнении для Visual Studio.

Интерфейс командной строки.NET

Выберите эту вкладку, чтобы просмотреть шаги в этом упражнении в терминале с командами dotnet CLI .

Установка необходимых компонентов

Мы обсудили предварительные требования в предыдущем уроке. Давайте рассмотрим установку.

Установка .NET 8

Следуйте этой ссылке .NET 8 и выберите правильный установщик операционной системы. Например, если вы используете Windows 11 и современный процессор, выберите пакет SDK x64 .NET 8 для Windows.

После завершения скачивания запустите установщик и следуйте инструкциям. В окне терминала выполните следующую команду, чтобы убедиться, что установка выполнена успешно:

dotnet --version

Вы увидите номер версии установленного пакета SDK для .NET. Например:

8.0.300-preview.24203.14

Установка Предварительной версии Visual Studio 2022

Перейдите по этой ссылке предварительной версии Visual Studio 2022 и выберите "Скачать предварительную версию". После завершения скачивания запустите установщик и следуйте инструкциям.

Установка Docker Desktop

Следуйте этой ссылке Docker Desktop и выберите правильный установщик операционной системы. После завершения скачивания запустите установщик и следуйте инструкциям.

Откройте классическое приложение Docker и примите соглашение об обслуживании.

Установка рабочей нагрузки .NET Aspire

Visual Studio

Установите рабочую нагрузку .NET Aspire с помощью Visual Studio:

1. Откройте Установщик Visual Studio.

2. Выберите " Изменить " рядом с Visual Studio.

3. Выберите рабочую нагрузку ASP.NET и веб-разработки .

4. На панели сведений об установке выберите пакет SDK для .NET Aspire (предварительная версия).

5. Выберите "Изменить", чтобы установить компонент .NET Aspire.

6. Убедитесь, что установлена последняя версия .NET Aspire, в новом терминале выполните следующую команду:

   dotnet workload list
   

Интерфейс командной строки.NET

Установите рабочую нагрузку .NET Aspire с помощью .NET CLI:

1. Откройте новое окно терминала.

2. Обновите рабочие нагрузки .NET с помощью следующей команды:

   dotnet workload update
   

   Должно появиться сообщение об успешном обновлении рабочих нагрузок.

   No workloads installed for this feature band. To update workloads installed with earlier SDK versions, include the --from-previous-sdk option.
   Updated advertising manifest microsoft.net.sdk.ios.
   Updated advertising manifest microsoft.net.workload.mono.toolchain.net6.
   Updated advertising manifest microsoft.net.sdk.android.
   Updated advertising manifest microsoft.net.workload.emscripten.net7.
   Updated advertising manifest microsoft.net.workload.emscripten.net6.
   Updated advertising manifest microsoft.net.sdk.macos.
   Updated advertising manifest microsoft.net.workload.emscripten.current.
   Updated advertising manifest microsoft.net.workload.mono.toolchain.current.
   Updated advertising manifest microsoft.net.sdk.maui.
   Updated advertising manifest microsoft.net.workload.mono.toolchain.net7.
   Updated advertising manifest microsoft.net.sdk.maccatalyst.
   Updated advertising manifest microsoft.net.sdk.tvos.
   Updated advertising manifest microsoft.net.sdk.aspire.
   No workloads installed for this feature band. To update workloads installed with earlier SDK versions, include the --from-previous-sdk option.
   
   Successfully updated workload(s): .
   

3. Установите рабочую нагрузку .NET Aspire с помощью следующей команды:

   dotnet workload install aspire
   

   Должно появиться сообщение об установке рабочей нагрузки aspire.

   Installing Aspire.Hosting.Sdk.Msi.x64 ...... Done
   Installing Aspire.ProjectTemplates.Msi.x64 ..... Done
   Installing Aspire.Hosting.Orchestration.win-x64.Msi.x64 ............. Done
   Installing Aspire.Hosting.Msi.x64 ..... Done
   Installing Aspire.Dashboard.Sdk.win-x64.Msi.x64 ....... Done
   
   Successfully installed workload(s) aspire.
   

4. Убедитесь, что рабочая нагрузка .NET Aspire установлена с помощью этой команды:

   dotnet workload list
   

После установки рабочей нагрузки вы увидите:

Installed Workload Id      Manifest Version      Installation Source
---------------------------------------------------------------------------------------------
aspire                     8.0.0/8.0.100         SDK 8.0.300-preview.24203, VS 17.10.34902.84

Use `dotnet workload search` to find additional workloads to install.

Создание нового приложения .NET Aspire Starter

Теперь, когда установлены предварительные требования, создадим новое приложение.

Visual Studio

1. Откройте Visual Studio. В диалоговом окне выберите "Создать проект".

2. В поле "Поиск шаблонов" введите aspire.

3. Выберите начальное приложение .NET Aspire и нажмите кнопку "Далее".

4. В поле "Имя решения" введите AspireTestApp.

5. В поле "Расположение" введите папку, в которой нужно создать новое приложение.

6. Выберите Далее.

7. Оставьте значение по умолчанию .NET 8.0 (долгосрочная поддержка).

8. Снимите флажок Использовать Redis для кэширования (требуется поддерживаемая среда выполнения контейнера).

   Вы вручную добавите поддержку Redis в следующих шагах.

9. Нажмите кнопку создания.

10. В меню выберите "Отладка", а затем нажмите кнопку "Начать отладку " (кроме того, нажмите клавишу F5).

11. Если появится запрос на запуск подсистемы Docker, нажмите кнопку "Да".

Интерфейс командной строки.NET

1. В том же окне терминала перейдите в папку, в которой нужно создать тестовое приложение.

2. Выполните следующую команду, чтобы создать новое приложение .NET Aspire Starter:

   dotnet new aspire-starter --output AspireTestApp
   

   Выводится следующий результат.

   The template ".NET Aspire Starter Application" was created successfully.
   This template contains technologies from parties other than Microsoft, see https://aka.ms/aspire/1.0-third-party-notices for details.
   
   Processing post-creation actions...
   Restoring C:\Users\...\source\repos\AspireTestApp\AspireTestApp.sln:
     Determining projects to restore...
     Restored C:\Users\...\source\repos\AspireTestApp\AspireTestApp.ApiService\AspireTestApp.ApiService.csproj (in 1.38
     sec).
     Restored C:\Users\...\source\repos\AspireTestApp\AspireTestApp.Web\AspireTestApp.Web.csproj (in 1.38 sec).
     Restored C:\Users\...\source\repos\AspireTestApp\AspireTestApp.AppHost\AspireTestApp.AppHost.csproj (in 1.38 sec).
     Restored C:\Users\...\source\repos\AspireTestApp\AspireTestApp.ServiceDefaults\AspireTestApp.ServiceDefaults.csproj
      (in 1.38 sec).
   Restore succeeded.
   Restoring C:\Users\...\source\repos\AspireTestApp\AspireTestApp.AppHost\AspireTestApp.AppHost.csproj:
     Determining projects to restore...
     All projects are up-to-date for restore.
   Restore succeeded.
   Restoring C:\Users\...\source\repos\AspireTestApp\AspireTestApp.ServiceDefaults\AspireTestApp.ServiceDefaults.csproj:
     Determining projects to restore...
     All projects are up-to-date for restore.
   Restore succeeded.
   Restoring C:\Users\...\source\repos\AspireTestApp\AspireTestApp.ApiService\AspireTestApp.ApiService.csproj:
     Determining projects to restore...
     All projects are up-to-date for restore.
   Restore succeeded.
   Restoring C:\Users\...\source\repos\AspireTestApp\AspireTestApp.Web\AspireTestApp.Web.csproj:
     Determining projects to restore...
     All projects are up-to-date for restore.
   Restore succeeded.
   

3. Запустите приложение:

   dotnet run --project AspireTestApp/AspireTestApp.AppHost
   

   Вы должны увидеть следующий результат:

   Building...
   info: Aspire.Hosting.DistributedApplication[0]
         Distributed application starting.
   info: Aspire.Hosting.DistributedApplication[0]
         Application host directory is: C:\Users\...\source\repos\AspireTestApp\AspireTestApp.AppHost
   info: Aspire.Hosting.DistributedApplication[0]
         Now listening on: http://localhost:15157
   info: Aspire.Hosting.DistributedApplication[0]
         Distributed application started. Press CTRL-C to stop.
   

4. Ctrl + щелкните URL-адрес прослушивания, чтобы открыть эту панель .NET Aspire. В приведенном выше примере URL-адрес имеется http://localhost:15157.

Панель мониторинга откроется в веб-браузере по умолчанию.

Выберите URL-адрес конечной точки веб-frontend . Порт назначается случайным образом, поэтому панель мониторинга может не совпадать.

Приложение Blazor имеет простую страницу счетчика и страницу погоды, которая вызывает серверную службу API для получения прогнозируемых данных для отображения.

Закройте вкладки браузера для приложения Blazor и панели мониторинга .NET Aspire. В Visual Studio остановите отладку.

Добавление компонента кэширования в проект .NET Aspire

Теперь добавим компонент кэширования Redis в проект .NET Aspire. Начнем с узла приложения:

Visual Studio

1. В Обозреватель решений щелкните правой кнопкой мыши проект AspireTestApp.AppHost и выберите "Управление пакетами NuGet".
2. Щелкните вкладку Обзор и выберите Включить предварительные выпуски.
3. Найдите нужный redis и выберите пакет Aspire.Hosting.Redis.
4. В правой области для версии выберите последнюю версию 8.0.0 и нажмите кнопку "Установить".
5. В диалоговом окне "Принятие лицензии" нажмите кнопку "Принять".

Интерфейс командной строки.NET

1. Перейдите в папку веб-проекта:

   cd AspireTestApp/AspireTestApp.AppHost
   

2. Добавьте пакет Redis в проект:

   dotnet add AspireTestApp.AppHost.csproj package Aspire.Hosting.Redis --version 8.0.0
   

1. Чтобы добавить конфигурацию Redis в проект узла приложения, откройте файл AspireTestApp.AppHost/Program.cs и добавьте следующий код:

   // Add Redis
   var redis = builder.AddRedis("cache");
   

   Этот код настраивает оркестрацию для создания локального экземпляра контейнера Redis.

2. Измените текущую службу веб-интерфейсов , чтобы использовать кэш Redis. Измените этот код:

   builder.AddProject<Projects.AspireTestApp_Web>("webfrontend")
       .WithExternalHttpEndpoints()
       .WithReference(apiService);
   

   На этот код:

   builder.AddProject<Projects.AspireTestApp_Web>("webfrontend")
       .WithExternalHttpEndpoints()
       .WithReference(apiService)
       .WithReference(redis);
   

   Метод WithReference расширения настраивает пользовательский интерфейс для автоматического использования Redis для кэширования выходных данных.

   Затем мы можем использовать Redis в используемом проекте.

Visual Studio

1. В Обозреватель решений щелкните правой кнопкой мыши проект AspireTestApp.Web и выберите пункт "Управление пакетами NuGet".
2. Щелкните вкладку Обзор и выберите Включить предварительные выпуски.
3. Найдите нужный redis и выберите пакет Aspire.StackExchange.Redis.OutputCaching.
4. В правой области для версии выберите последнюю версию 8.0.0 и нажмите кнопку "Установить".
5. В диалоговом окне "Принятие лицензии" нажмите кнопку "Принять".

Интерфейс командной строки.NET

1. Перейдите в папку веб-проекта:

   cd AspireTestApp/AspireTestApp.Web
   

2. Добавьте пакет Redis в проект:

   dotnet add package Aspire.StackExchange.Redis.OutputCaching --version 8.0.0
   

Теперь используйте Visual Studio для добавления кода для использования компонента Redis.

1. Если вам нужно, откройте решение AspireTestApp в Visual Studio.

2. В Обозреватель решений в проекте AspireTestApp.Web выберите Program.cs.

3. Добавьте этот код в var builder = WebApplication.CreateBuilder(args);:

   // Add Redis caching
   builder.AddRedisOutputCache("cache");
   

   Этот код выполняет следующие действия.

   • Настраивает кэширование выходных данных ASP.NET Core для использования экземпляра Redis с указанным именем подключения.
   • Автоматически включает соответствующие проверки работоспособности, ведение журнала и телеметрию.

4. Замените содержимое AspireTestApp.Web/Components/Pages/Home.razor следующим кодом:

   @page "/"
   @attribute [OutputCache(Duration = 10)]
   
   <PageTitle>Home</PageTitle>
   
   <h1>Hello, world!</h1>
   
   Welcome to your new app on @DateTime.Now
   

   В приведенном выше коде OutputCache атрибут задает 10-секундную длительность. После кэширования страницы каждый последующий запрос в 10-секундном окне получает кэшированные выходные данные.

Вы можете увидеть, что Aspire предназначен для упрощения добавления новых компонентов в приложение. Вы добавите новый компонент в приложение, добавив пакет NuGet, а затем добавьте несколько строк кода в файл Program.cs в проектах Web и AppHost . Затем Приложение Aspire автоматически настраивает контейнер Redis и кэширование выходных данных.

Тестирование приложения

Теперь давайте запустите приложение, чтобы увидеть кэширование в действии. В Visual Studio:

1. В меню выберите "Отладка", а затем нажмите кнопку "Начать отладку " (кроме того, нажмите клавишу F5). Решение создается и панель мониторинга Aspire открывается в веб-браузере по умолчанию.

2. Выберите URL-адрес конечной точки для службы веб-интерфейсов, чтобы просмотреть домашнюю страницу приложения.

3. В браузере обновите страницу несколько раз. Время на странице не изменяется в течение 10 секунд кэша.

   

   Решение создает контейнер Redis. Откройте Docker Desktop , чтобы просмотреть запущенный контейнер.

   

4. Чтобы остановить работу решения в Visual Studio, нажмите клавиши SHIFT+F5.

5. Откройте Docker Desktop и выберите контейнеры или приложения. Вы увидите, что redis:latest больше не работает.

Вы узнали, как легко добавить новый компонент кэширования в приложение с помощью .NET Aspire. Вы добавили пакет NuGet, а затем добавили несколько строк кода. .NET Aspire автоматически настраивает контейнер Redis и кэширование выходных данных.