Размещение и развертывание ASP.NET Core Blazor

В этой статье объясняется, как размещать и развертывать Blazor приложения.

Публикация приложения

Приложения публикуются для развертывания в конфигурации 'Release'.

dotnet publish

dotnet publish -c Release

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

Очистите целевую папку публикации

При использовании dotnet publish команды в командной оболочке для публикации приложения команда создает необходимые файлы для развертывания на основе текущего состояния проекта и помещает файлы в указанную выходную папку. Команда не очищает целевую папку автоматически перед публикацией приложения.

Чтобы очистить целевую папку автоматически перед публикацией приложения, добавьте следующий целевой объект MSBuild в файл проекта приложения (.csproj) под корневым <Project> элементом:

<Target Name="_RemovePublishDirBeforePublishing" BeforeTargets="BeforePublish">
  <RemoveDir Directories="$(PublishDir)" Condition="'$(PublishDir)' != ''" />
</Target>

Расположения публикации по умолчанию

СЛУЖБЫ IIS

Сведения о размещении Blazor приложения в IIS см. в следующих ресурсах:

• Размещение IIS
  • Публикация приложения ASP.NET Core в IIS
  • Размещение ASP.NET Core в Windows со службами IIS
• Размещение и развертывание серверных приложений ASP.NET Core Blazor: Blazor Web Apps (.NET 8 или более поздней версии) и Blazor Server приложений (.NET 7 или более ранних версий), работающих в службах IIS, включая службы IIS с виртуальными машинами Azure под управлением ОС Windows и Службы приложений Azure.
• Размещение и развертывание ASP.NET Core Blazor WebAssembly с помощью IIS: автономные Blazor WebAssembly приложения (все выпуски .NET) и размещенные приложения (.NET 7 или более ранние Blazor WebAssembly версии).
• Хостинг подприложений IIS
  • Следуйте инструкциям по базовому пути приложения перед публикацией приложения. В примерах используется базовый путь /CoolApp, и показано, как определить его из настроек приложения или других поставщиков конфигурации.
  • Следуйте инструкциям по настройке вложенных приложений в расширенной конфигурации. Путь к папке дочернего приложения на корневом сайте становится виртуальным путем дочернего приложения. Для базового пути приложения /CoolApp приложение Blazor размещается в папке с именем CoolApp в корневом сайте, а подприложение получает виртуальный путь /CoolApp.

Совместное использование пула приложений среди приложений ASP.NET Core не поддерживается, включая приложения Blazor. Используйте один пул приложений для каждого приложения при размещении с IIS и избегайте использования виртуальных каталогов IIS для размещения нескольких приложений.

<WasmBundlerFriendlyBootConfig>true</WasmBundlerFriendlyBootConfig>

Blazor ServerКонфигурация MapFallbackToPage

Этот раздел применяется только к приложениям Blazor Server . MapFallbackToPage не поддерживается ни в Blazor Web Appах, ни в Blazor WebAssembly приложениях.

В сценариях, где приложению требуется отдельная область с настраиваемыми ресурсами и компонентами Razor, выполните приведенные ниже действия.

• Создайте папку в папке Pages приложения для хранения ресурсов. Например, раздел администратора приложения создается в новой папке с именем Admin (Pages/Admin).

• Создайте корневую страницу (_Host.cshtml) для области. Например, создайте файл Pages/Admin/_Host.cshtml на основе основной корневой страницы приложения (Pages/_Host.cshtml). Не указывайте директиву @page на странице _Host администратора.

• Добавьте макет к папке области (например, Pages/Admin/_Layout.razor). В макете для отдельной области задайте тег <base>href в соответствии с папкой области (например, <base href="/Admin/" />). В демонстрационных целях добавьте ~/ к статическим ресурсам на странице. Например:

  • ~/css/bootstrap/bootstrap.min.css
  • ~/css/site.css
  • ~/BlazorSample.styles.css (пространство имен для примера приложения — BlazorSample)
  • ~/_framework/blazor.server.js (скрипт Blazor)

• Если область должна иметь собственную папку со статическими файлами, добавьте папку и укажите её расположение в промежуточном ПО для статических файлов в Program.cs (например, app.UseStaticFiles("/Admin/wwwroot")).

• Компоненты Razor добавляются в папку области. Как минимум, добавьте компонент Index в папку области с правильной директивой @page для области. Например, добавьте файл Pages/Admin/Index.razor на основе заданного по умолчанию файла Pages/Index.razor приложения. Укажите область администратора в качестве шаблона маршрута в верхней части файла (@page "/admin"). Добавьте дополнительные компоненты по мере необходимости. Например, Pages/Admin/Component1.razor с директивой @page и шаблоном маршрута @page "/admin/component1.

• В Program.cs вызовите MapFallbackToPage для пути запроса области сразу перед путем резервной корневой страницы до страницы _Host:

  ...
  app.UseRouting();
  
  app.MapBlazorHub();
  app.MapFallbackToPage("~/Admin/{*clientroutes:nonfile}", "/Admin/_Host");
  app.MapFallbackToPage("/_Host");
  
  app.Run();