.NET Aspire 커뮤니티 도구 키트 Node.js 호스팅 확장

아티클
12/13/2024

메모

이 통합은 .NET.NET Aspire 커뮤니티 도구 키트 일부이며 .NET.NET Aspire 팀에서 공식적으로 지원하지 않습니다.

이 문서에서는 .NET AspireNodeJS 호스팅 패키지추가 기능을 제공하는 .NET Aspire Community Toolkit Node.js 호스팅 확장 패키지에 대해 알아봅니다. 확장 패키지는 다음과 같은 기능을 제공합니다.

Vite 애플리케이션 실행
Yarn와 pnpm를 사용하여 Node.js 애플리케이션을 실행
애플리케이션을 실행하기 전에 패키지가 설치되어 있는지 확인합니다(지정된 패키지 관리자 사용).

호스팅 통합

.NET Aspire Community Toolkit Node.js 호스팅 확장을 시작하려면 📦 CommunityToolkit를 설치합니다.Aspire. Hosting.NodeJS.Extensions는 AppHost 프로젝트에서 NuGet 패키지를.

.NET CLI
PackageReference

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

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

자세한 내용은 dotnet add package 또는 .NET 응용 프로그램에서 패키지 종속성 관리를 참조하세요.

사용 예

다음 섹션에서는 Vite 애플리케이션 실행부터 특정 패키지 관리자 사용에 이르기까지 다양한 용도를 자세히 설명합니다.

특정 패키지 관리자 실행

이 통합 확장은 Yarn 또는 pnpm을 패키지 관리자로 사용하여 Node.js 애플리케이션을 실행하기 위한 지원을 추가합니다.

원사
pnpm

var builder = DistributedApplication.CreateBuilder(args);

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

var builder = DistributedApplication.CreateBuilder(args);

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

Vite 앱 실행

이 통합 확장은 Vite 애플리케이션에 대한 개발 server 실행하기 위한 지원을 추가합니다. 기본적으로 npm 패키지 관리자를 사용하여 시작하지만 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();

패키지 설치

WithNpmPackageInstallation, WithYarnPackageInstallation 또는 WithPnpmPackageInstallation 메서드를 사용하는 경우 패키지 관리자는 애플리케이션을 시작하기 전에 패키지를 설치하는 데 사용됩니다. 이러한 방법은 .NET 애플리케이션이 실행하기 전에 NuGet 패키지를 복원하는 방법과 유사하게 애플리케이션이 시작되기 전에 패키지가 설치되도록 하는 데 유용합니다.

다음을 통해 공유