Freigeben über

.NET .NET Aspire Bun Hosting

  • Artikel

umfasst:Hosting-Integration nicht Client Integration

Anmerkung

Diese Integration ist Teil des .NET.NET Aspire Community Toolkit und wird vom .NET.NET Aspire Team nicht offiziell unterstützt.

Bun ist ein modernes, schnelles und einfaches Framework zum Erstellen von Webanwendungen mit TypeScript. Mit der .NET Aspire Bun-Hostingintegration können Sie Bun-Anwendungen in Ihrem .NET Aspire App-Hostprojekt hosten und sie anderen Ressourcen in Ihrer Anwendung bereitstellen.

Hosting-Integration

Die Bun Hosting Integration modelliert eine Bun-Anwendung als Aspire.Hosting.ApplicationModel.BunAppResource Typ. Um auf diesen Typ und APIs zuzugreifen, die es Ihnen ermöglichen, ihn zu Ihrem App-Hostprojekt hinzuzufügen, installieren Sie das 📦 CommunityToolkit.Aspire.Hosting.Bun NuGet-Paket im App-Hostprojekt.

Diese Integration erwartet, dass die ausführbare Bun-Datei bereits auf dem Hostcomputer installiert wurde und dass sie im Systempfad verfügbar ist.

dotnet add package CommunityToolkit.Aspire.Hosting.Bun

Weitere Informationen finden Sie unter dotnet add package oder Verwalten der Paketabhängigkeiten in .NET-Anwendungen.

Füge eine Bun-Ressource hinzu

Rufen Sie in Ihrem App-Hostprojekt die Aspire.Hosting.BunAppExtensions.AddBunApp bei der builder-Instanz auf, um eine Bun-Anwendungsressource hinzuzufügen, wie im folgenden Beispiel gezeigt wird:

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...

Standardmäßig wird das Arbeitsverzeichnis der Anwendung ein Ordner sein, der sich im gleichen Verzeichnis wie der App-Host befindet und dem Namen entspricht, der der Ressource vorgegeben wird. Der Einstiegspunkt ist :::no-loc text="index.ts"::. Beide können angepasst werden, indem zusätzliche Parameter an die AddBunApp-Methode übergeben werden.

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

Die Bun-Anwendung kann als Verweis auf andere Ressourcen im App-Hostprojekt hinzugefügt werden.

Die Installation von Paketen sicherstellen

Um sicherzustellen, dass die Bun Anwendung alle in der Lockdatei definierten Abhängigkeiten installiert hat, können Sie die Aspire.Hosting.BunAppExtensions.WithBunPackageInstaller Methode nutzen, um sicherzustellen, dass die Paketinstallation durchgeführt wird, bevor die Anwendung gestartet wird.

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

Siehe auch