Сведения о средствах .NET Aspire
.NET Aspire добавляет средства в пользовательский интерфейс Visual Studio для создания облачных приложений и управления ими. Эти средства могут облегчить путаницу, так как ясно, какие компоненты составляют полное приложение, даже если они выполняются в разных контейнерах. Панель мониторинга .NET Aspire также представляет единое представление запущенного приложения с данными диагностики и мониторинга, которые помогут вам протестировать и отлаживать его.
Рассмотрим мнимый открытый стиль одежды и оборудования компании снова. Ваши команды разработчиков выполнили свои архитектуры для каждой микрослужбы и хотят начать разработку. Вы хотите понять, как они могут работать с .NET Aspire в Visual Studio и в командной строке.
В этом уроке вы узнаете о средствах .NET Aspire и о том, как они помогают разработчикам создавать и отлаживать облачные приложения.
Необходимые компоненты
Перед установкой .NET Aspire на компьютере вам потребуется следующее:
- .NET 8.0
- Docker Desktop или Podman для размещения контейнеров.
- Интегрированная среда разработки (IDE), например Visual Studio или редактор кода, например Visual Studio Code
При использовании Visual Studio необходимо установить версию 17.9 или более позднюю.
Примечание.
Docker Desktop или Podman необходимо разместить контейнеры, которые .NET Aspire использует для запуска микрослужб и некоторых служб резервного копирования. Так как .NET Aspire настраивает и компилирует образы и контейнеры для вас, вам не нужно быть экспертом в контейнерах.
Установка .NET Aspire
Если вы используете Microsoft Visual Studio, вы можете установить .NET Aspire, добавив компонент пакета SDK для .NET Aspire из рабочей нагрузки ASP.NET и веб-разработки . После установки новые средства становятся доступными. Вы выполните эти действия в упражнении далее в этом модуле.
Кроме того, если вы не хотите использовать установщик Visual Studio, можно использовать интерфейс командной строки .NET для установки .NET Aspire:
dotnet workload update
dotnet workload install aspire
dotnet workload list
Шаблоны проектов в Visual Studio
Добавлены пять шаблонов приложений .NET Aspire. Их можно использовать для создания нового приложения:
- Приложение .NET Aspire. Этот шаблон создает минимальное решение .NET Aspire с двумя проектами: проект узла приложений управляет решением и проектом по умолчанию службы управляет повторно используемыми сведениями о конфигурации для обеспечения устойчивости, обнаружения служб и телеметрии.
- Начальное приложение .NET Aspire: этот шаблон создает полное решение. Он включает те же проекты узла приложений и службы по умолчанию, что и предыдущий шаблон, и добавляет проекты для серверной службы API и интерфейсного веб-интерфейса.
- Узел приложения .NET Aspire: этот шаблон создает только проект узла приложений в новом решении. Для завершения работы приложения можно добавлять микрослужбы, библиотеки и другие проекты.
- По умолчанию службы .NET Aspire: этот шаблон создает только проект по умолчанию службы в новом решении.
- Проект теста .NET Aspire: этот шаблон создает тесты xUnit для узла приложения.
Примечание.
Вы также можете добавить .NET Aspire в любое существующее веб-приложение .NET, которое вы открываете в Visual Studio. В Обозреватель решений щелкните проект правой кнопкой мыши, выберите "Добавить" и выберите службу поддержки .NET Aspire Orchestrator. Это действие добавляет проекты узла и службы приложений по умолчанию в решение и регистрирует существующий проект в них для обнаружения служб и других функций .NET Aspire.
Панель мониторинга .NET Aspire
При работе с приложением можно использовать отладчик Visual Studio для выполнения кода, нажав клавишу F5 . При этом Visual Studio автоматически создает образы Docker для каждой микрослужбы, запускает службу Docker, если она не запущена, и запускает полное приложение. Он также отображает панель мониторинга .NET Aspire, которую можно использовать для подключения к микрослужбам, изучения производительности приложения и мониторинга его поведения:
Внимание
Шаблоны проектов .NET Aspire задают проект узла приложений в качестве запускаемого проекта для решения. При изменении запускаемого проекта панель мониторинга .NET Aspire и другие аспекты решения не будут работать правильно во время отладки.
На домашней странице панели мониторинга можно просмотреть все ресурсы, составляющие приложение. Каждая микрослужба указана в качестве проекта. Резервные службы, такие как кэши Redis, перечислены как контейнеры. Другие компоненты могут присутствовать в качестве исполняемых файлов. Дополнительные сведения для каждого ресурса можно получить. Микрослужбы также имеют столбец конечной точки . Выберите ссылку в этом столбце, чтобы подключиться к ресурсу в браузере и проверить его.
На панели мониторинга есть четыре раздела мониторинга:
- Журналы консоли: на этой странице отображается любой текст, отправляемый в стандартные выходные данные проекта, выбранного в верхней части. Стандартные выходные данные часто используются для отчета о событиях или сообщениях о состоянии.
- Структурированные журналы: на этой странице отображаются события, созданные библиотекой OpenTelemetry. Структурированные журналы проще запрашивать, чем другие события журнала, так как они сохраняют шаблон сообщения и параметры.
- Трассировки: на этой странице отображаются трассировки для каждого запроса, полученного приложением. Сведения включают метку времени, когда трассировка завершена, а также длительность трассировки. В столбце Spans отображаются все ресурсы, участвующие в запросе. Если выбрать представление в столбце сведений, вы увидите временная шкала, иллюстрирующий все диапазоны трассировки и их длительность.
- Метрики: на этой странице отображаются диаграммы для любой выбранной метрики. Сначала выберите проект в верхней части страницы. Затем выберите из списка метрик, которые включают значения, такие как активные счетчики запросов, длительность запроса, счетчики подключений и другие данные производительности. При выборе метрики отображается динамическая диаграмма. Вы можете изменить интервал времени для диаграммы или фильтра, чтобы детализировать дополнительные диагностические сведения.