다음을 통해 공유

.NET Aspire Azure 정적 웹 애플리케이션 에뮬레이터 통합

  • 아티클

포함:호스팅 통합 통합 아님 Client

메모

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

이 문서에서는 .NET.NET AspireAzure Static Web Apps 에뮬레이터 호스팅 통합을 사용하여 에뮬레이터를 사용하여 로컬로 Azure Static Web Apps를 실행하는 방법을 알아봅니다. 에뮬레이터는 앱 호스트에 정의된 리소스를 사용하여 정적 프런트 엔드와 API 백 엔드를 모두 프록시할 수 있습니다.

이 통합을 위해서는 Azure Static Web Apps CLI 실행해야 하며, Azure Static Web Apps에 배포하지 않고 로컬 개발을 위해 에뮬레이터 호스팅만 지원합니다.

호스팅 통합

.NET Aspire Azure Static Web Apps 에뮬레이터 호스팅 통합을 시작하려면 AppHost 프로젝트에 📦 CommunityToolkitAspire.Hosting.Azure.StaticWebApps NuGet 패키지를 설치하세요.

dotnet add package CommunityToolkit.Aspire.Hosting.Azure.StaticWebApps

자세한 내용은 dotnet add package 또는 .NET 애플리케이션에서 패키지 종속성 관리하기를 참조하십시오.

예제 사용

앱 호스트 프로젝트의 Program.cs 파일에서 백 엔드 및 프런트 엔드 리소스를 정의합니다. 그런 다음 AddSwaEmulator 메서드를 호출하여 에뮬레이터를 만들고 WithAppResource 및 WithApiResource 메서드를 사용하여 리소스를 전달합니다.

var builder = DistributedApplication.CreateBuilder(args);

// Define the API resource
var api = builder.AddProject<Projects.Aspire_CommunityToolkit_StaticWebApps_ApiApp>("api");

// Define the frontend resource
var web = builder
    .AddNpmApp("web", Path.Combine("..", "CommunityToolkit.Aspire.StaticWebApps.WebApp"), "dev")
    .WithHttpEndpoint(env: "PORT")
    .WithExternalHttpEndpoints();

// Create a SWA emulator with the frontend and API resources
_ = builder
    .AddSwaEmulator("swa")
    .WithAppResource(web)
    .WithApiResource(api);

builder.Build().Run();

앞의 코드는 API 및 프런트 엔드 리소스를 정의하고 리소스를 사용하여 에뮬레이터를 만듭니다. 그런 다음 에뮬레이터가 Run 메서드를 사용하여 시작됩니다.

참고 사항