.NET Aspire Community Toolkit Node.js estensioni di hosting

Articolo
01/23/2025

Includono:integrazione dell'hosting non Client

Nota

Questa integrazione fa parte di .NET.NET Aspire Community Toolkit e non è ufficialmente supportata dal team .NET.NET Aspire.

In questo articolo vengono fornite informazioni sul pacchetto di estensioni di hosting .NET Aspire Community Toolkit Node.js che offre funzionalità aggiuntive per il pacchetto di hosting nodeJS .NET Aspire. Il pacchetto di estensioni offre le funzionalità seguenti:

Esecuzione di applicazioni Vite
Esecuzione di applicazioni Node.js usando Yarn e Pnpm
Verifica che i pacchetti siano installati prima di eseguire l'applicazione (usando la gestione pacchetti specificata)

Integrazione dell'hosting

Per iniziare a utilizzare le estensioni di hosting del .NET Aspire Community Toolkit Node.js, installare il pacchetto NuGet 📦 CommunityToolkit.Aspire.Hosting.NodeJS.Extensions nel progetto AppHost.

.NET CLI
PackageReference

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

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

Per altre informazioni, vedere dotnet add package o Gestisci le dipendenze dei pacchetti nelle applicazioni .NET.

Esempio di utilizzo

Le sezioni seguenti illustrano in dettaglio vari utilizzi, dall'esecuzione di applicazioni Vite all'uso di gestori di pacchetti specifici.

Eseguire gestori di pacchetti specifici

Questa estensione di integrazione aggiunge il supporto per l'esecuzione di applicazioni Node.js tramite Yarn o pnpm come gestione pacchetti.

filato
pnpm

var builder = DistributedApplication.CreateBuilder(args);

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

var builder = DistributedApplication.CreateBuilder(args);

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

Eseguire app Vite

Questa estensione di integrazione aggiunge il supporto per l'esecuzione del server di sviluppo per le applicazioni Vite. Per impostazione predefinita, usa il gestore pacchetti npm per l'avvio, ma può essere sostituito con l'argomento 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();

Installare i pacchetti

Quando si usano i metodi WithNpmPackageInstallation, WithYarnPackageInstallation o WithPnpmPackageInstallation, la gestione pacchetti viene usata per installare i pacchetti prima di avviare l'applicazione. Questi metodi sono utili per assicurarsi che i pacchetti vengano installati prima dell'avvio dell'applicazione, in modo analogo a come un'applicazione .NET ripristina i pacchetti NuGet prima dell'esecuzione.

Condividi tramite