Partilhar via

.NET .NET Aspire Bun hospedagem

  • Artigo

Inclui:não integração de hospedagemClient integração

Observação

Essa integração faz parte do .NET.NET Aspire Community Toolkit e não é oficialmente suportada pela equipe .NET.NET Aspire.

Bun é uma estrutura moderna, rápida e leve para a criação de aplicações Web com o TypeScript. A integração de hospedagem .NET Aspire Bun permite que você hospede aplicativos Bun em seu projeto de host de aplicativo .NET Aspire e forneça-o a outros recursos em seu aplicativo.

Integração de hospedagem

A integração de hospedagem Bun modela um aplicativo Bun como o tipo Aspire.Hosting.ApplicationModel.BunAppResource. Para aceder a este tipo e às APIs que permitem adicioná-lo ao seu projeto de anfitrião de aplicações, instale o pacote 📦 CommunityToolkit.Aspire.Hosting.Bun NuGet no projeto de anfitrião de aplicações.

Essa integração espera que o executável Bun já tenha sido instalado na máquina host e que esteja disponível no caminho do sistema.

dotnet add package CommunityToolkit.Aspire.Hosting.Bun

Para obter mais informações, consulte dotnet add package ou Gerir dependências de pacotes em aplicações .NET.

Adicionar um recurso Bun

Em seu projeto de host de aplicativo, chame o Aspire.Hosting.BunAppExtensions.AddBunApp na instância builder para adicionar um recurso de aplicativo Bun, conforme mostrado no exemplo a seguir:

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 padrão, o diretório de trabalho do aplicativo será uma pasta irmã para o host do aplicativo correspondente ao nome fornecido ao recurso, e o ponto de entrada será :::no-loc text="index.ts"::. Ambos podem ser personalizados passando parâmetros adicionais para o método AddBunApp.

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

A aplicação Bun pode ser adicionada como uma referência a outros recursos no projeto de host da aplicação.

Garantir que os pacotes estejam instalados

Para garantir que o aplicativo Bun tenha todas as dependências instaladas conforme definido no lockfile, você pode usar o método Aspire.Hosting.BunAppExtensions.WithBunPackageInstaller para garantir que a instalação do pacote seja executada antes que o aplicativo seja iniciado.

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

Ver também