.NET .NET Aspire 설정 및 도구
.NET .NET Aspire 클라우드 네이티브 앱을 만들고 구성하는 데 도움이 되는 도구를 포함합니다. 이 도구에는 .NET Aspire, Visual Studio및 CLI 워크플로에 대한 Visual Studio Code 시작하기를 간소화하는 유용한 시작 프로젝트 템플릿 및 기타 기능이 포함되어 있습니다. 앞의 섹션에서는 .NET.NET Aspire 도구를 사용하는 방법을 알아보고 다음 작업을 살펴봅니다.
- .NET .NET Aspire 및 해당 종속성 설치
- Visual Studio, Visual Studio Code또는 .NET CLI를 사용하여 시작 프로젝트 템플릿 만들기
- .NET .NET Aspire 통합 설치
- .NET .NET Aspire 대시보드와 작업하기
설치 .NET.NET Aspire
.NET .NET Aspire작업하려면 다음을 로컬에 설치해야 합니다.
- .NET 8.0 또는 .NET 9.0.
- OCI 규격 컨테이너 런타임(예:
- Docker 데스크톱 또는 Podman. 자세한 내용은 컨테이너 런타임을 확인하세요.
- IDE(통합 개발자 환경) 또는 코드 편집기(예:
- Visual Studio 2022 버전 17.9 이상(선택 사항)
-
Visual Studio Code(선택 사항)
- C# Dev Kit: 확장(선택 사항)
- JetBrains Rider와 .NET.NET Aspire 플러그인 (선택 사항)
Visual Studio 2022 17.9 이상에는 Web & Cloud 워크로드를 설치할 때, 기본적으로 최신 .NET.NET Aspire SDK가 포함됩니다. 이전 버전의 Visual Studio 2022가 있는 경우 Visual Studio 2022 17.9로 업그레이드하거나 다음 단계를 사용하여 .NET Aspire SDK를 설치할 수 있습니다.
.NET Aspire 워크로드를 Visual Studio 2022년에 설치하려면 Visual Studio 설치 관리자를 사용하십시오.
Visual Studio 설치 관리자를 엽니다.
2022년 옆에 있는 Visual Studio 수정을 선택합니다.
ASP.NET 및 웹 개발 워크로드를 선택합니다.
설치 세부 정보 패널에서 SDK선택합니다. 수정을 선택하여 .NET.NET Aspire 통합을 설치합니다.
컨테이너 런타임
.NET
.NET Aspire 프로젝트는 컨테이너에서 실행되도록 설계되었습니다.
Docker Desktop 또는 Podman 컨테이너 런타임으로 사용할 수 있습니다.
Docker Desktop 가장 일반적인 컨테이너 런타임입니다.
Podman OCI(Open Container Initiative) 컨테이너를 빌드하고 실행할 수 있는 Docker대한 오픈 소스 디먼리스 대안입니다. 호스트 환경에 Docker 및 Podman 모두 설치되어 있는 경우 .NET Aspire 기본적으로 Docker사용합니다.
.NET Aspire 환경 변수를 Podman설정하여 DOTNET_ASPIRE_CONTAINER_RUNTIME 대신 podman 사용하도록 지시할 수 있습니다.
export DOTNET_ASPIRE_CONTAINER_RUNTIME=podman
자세한 내용은 설치 Podman에 대해 Linux을 참조하세요.
.NET .NET Aspire 템플릿
.NET
.NET Aspire 솔루션 및 프로젝트 템플릿 집합을 제공합니다. 이러한 템플릿은 개발자가 선호하는 .NET 통합 환경에서 사용할 수 있습니다. 이러한 템플릿을 사용하여 전체 .NET Aspire 솔루션을 만들거나 기존 .NET Aspire 솔루션에 개별 프로젝트를 추가할 수 있습니다. 자세한 내용은 템플릿
.NET .NET Aspire 대시보드
.NET 프로젝트를 노출하는 .NET Aspire 템플릿에는 로그, 추적 및 환경 구성과 같은 앱의 다양한 측면을 모니터링하고 검사하는 데 사용되는 유용한 개발자 대시보드 포함되어 있습니다. 이 대시보드는 로컬 개발 환경을 개선하도록 설계되었으며 앱의 전체 상태 및 구조에 대한 개요를 제공합니다.
.NET
.NET Aspire 대시보드는 앱이 실행 중일 때만 표시되며, *.AppHost 프로젝트를 시작할 때 자동으로 시작됩니다.
Visual Studio 및 Visual Studio Code 브라우저에서 자동으로 앱과 .NET Aspire 대시보드를 모두 시작합니다.
왼쪽 탐색은 대시보드의 여러 부분에 대한 링크를 제공하며, 각 부분은 다음 섹션에서 탐색합니다.
.NET .NET Aspire 대시보드는 독립 실행형 모드에서도 사용할 수 있습니다. 자세한 내용은 독립 실행형 .NET.NET Aspire 대시보드을 참조하세요.
Visual Studio 도구
Visual Studio .NET Aspire 통합 및 App Host 오케스트레이터 프로젝트 작업을 위한 추가 기능을 제공합니다. 이러한 기능을 모두 현재 Visual Studio Code 또는 CLI를 통해 사용할 수 있는 것은 아닙니다.
통합 패키지 추가
.NET Aspire를 사용하여 다른 NuGet 패키지와 마찬가지로 앱에 Visual Studio 통합을 추가합니다. 그러나 Visual Studio은(는) 직접 .NET Aspire 통합을 추가할 수 있는 UI 옵션을 제공합니다.
Visual Studio에서 .NET Aspire 통합을 추가할 프로젝트를 우클릭하고 >.NET.NET Aspire 패키지 추가...을 선택합니다.
패키지 관리자는 .NET.NET Aspire 통합에 대해 미리 구성된 검색 결과(필터 조건 채우기)를 사용하여 열리며, 원하는 통합을 쉽게 찾아서 선택할 수 있습니다.
호스팅 패키지 추가
.NET .NET Aspire 호스팅 패키지는 앱이 종속되거나 사용할 수 있는 다양한 리소스 및 종속성을 구성하는 데 사용됩니다. 호스팅 패키지는 *.AppHost 프로젝트에 추가된다는 점에서 다른 통합 패키지와 차별화됩니다. 앱에 호스팅 패키지를 추가하려면 다음 단계를 수행합니다.
Visual Studio에서 *를 오른쪽 클릭한 다음, AppHost 프로젝트를 선택하고 >.NET.NET Aspire 패키지를 추가...합니다.
패키지 관리자는 .NET.NET Aspire 호스팅 패키지에 대해 미리 구성된 검색 결과(필터 조건 채우기)를 사용하여 열리며, 원하는 패키지를 쉽게 찾아서 선택할 수 있습니다.
오케스트레이션 프로젝트 추가
다음 단계를 사용하여 기존 앱에 .NET.NET Aspire 오케스트레이션 프로젝트를 추가할 수 있습니다.
Visual Studio에서 기존 프로젝트를 마우스 오른쪽 버튼으로 클릭한 후, >.NET.NET Aspire Orchestrator 지원 추가를 선택합니다..
솔루션에 추가된 *.AppHost 및 *.ServiceDefaults 프로젝트의 요약이 포함된 대화 상자 창이 열립니다.
확인 선택하면 다음과 같은 변경 내용이 적용됩니다.
- *.AppHost 및 *.ServiceDefaults 오케스트레이션 프로젝트가 솔루션에 추가됩니다.
-
builder.AddServiceDefaults에 대한 호출이 원래 프로젝트의 Program.cs 파일에 추가됩니다. - 귀하의 원래 프로젝트에 대한 참조가 프로젝트의 Program.cs 파일에 추가됩니다. *.AppHost 프로젝트입니다.
.NET .NET Aspire 오케스트레이션에 대한 자세한 내용은 .NET.NET Aspire 오케스트레이션 개요참조하세요.
오케스트레이션에 참여
새 프로젝트 워크플로의 일환으로 Visual Studio에서 Aspire 오케스트레이션을 등록할 수 있는 옵션을 제공합니다. Visual Studio *를 만들도록 하려면 이 옵션을 선택합니다. AppHost 및 *. ServiceDefaults는 선택한 프로젝트 템플릿과 함께 프로젝트를.
테스트 프로젝트 만들기
Visual Studio사용하고 .NET.NET Aspire 애플리케이션 시작 템플릿을 선택하면 테스트 프로젝트를 포함할 수 있습니다. 이 테스트 프로젝트는 테스트의 시작점으로 사용할 수 있는 샘플 테스트를 포함하는 xUnit 프로젝트입니다.
자세한 내용은 첫 번째 .NET.NET Aspire 테스트작성을 참조하세요.
Visual Studio Code 도구
Visual Studio Code을 C# Dev Kit의 확장과 함께 사용하여 .NET.NET Aspire 프로젝트를 만들고 개발할 수 있습니다. .NET Aspire새 Visual Studio Code 프로젝트를 만들려면 .NET 보기에서 프로젝트 만들기 단추를 선택한 다음, .NET.NET Aspire 템플릿 중 하나를 선택합니다.
새 .NET Aspire 프로젝트를 만들면, 앱을 실행하고 디버그하면서 중단점을 단계별로 이동하며, Visual Studio Code 디버거를 사용하여 변수를 검사합니다.
참고 항목
- .NET .NET Aspire 워크로드 설치할 수 없습니다.
- 개발 프록시를 .NET.NET Aspire 프로젝트와 함께 사용하십시오.
.NET Aspire