.NET Aspire Community Toolkit Node.js extensões de hospedagem

Artigo
12/12/2024

Inclui:não integração de hospedagem Client integração

Observação

Essa integração faz parte do .NET.NET Aspire Community Toolkit e não é oficialmente suportada pela equipe .NET.NET Aspire.

Neste artigo, você aprenderá sobre o .NET Aspire Community Toolkit Node.js pacote de extensões de hospedagem que fornece funcionalidade extra para o pacote de hospedagem NodeJS .NET Aspire. O pacote de extensões traz os seguintes recursos:

Executando aplicações Vite
Executando aplicativos Node.js usando Yarn e pnpm
Garantir que os pacotes sejam instalados antes de executar o aplicativo (usando o gerenciador de pacotes especificado)

Integração de hospedagem

Para começar a utilizar as extensões de hospedagem do .NET Aspire Community Toolkit Node.js, instale o pacote NuGet do 📦 CommunityToolkit.Aspire.Hosting.NodeJS.Extensions no projeto AppHost.

.NET CLI
PackageReference

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

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

Para obter mais informações, consulte dotnet add package ou Gerir dependências de pacotes em .NET aplicações.

Exemplo de utilização

As seções a seguir detalham vários usos, desde a execução de aplicativos Vite até o uso de gerenciadores de pacotes específicos.

Executar gerenciadores de pacotes específicos

Essa extensão de integração adiciona suporte para executar aplicativos Node.js usando Yarn ou pnpm como o gerenciador de pacotes.

fios
pnpm

var builder = DistributedApplication.CreateBuilder(args);

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

var builder = DistributedApplication.CreateBuilder(args);

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

Executar aplicações Vite

Esta extensão de integração adiciona suporte para executar o server de desenvolvimento para aplicativos Vite. Por padrão, ele usa o gerenciador de pacotes npm para iniciar, mas isso pode ser substituído pelo argumento 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();

Instalar pacotes

Ao usar os métodos WithNpmPackageInstallation, WithYarnPackageInstallation ou WithPnpmPackageInstallation, o gerenciador de pacotes é usado para instalar os pacotes antes de iniciar o aplicativo. Esses métodos são úteis para garantir que os pacotes sejam instalados antes do início do aplicativo, semelhante a como um aplicativo .NET restauraria pacotes NuGet antes da execução.

Partilhar via