Windows에서 개발 환경 준비

Windows 개발 컴퓨터에서 Azure Service Fabric 애플리케이션을 빌드 및 실행하려면 Service Fabric 런타임, SDK, 도구를 설치합니다. 또한 SDK에 포함된 Windows PowerShell 스크립트의 실행을 사용하도록 설정해야 합니다.

필수 조건

지원되는 Windows 버전을 사용하고 있는지 확인합니다.

런타임 및 SDK 다운로드 및 설치

참고 항목

이전에 SDK/도구 설치에 사용되었던 웹 플랫폼 설치 관리자는 2022년 7월 1일부터 더 이상 사용되지 않습니다.

런타임은 독립적으로 설치할 수 있습니다. 단, SDK에는 런타임이 필요하므로 개발 환경의 경우 런타임과 SDK를 모두 설치해야 합니다. 다음 링크는 런타임과 SDK의 최신 버전을 다운로드할 수 있습니다.

Package(패키지) 버전
Windows용 Service Fabric 런타임 설치 10.1.1951.9590
Service Fabric SDK 설치 7.1.1951

Service Fabric 릴리스에서 이전 릴리스의 설치 관리자에 대한 직접 링크를 찾을 수 있습니다.

지원되는 버전은 Service Fabric 버전을 참조하세요.

런타임 설치

런타임 설치 프로그램은 명령줄 셸에서 실행해야 하며 /accepteula 플래그를 사용해야 합니다. 로그 출력물을 보존하려면 상승된 권한으로 명령줄 셸을 실행하는 것이 좋습니다. 다음 예에서는 PowerShell에 있습니다.

.\MicrosoftServiceFabric.<version>.exe /accepteula

SDK 설치

런타임이 설치되면 SDK를 성공적으로 설치할 수 있습니다. 명령줄 셸이나 파일 탐색기에서 설치 프로그램을 실행할 수 있습니다.

참고 항목

단일 컴퓨터 클러스터(OneBox)는 애플리케이션 또는 클러스터 업그레이드용으로 지원되지 않습니다. 클러스터 업그레이드를 수행해야 하거나 애플리케이션 업그레이드 수행 시에 문제가 발생하는 경우에는 OneBox 클러스터를 삭제한 후에 다시 만드세요.

Visual Studio 2017 또는 2019를 사용하려면

Service Fabric 도구는 Visual Studio 2019 및 2017의 Azure 개발 워크로드의 일부입니다. 이 워크로드를 Visual Studio 설치의 일부로 사용하도록 설정해야 합니다. 또한 위의 런타임 및 SDK 다운로드 및 설치에서 설명한 대로 Microsoft Azure Service Fabric SDK 및 런타임을 설치해야 합니다.

PowerShell 스크립트 실행 활성화

서비스 패브릭은 로컬 개발 클러스터를 만들고 Visual Studio에서 애플리케이션을 배포하기 위해 Windows PowerShell 스크립트를 사용합니다. 기본적으로 Windows에서는 이러한 스크립트의 실행을 차단합니다. 따라서 이러한 스크립트를 사용하려면 PowerShell 실행 정책을 수정해야 합니다. 관리자로 PowerShell을 열고 다음 명령을 입력합니다.

Set-ExecutionPolicy -ExecutionPolicy Unrestricted -Force -Scope CurrentUser

Docker 설치(선택 사항)

Service Fabric은 머신 클러스터에 마이크로 서비스를 배포하기 위한 컨테이너 오케스트레이터입니다. 로컬 개발 클러스터에서 Windows 컨테이너 애플리케이션을 실행하려면 먼저 Windows용 Docker를 설치해야 합니다. Windows용 Docker CE(안정화)를 가져옵니다. Docker를 설치하고 시작한 후 트레이 아이콘을 마우스 오른쪽 단추로 클릭하고 Windows 컨테이너로 전환을 선택합니다. 이 단계는 Windows 기반의 Docker 이미지를 실행하는 데 필요합니다.

다음 단계

개발 환경의 설정을 마쳤으므로 앱을 빌드하고 실행하기 시작할 수 있습니다.