.NET Aspire Community Toolkit Node.js Hostingerweiterungen

Artikel
12/15/2024

umfasst:Hosting-Integration keine Client-Integration

Anmerkung

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

In diesem Artikel erfahren Sie mehr über das .NET Aspire Community Toolkit Node.js Hostingerweiterungspaket, das zusätzliche Funktionen für das .NET AspireNodeJS-Hostingpaketbietet. Das Erweiterungspaket bietet die folgenden Features:

Ausführen von Vite--Anwendungen
Ausführen von Node.js-Anwendungen mit -Yarn- und -pnpm-
Sicherstellen, dass die Pakete installiert sind, bevor die Anwendung ausgeführt wird (mithilfe des angegebenen Paket-Managers)

Hostingintegration

Um mit den .NET Aspire Community Toolkit Node.js Hosting-Erweiterungen zu beginnen, installieren Sie das 📦 CommunityToolkit.Aspire.Hosting.NodeJS.Extensions NuGet-Paket im AppHost-Projekt.

.NET CLI
PackageReference

dotnet add package CommunityToolkit.Aspire.Hosting.NodeJS.Extensions

<PackageReference Include="CommunityToolkit.Aspire.Hosting.NodeJS.Extensions"
                  Version="*" />

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

Beispielverwendung

In den folgenden Abschnitten werden verschiedene Verwendungen beschrieben, von der Ausführung von Vite-Anwendungen bis hin zur Verwendung bestimmter Paketmanager.

Führen Sie bestimmte Paketverwaltungstools aus

Diese Integrationserweiterung bietet Unterstützung für die Ausführung von Node.js Anwendungen mit Yarn oder pnpm als Paket-Manager.

Garn-
pnpm

var builder = DistributedApplication.CreateBuilder(args);

builder.AddYarnApp("yarn-demo")
       .WithExternalHttpEndpoints();

var builder = DistributedApplication.CreateBuilder(args);

builder.AddPnpmApp("pnpm-demo")
       .WithExternalHttpEndpoints();

Vite-Apps ausführen

Diese Integrationserweiterung bietet Unterstützung, um die Entwicklungs-server für Vite-Anwendungen auszuführen. Standardmäßig wird der npm Paket-Manager zum Starten verwendet, dies kann jedoch mit dem Argument packageManager überschrieben werden.

var builder = DistributedApplication.CreateBuilder(args);

builder.AddViteApp("vite-demo")
       .WithExternalHttpEndpoints();

builder.AddViteApp("yarn-demo", packageManager: "yarn")
       .WithExternalHttpEndpoints();

builder.AddViteApp("pnpm-demo", packageManager: "pnpm")
       .WithExternalHttpEndpoints();

builder.Build().Run();

Pakete installieren

Bei Verwendung der Methoden WithNpmPackageInstallation, WithYarnPackageInstallation oder WithPnpmPackageInstallation wird der Paket-Manager verwendet, um die Pakete vor dem Starten der Anwendung zu installieren. Diese Methoden sind hilfreich, um sicherzustellen, dass Pakete vor dem Starten der Anwendung installiert werden, ähnlich wie eine .NET Anwendung NuGet-Pakete vor der Ausführung wiederherstellen würde.

Freigeben über