.NET Aspire Community Toolkit Node.js hosting-extensies

Artikel
12/13/2024

Omvat:Hostingintegratie niet Client integratie

Notitie

Deze integratie maakt deel uit van de .NET.NET Aspire Community Toolkit en wordt niet officieel ondersteund door het .NET.NET Aspire team.

In dit artikel krijgt u meer informatie over het .NET Aspire Community Toolkit Node.js hostinguitbreidingspakket dat extra functionaliteit biedt voor het .NET AspireNodeJS-hostingpakket. Het uitbreidingspakket bevat de volgende functies:

Vite-toepassingen uitvoeren
Uitvoeren van Node.js-toepassingen met Yarn en pnpm
Ervoor zorgen dat de pakketten zijn geïnstalleerd voordat de toepassing wordt uitgevoerd (met behulp van de opgegeven pakketbeheerder)

Hostingintegratie

Installeer het 📦 CommunityToolkitAspire.Hosting.NodeJS.Extensions NuGet-pakket in het AppHost-project om aan de slag te gaan met de .NET Aspire Community Toolkit Node.js hostingextensies.

.NET CLI
PackageReference

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

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

Zie dotnet pakket toevoegen of Pakketafhankelijkheden beheren in .NET toepassingenvoor meer informatie.

Voorbeeld van gebruik

In de volgende secties worden verschillende gebruiksgegevens beschreven, van het uitvoeren van Vite-toepassingen tot het gebruik van specifieke pakketbeheerders.

Specifieke pakketbeheerders uitvoeren

Met deze integratie-extensie wordt ondersteuning toegevoegd voor het uitvoeren van Node.js toepassingen met Yarn of pnpm als pakketbeheerder.

garen
pnpm

var builder = DistributedApplication.CreateBuilder(args);

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

var builder = DistributedApplication.CreateBuilder(args);

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

Vite-apps uitvoeren

Met deze integratieextensie wordt ondersteuning toegevoegd voor het uitvoeren van de ontwikkel-server voor Vite-toepassingen. Standaard wordt de npm package manager gebruikt om te starten, maar dit kan worden overschreven met het argument 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();

Pakketten installeren

Wanneer u de WithNpmPackageInstallation, WithYarnPackageInstallation of WithPnpmPackageInstallation methoden gebruikt, wordt pakketbeheer gebruikt om de pakketten te installeren voordat de toepassing wordt gestart. Deze methoden zijn handig om ervoor te zorgen dat pakketten worden geïnstalleerd voordat de toepassing wordt gestart, vergelijkbaar met hoe een .NET-toepassing NuGet-pakketten zou herstellen voordat deze worden uitgevoerd.

Delen via