Compartir a través de

.NET .NET Aspire hospedaje de Bun

  • Artículo

Incluye:integración de hospedaje no Client

Nota

Esta integración forma parte del Community Toolkit y no es compatible oficialmente con el equipo de .

Bun es un marco moderno, rápido y ligero para crear aplicaciones web con TypeScript. La integración de hospedaje de .NET Aspire Bun le permite hospedar aplicaciones Bun en el proyecto host de la aplicación .NET Aspire y proporcionarla a otros recursos de la aplicación.

Integración de hospedaje

La integración de alojamiento de Bun modela una aplicación de Bun como el tipo Aspire.Hosting.ApplicationModel.BunAppResource. Para acceder a este tipo y a las API que le permitan integrarlo en el proyecto host de la aplicación, instale el 📦 CommunityToolkit.Aspire.Hosting.Bun paquete NuGet en dicho proyecto.

Esta integración espera que el ejecutable de Bun ya se haya instalado en el equipo host y que esté disponible en la ruta de acceso del sistema.

dotnet add package CommunityToolkit.Aspire.Hosting.Bun

Para obtener más información, consulte dotnet add package o Gestionar las dependencias de paquetes en aplicaciones .NET.

Agregar un recurso Bun

En el proyecto host de la aplicación, llame al Aspire.Hosting.BunAppExtensions.AddBunApp en la instancia de builder para agregar un recurso de aplicación Bun como se muestra en el ejemplo siguiente:

var builder = DistributedApplication.CreateBuilder(args);

var api = builder.AddBunApp("api")
                 .WithHttpEndpoint(env: "PORT");

var exampleProject = builder.AddProject<Projects.ExampleProject>()
                            .WithReference(api);

// After adding all resources, run the app...

Por defecto, el directorio de trabajo de la aplicación es una carpeta del mismo nivel que el host de la aplicación, que coincide con el nombre asignado al recurso, y el punto de entrada será :::no-loc text="index.ts"::. Ambas se pueden personalizar pasando parámetros adicionales al método AddBunApp.

var api = builder.AddBunApp("api", "../api-service", "start")
    .WithHttpEndpoint(env: "PORT");

La aplicación Bun se puede agregar como referencia a otros recursos del proyecto host de la aplicación.

Asegurarse de que los paquetes están instalados

Para asegurarse de que la aplicación Bun tiene todas las dependencias instaladas como se define en el archivo de bloqueo, puede usar el método Aspire.Hosting.BunAppExtensions.WithBunPackageInstaller para asegurarse de que la instalación del paquete se ejecute antes de iniciar la aplicación.

var api = builder.AddBunApp("api")
                 .WithHttpEndpoint(env: "PORT")
                 .WithBunPackageInstaller();

Consulte también