extensions d’hébergement .NET Aspire Community Toolkit Node.js

Article
01/23/2025

Inclut :intégration d’hébergement pas Client d’intégration

Note

Cette intégration fait partie du community Toolkit et n’est pas officiellement prise en charge par l’équipe .

Dans cet article, vous allez découvrir le package d’extensions d’hébergement .NET Aspire Community Toolkit Node.js qui fournit des fonctionnalités supplémentaires au package d’hébergement .NET AspireNodeJS. Le package d’extensions offre les fonctionnalités suivantes :

Exécution d’applications Vite
Exécution d’applications Node.js à l’aide de Yarn et de pnpm
S’assurer que les packages sont installés avant d’exécuter l’application (à l’aide du gestionnaire de package spécifié)

Intégration de l’hébergement

Pour commencer à utiliser les extensions d'hébergement du .NET Aspire Community Toolkit Node.js, installez le paquet NuGet 📦 CommunityToolkit.Aspire.Hosting.NodeJS.Extensions dans le projet AppHost.

.NET CLI
packageReference

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

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

Pour plus d’informations, consultez dotnet add package ou gérer les dépendances des packages dans les applications .NET.

Exemple d’utilisation

Les sections suivantes détaillent différentes utilisations, de l’exécution d’applications Vite à l’aide de gestionnaires de packages spécifiques.

Exécuter des gestionnaires de package spécifiques

Cette extension d’intégration ajoute la prise en charge de l’exécution d’applications Node.js à l’aide de Yarn ou pnpm en tant que gestionnaire de package.

fil
pnpm

var builder = DistributedApplication.CreateBuilder(args);

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

var builder = DistributedApplication.CreateBuilder(args);

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

Exécuter des applications Vite

Cette extension d’intégration ajoute la prise en charge de l’exécution du serveur de développement pour les applications Vite. Par défaut, il utilise le gestionnaire de package npm pour lancer, mais cela peut être remplacé par l’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();

Installer des packages

Lorsque vous utilisez le WithNpmPackageInstallation, WithYarnPackageInstallation ou WithPnpmPackageInstallation méthodes, le gestionnaire de package est utilisé pour installer les packages avant de démarrer l’application. Ces méthodes sont utiles pour s’assurer que les packages sont installés avant le démarrage de l’application, comme la façon dont une application .NET restaurerait des packages NuGet avant d’être en cours d’exécution.

Partager via