.NET .NET Aspire 템플릿

아티클
12/14/2024

다양한 .NET.NET Aspire 프로젝트 템플릿을 사용할 수 있습니다. 이러한 템플릿을 사용하여 전체 .NET Aspire 솔루션을 만들거나 기존 .NET Aspire 솔루션에 개별 프로젝트를 추가할 수 있습니다.

템플릿은 ProjectTemplates NuGet 패키지의 에서 이용 가능합니다.

.NET .NET Aspire 템플릿 설치

Visual Studio .NET Aspire 템플릿을 설치하려면 Visual Studio 17.12 이상을 사용하지 않는 한 수동으로 설치해야 합니다. Visual Studio 17.9~17.11의 경우 다음 단계를 수행합니다.

Visual Studio엽니다.
Tools>NuGet 패키지 관리자>패키지 관리자 콘솔이동합니다.
다음 명령을 실행하여 템플릿을 설치합니다.

dotnet new install Aspire.ProjectTemplates

Visual Studio 17.12 이상에서는 .NET Aspire 템플릿이 자동으로 설치됩니다.

이러한 템플릿을 설치하려면 dotnet new install 명령을 사용하여 Aspire.ProjectTemplates NuGet 식별자를 전달합니다.

dotnet new install Aspire.ProjectTemplates

특정 버전을 설치하려면 패키지 이름에 버전 번호를 추가합니다.

dotnet new install Aspire.ProjectTemplates::9.0.0

팁

.NET .NET Aspire 워크로드가 이미 설치된 경우 --force 플래그를 전달하여 기존 템플릿을 덮어써야 합니다. .NET .NET Aspire 워크로드를 자유롭게 제거할 수 있습니다.

.NET .NET Aspire 템플릿을 나열하십시오

.NET Aspire 템플릿은 Visual Studio 17.9 이상을 설치할 때 자동으로 설치됩니다. 사용할 수 있는 .NET.NET Aspire 템플릿을 확인하려면 Visual Studio파일>새>프로젝트 선택하고 검색 창(Alt+S)에서 "Aspire"을 검색합니다. 사용 가능한 .NET.NET Aspire 프로젝트 템플릿 목록이 표시됩니다.

C# DevKit이 설치된 상태에서, 탐색기 보기에서 폴더가 열려 있지 않을 때 사용 가능한 Visual Studio Code 템플릿을 보려면, .NET 프로젝트 만들기 버튼을 선택하세요.

그런 다음 검색 창에서 "Aspire"을 검색하여 사용 가능한 .NET Aspire 프로젝트 템플릿을 확인합니다.

.NET .NET Aspire 템플릿이 설치되어 있는지 확인하려면 dotnet 새 목록 명령을 사용하여 aspire 템플릿 이름을 전달합니다.

dotnet new list aspire

콘솔 출력은 다음과 같습니다.

dotnet new list aspire
These templates matched your input: 'aspire'

