Hospedaje e implementación de ASP.NET Core Blazor

En este artículo se explica cómo hospedar e implementar aplicaciones de Blazor.

Publicar la aplicación

Las aplicaciones se publican para implementación en la configuración de versión.

Visual Studio

1. Seleccione el comando Publicar {APPLICATION} en el menú Compilar, donde el marcador {APPLICATION} de posición nombre de la aplicación.
2. Seleccione el destino de publicación. Para publicar localmente, seleccione Carpeta.
3. Acepte la ubicación predeterminada del campo Elegir una carpeta o especifique una ubicación diferente. Haga clic en el botón Publish.

CLI de .NET

Use el comando dotnet publish para publicar la aplicación con una configuración de versión:

dotnet publish -c Release

Al publicar la aplicación se desencadena una restauración de las dependencias del proyecto y se compila el proyecto antes de crear los recursos para la implementación. Como parte del proceso de compilación, se quitan los ensamblados y métodos que no se usan para reducir los tiempos de carga y el tamaño de descarga de la aplicación.

Ubicaciones de publicación predeterminadas

• Blazor Web App: la aplicación se publica en la carpeta /bin/Release/{TARGET FRAMEWORK}/publish, donde el marcador de posición {TARGET FRAMEWORK} corresponde al marco de destino. Implemente el contenido de la carpeta publish en el host.
• Independiente Blazor WebAssembly: La aplicación se publica en la carpeta bin/Release/{TARGET FRAMEWORK}/publish o bin/Release/{TARGET FRAMEWORK}/browser-wasm/publish. Para implementar la aplicación como un sitio estático, copie el contenido de la carpeta wwwroot en el host del sitio estático.

IIS

Para hospedar una aplicación Blazor en IIS, consulte los siguientes recursos:

• Hospedaje de IIS
  • Publicación de una aplicación ASP.NET Core en IIS
  • Hospedaje de ASP.NET Core en Windows con IIS
• Blazor: s (.NET 8 u versiones posteriores) y Blazor Web App aplicaciones (.NET 7 o versiones anteriores) que se ejecutan en IIS, incluido IIS con Azure Virtual Machines (VMs) que ejecutan el sistema operativo Windows y Azure App Service.
• Hospede e implemente ASP.NET Core Blazor WebAssembly con IIS: aplicaciones independientes Blazor WebAssembly (todas las versiones de .NET) y aplicaciones hospedadas Blazor WebAssembly (.NET 7 o versiones anteriores).
• Hospedaje de subaplicaciones de IIS
  • Siga las instrucciones de ruta de acceso base de la aplicación antes de publicar la aplicación. Los ejemplos usan una ruta de acceso base de la aplicación de /CoolApp y muestran cómo obtener la ruta de acceso base de la configuración de la aplicación u otros proveedores de configuración.
  • Siga las instrucciones de configuración de la subaplicación en Configuración avanzada. La ruta de acceso de la carpeta de la aplicación secundaria en el sitio raíz se convierte en la ruta de acceso virtual de la aplicación secundaria. Para una ruta de acceso base de la aplicación de /CoolApp, la Blazor aplicación se coloca en una carpeta denominada CoolApp en el sitio raíz y la aplicación secundaria toma una ruta de acceso virtual de /CoolApp.

No se admite el uso compartido de grupos de aplicaciones entre aplicaciones de ASP.NET Core, incluidas las aplicaciones Blazor. Use un grupo de aplicaciones por aplicación al hospedar con IIS y evite el uso de directorios virtuales de IIS para hospedar varias aplicaciones.

Configuración de Blazor ServerMapFallbackToPage

Esta sección solo se aplica a las aplicaciones Blazor Server. MapFallbackToPage no se es compatible con Blazor Web App ni en aplicaciones de Blazor WebAssembly.

En escenarios en los que una aplicación requiere un área independiente con componentes y recursos de Razor personalizados:

• Cree una carpeta dentro de la carpeta Pages de la aplicación para contener los recursos. Por ejemplo, se crea una sección de administrador de una aplicación en una nueva carpeta denominada Admin (Pages/Admin).

• Cree una página raíz (_Host.cshtml) para el área. Por ejemplo, cree un archivo Pages/Admin/_Host.cshtml desde la página raíz principal de la aplicación (Pages/_Host.cshtml). No proporcione una directiva @page en la página _Host de administración.

• Agregue un diseño a la carpeta del área (por ejemplo, Pages/Admin/_Layout.razor). En el diseño del área independiente, establezca el <base> de la etiqueta href para que coincida con la carpeta del área (por ejemplo, <base href="/Admin/" />). Para fines de demostración, agregue ~/ a los recursos estáticos de la página. Por ejemplo:

  • ~/css/bootstrap/bootstrap.min.css
  • ~/css/site.css
  • ~/BlazorSample.styles.css (el espacio de nombres de la aplicación de ejemplo es BlazorSample)
  • ~/_framework/blazor.server.js (script Blazor)

• Si el área debe tener su propia carpeta de recursos estáticos, agregue la carpeta y especifique su ubicación en Middleware de archivos estáticos en Program.cs (por ejemplo, app.UseStaticFiles("/Admin/wwwroot")).

• Se agregan componentes Razor a la carpeta del área. Como mínimo, agregue un componente Index a la carpeta de área con la directiva @page correcta para el área. Por ejemplo, agregue un archivo Pages/Admin/Index.razor basado en el archivo Pages/Index.razor predeterminado de la aplicación. Indique el área de administración como plantilla de ruta en la parte superior del archivo (@page "/admin"). Agregue componentes adicionales según sea necesario. Por ejemplo, Pages/Admin/Component1.razor con una directiva @page y una plantilla de ruta de @page "/admin/component1.

• En Program.cs, llame a MapFallbackToPage para la ruta de acceso de solicitud del área inmediatamente antes de la ruta de acceso de la página raíz de reserva a la página _Host:

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