Compartilhar via

hospedagem do .NET.NET Aspire Bun

  • Artigo

Inclui:integração de hospedagem não Client integração

Nota

Essa integração faz parte do do Community Toolkit e não é oficialmente compatível com a equipe de .

Bun é uma estrutura moderna, rápida e leve para criar aplicativos Web com TypeScript. A integração de hospedagem do .NET Aspire Bun permite hospedar aplicativos Bun em seu projeto de host de aplicativo .NET Aspire e compartilhá-los com outros recursos em seu aplicativo.

Integração de hospedagem

A integração de hospedagem do Bun modela um aplicativo Bun como o tipo Aspire.Hosting.ApplicationModel.BunAppResource. Para acessar este tipo e as APIs que permitem adicioná-lo ao projeto host do aplicativo, instale o pacote NuGet 📦 CommunityToolkit.Aspire.Hosting.Bun no projeto.

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

dotnet add package CommunityToolkit.Aspire.Hosting.Bun

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

Adicionar um recurso do Bun

No projeto de host do aplicativo, chame o Aspire.Hosting.BunAppExtensions.AddBunApp na instância de 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 adjacente ao host do aplicativo, cujo nome corresponderá ao 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");

O aplicativo Bun pode ser adicionado como uma referência a outros recursos no projeto hospedeiro do aplicativo.

Garantir que os pacotes sejam instalados

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

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

Consulte também