Template Name                      Short Name              Language  Tags
---------------------------------  ----------------------  --------  -------------------------------------------------------
.NET Aspire App Host               aspire-apphost          [C#]      Common/.NET Aspire/Cloud
.NET Aspire Empty App              aspire                  [C#]      Common/.NET Aspire/Cloud/Web/Web API/API/Service
.NET Aspire Service Defaults       aspire-servicedefaults  [C#]      Common/.NET Aspire/Cloud/Web/Web API/API/Service
.NET Aspire Starter App            aspire-starter          [C#]      Common/.NET Aspire/Blazor/Web/Web API/API/Service/Cloud
.NET Aspire Test Project (MSTest)  aspire-mstest           [C#]      Common/.NET Aspire/Cloud/Web/Web API/API/Service/Test
.NET Aspire Test Project (NUnit)   aspire-nunit            [C#]      Common/.NET Aspire/Cloud/Web/Web API/API/Service/Test
.NET Aspire Test Project (xUnit)   aspire-xunit            [C#]      Common/.NET Aspire/Cloud/Web/Web API/API/Service/Test

사용 가능한 템플릿

.NET Aspire 템플릿을 사용하면 .NET Aspire 솔루션 구조 및 기본 설정으로 미리 구성된 새 앱을 만들 수 있습니다. 또한 이러한 프로젝트는 앱의 다양한 리소스에서 통합된 디버깅 환경을 제공합니다.

.NET .NET Aspire 템플릿은 솔루션 템플릿과 프로젝트 템플릿의 두 가지 범주로 제공됩니다. 솔루션 템플릿은 여러 프로젝트가 있는 새 .NET Aspire 솔루션을 만들고 프로젝트 템플릿은 기존 .NET Aspire 솔루션에 추가할 수 있는 개별 프로젝트를 만듭니다.

솔루션 템플릿

다음 .NET.NET Aspire 솔루션 템플릿을 사용할 수 있습니다. 솔루션 이름이 AspireSample가정합니다.

.NET .NET Aspire 빈 앱: 다음을 포함하는 최소 .NET.NET Aspire 프로젝트입니다.
- AspireSample.AppHost: 앱의 다양한 프로젝트와 서비스를 연결하고 구성하도록 설계된 오케스트레이터 프로젝트입니다.
- AspireSample.ServiceDefaults: 복원력, 서비스 검색및 원격 분석와 관련하여 솔루션 내 여러 프로젝트에서 재사용되는 구성을 관리하는 .NET.NET Aspire 공유 프로젝트입니다.

.NET .NET Aspire Starter 앱: .AppHost 및 .ServiceDefaults 프로젝트에 더하여, .NET.NET Aspire Starter 앱에는 다음도 포함됩니다.
- AspireSample.ApiService: ASP.NET Core 최소 API 프로젝트를 사용하여 프런트 엔드에 데이터를 제공합니다. 이 프로젝트는 공유 AspireSample.ServiceDefaults 프로젝트에 의존합니다.
- AspireSample.Web: 기본 .NET.NET Aspire 서비스 구성을 사용하는 ASP.NET CoreBlazor 앱 프로젝트인 이 프로젝트는 AspireSample.ServiceDefaults 프로젝트에 따라 달라집니다.
- AspireSample.Test: MSTest, NUnit, 또는 xUnit 테스트 프로젝트와, AspireSample.AppHost에 대한 프로젝트 참조를 포함하고, 통합 테스트를 보여주는 예제 WebTests.cs 파일이 필요합니다.

프로젝트 템플릿

다음 .NET.NET Aspire 프로젝트 템플릿을 사용할 수 있습니다.

.NET .NET Aspire 앱 호스트: 독립 실행형 .AppHost 프로젝트는 앱의 다양한 프로젝트와 서비스를 오케스트레이션하고 관리하는 데 사용할 수 있습니다.

.NET .NET Aspire 테스트 프로젝트: 이러한 프로젝트 템플릿은 .NET.NET Aspire 앱에 대한 테스트 프로젝트를 만드는 데 사용되며 기능 및 통합 테스트를 나타내기 위한 것입니다. 테스트 프로젝트에는 다음 템플릿이 포함됩니다.
- MSTest: .NET.NET Aspire AppHost 프로젝트의 MSTest 통합을 포함하는 프로젝트입니다.
- NUnit: .NET.NET Aspire AppHost 프로젝트의 NUnit 통합을 포함하는 프로젝트입니다.
- xUnit: .NET.NET Aspire AppHost 프로젝트의 xUnit.net 통합이 포함된 프로젝트입니다.
테스트 템플릿에 대한 자세한 내용은 테스트의 .NET.NET Aspire를 참조하세요.

서비스 기본값: 독립 실행형 . ServiceDefaults 프로젝트는 복원력, 서비스 검색및 원격 분석관련된 솔루션의 프로젝트에서 다시 사용되는 구성을 관리하는 데 사용할 수 있습니다.

중요하다

서비스 기본 프로젝트 템플릿은 Microsoft.AspNetCore.App에 대한 FrameworkReference 종속성을 가집니다. 일부 프로젝트 형식에는 적합하지 않을 수 있습니다. 자세한 내용은 .NET.NET Aspire 서비스 기본값참조하세요.

템플릿을 사용하여 솔루션 및 프로젝트 만들기

.NET Aspire 솔루션 또는 프로젝트를 만들려면 Visual Studio, Visual Studio Code또는 .NET CLI를 사용하고 사용 가능한 템플릿을 기반으로 합니다. .NET .NET Aspire 샘플 리포지토리에서 추가 .NET.NET Aspire 템플릿을 살펴봅니다.

Visual Studio사용하여 .NET Aspire 프로젝트를 만들려면 Visual Studio 새 프로젝트 창에서 Aspire 검색하고 원하는 템플릿을 선택합니다.

안내에 따라 템플릿을 사용해 프로젝트 또는 솔루션을 구성한 후 만들기선택합니다.

Visual Studio Code사용하여 .NET Aspire 프로젝트를 만들려면 Visual Studio Code 새 프로젝트 창에서 Aspire 검색하고 원하는 템플릿을 선택합니다.

원하는 위치를 선택하고 이름을 입력한 다음 생성을 선택합니다.

.NET CLI를 사용해서 .NET Aspire 솔루션이나 프로젝트를 만들려면, dotnet new 명령을 실행하고 생성할 템플릿을 지정하세요. 다음 예제를 고려하세요.

최신 .NET 버전을 대상으로 하는 기본 .NET.NET Aspire 앱 호스트 프로젝트를 만들려면 다음을 수행합니다.

dotnet new aspire-apphost

샘플 UI 및 지원 API가 포함된 전체 솔루션인 .NET.NET Aspire 시작 앱을 만들려면 다음을 수행합니다.

dotnet new aspire-starter

팁

.NET Aspire 템플릿은 .NET CLI의 이전 버전을 사용하는 경우에도 기본적으로 최신 .NET 버전을 사용합니다. .NET 버전을 수동으로 지정하려면 --framework <tfm> 옵션을 사용합니다. 예를 들어 .NET 8을 대상으로 하는 기본 .NET.NET Aspire 앱 호스트 프로젝트를 만듭니다.

dotnet new aspire-apphost --framework net8.0

다음을 통해 공유