.NET Aspire Kit de Ferramentas da Comunidade Node.js extensões de hospedagem

Artigo
12/15/2024

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

Nota

Essa integração faz parte do Community Toolkit do e não é oficialmente suportado pela equipe de .

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

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

Integração de hospedagem

Para começar a usar as extensões de hospedagem do .NET Aspire Community Toolkit Node.js, instale o pacote NuGet 📦 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 Gerenciar dependências de pacotes em .NET aplicações.

Exemplo de uso

As seções a seguir detalham vários usos, desde a execução de aplicativos do 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.

fio
pnpm

var builder = DistributedApplication.CreateBuilder(args);

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

var builder = DistributedApplication.CreateBuilder(args);

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

Executar aplicativos do Vite

Essa extensão de integração adiciona suporte para a execução de server no desenvolvimento de 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 de ser executado.

Compartilhar via