.NET Aspire Community Toolkit Node.js värdtillägg

Artikel
12/15/2024

Omfattar:Värdtjänstintegration inte Client integration

Not

Den här integreringen är en del av .NET.NET Aspire Community Toolkit och stöds inte officiellt av .NET.NET Aspire-teamet.

I den här artikeln får du lära dig mer om .NET Aspire Community Toolkit Node.js värdtilläggspaketet som ger extra funktioner till .NET AspireNodeJS-värdpaketet. Tilläggspaketet innehåller följande funktioner:

Kör Vite-applikationer
Köra Node.js program med Yarn och pnpm
Se till att paketen installeras innan du kör programmet (med hjälp av den angivna pakethanteraren)

Värdintegrering

Kom igång med .NET Aspire Community Toolkit Node.js värdtillägg genom att installera 📦 CommunityToolkit.Aspire. Hosting.NodeJS.Extensions NuGet-paketet i AppHost-projektet.

.NET CLI
PackageReference

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

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

Mer information finns i dotnet add package eller Hantera paketberoenden i .NET applikationer.

Exempel på användning

I följande avsnitt beskrivs olika användningar, från att köra Vite-program till att använda specifika pakethanterare.

Kör specifika pakethanterare

Det här integreringstillägget lägger till stöd för att köra Node.js program med Yarn eller pnpm som pakethanterare.

garn
pnpm

var builder = DistributedApplication.CreateBuilder(args);

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

var builder = DistributedApplication.CreateBuilder(args);

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

Kör Vite-appar

Det här integreringstillägget lägger till stöd för att köra utvecklingsservern för Vite-program. Som standard används npm-pakethanteraren för att starta, men detta kan åsidosättas med argumentet packageManager.

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();

Installera paket

När du använder metoderna WithNpmPackageInstallation, WithYarnPackageInstallation eller WithPnpmPackageInstallation används pakethanteraren för att installera paketen innan programmet startas. Dessa metoder är användbara för att säkerställa att paket installeras innan programmet startas, ungefär som när ett .NET program återställer NuGet-paket innan de körs.

Dela via