Windows에서 개발 환경 준비Prepare your development environment on Windows

Windows 개발 컴퓨터에서 Azure Service Fabric 애플리케이션을 빌드 및 실행하려면 Service Fabric 런타임, SDK, 도구를 설치합니다.To build and run Azure Service Fabric applications on your Windows development machine, install the Service Fabric runtime, SDK, and tools. 또한 SDK에 포함된 Windows PowerShell 스크립트의 실행을 사용하도록 설정해야 합니다.You also need to enable execution of the Windows PowerShell scripts included in the SDK.

필수 조건Prerequisites

지원되는 운영 체제 버전Supported operating system versions

개발을 위해 다음 운영 체제 버전이 지원됩니다.The following operating system versions are supported for development:

  • Windows 7Windows 7
  • Windows 8/Windows 8.1Windows 8/Windows 8.1
  • Windows Server 2012 R2Windows Server 2012 R2
  • Windows Server 2016Windows Server 2016
  • 윈도우 10Windows 10

참고

Windows 7 지원:

  • Windows 7은 기본적으로 Windows PowerShell 2.0만을 포함합니다. 서비스 패브릭 PowerShell cmdlet에는 PowerShell 3.0 이상이 필요합니다. Microsoft 다운로드 센터에서 Windows PowerShell 5.0을 다운로드할 수 있습니다.
  • Service Fabric 역방향 프록시는 Windows 7에서 사용할 수 없습니다.

SDK 및 도구 설치Install the SDK and tools

SDK와 도구를 설치하려면 WebPI(웹 플랫폼 설치 관리자)를 사용하는 것이 좋습니다.Web Platform Installer (WebPI) is the recommended way to install the SDK and tools. WebPI 사용 시에 런타임 오류가 발생하는 경우 특정 Service Fabric 릴리스의 릴리스 정보에서 설치 관리자의 직접 링크를 확인할 수도 있습니다.If you receive runtime errors using WebPI, you can also find direct links to the installers in the release notes for a specific Service Fabric release. Service Fabric 팀 블로그의 여러 릴리스 공지에서 릴리스 정보를 확인할 수 있습니다.The release notes can be found in the various release announcements on the Service Fabric team blog.

참고

로컬 Service Fabric 개발 클러스터 업그레이드는 지원되지 않습니다.

Visual Studio 2017을 사용하려면 다음을 수행합니다.To use Visual Studio 2017

Service Fabric 도구는 Visual Studio 2017의 Azure 개발 워크로드의 일부입니다.The Service Fabric Tools are part of the Azure Development workload in Visual Studio 2017. 이 워크로드를 Visual Studio 설치의 일부로 사용하도록 설정해야 합니다.Enable this workload as part of your Visual Studio installation. 또한 웹 플랫폼 설치 관리자를 사용하여 Microsoft Azure Service Fabric SDK 및 런타임을 설치해야 합니다.In addition, you need to install the Microsoft Azure Service Fabric SDK and runtime using Web Platform Installer.

Visual Studio 2015 사용(Visual Studio 2015 업데이트 2 이상 필요)To use Visual Studio 2015 (requires Visual Studio 2015 Update 2 or later)

Visual Studio 2015의 경우 Service Fabric 도구는 웹 플랫폼 설치 관리자를 사용하여 SDK 및 런타임과 함께 설치됩니다.For Visual Studio 2015, the Service Fabric tools are installed together with the SDK and runtime using the Web Platform Installer:

SDK 설치만SDK installation only

SDK만 필요한 경우 다음 패키지를 설치할 수 있습니다.If you only need the SDK, you can install this package:

현재 버전은 다음과 같습니다.The current versions are:

  • Service Fabric SDK 및 도구 3.3.654Service Fabric SDK and Tools 3.3.654
  • Service Fabric 런타임 6.4.654Service Fabric runtime 6.4.654
  • Visual Studio 2015 2.4.11116.1용 Service Fabric 도구Service Fabric Tools for Visual Studio 2015 2.4.11116.1
  • Visual Studio 2017 15.9에는 Visual Studio 2.4.11024.1용 Service Fabric 도구가 포함되어 있습니다.Visual Studio 2017 15.9 includes Service Fabric Tools for Visual Studio 2.4.11024.1

지원되는 버전 목록은 Service Fabric 버전을 참조하세요.For a list of supported versions, see Service Fabric versions

참고

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

PowerShell 스크립트 실행 활성화Enable PowerShell script execution

서비스 패브릭은 로컬 개발 클러스터를 만들고 Visual Studio에서 애플리케이션을 배포하기 위해 Windows PowerShell 스크립트를 사용합니다.Service Fabric uses Windows PowerShell scripts for creating a local development cluster and for deploying applications from Visual Studio. 기본적으로 Windows에서는 이러한 스크립트의 실행을 차단합니다.By default, Windows blocks these scripts from running. 따라서 이러한 스크립트를 사용하려면 PowerShell 실행 정책을 수정해야 합니다.To enable them, you must modify your PowerShell execution policy. 관리자로 PowerShell을 열고 다음 명령을 입력합니다.Open PowerShell as an administrator and enter the following command:

Set-ExecutionPolicy -ExecutionPolicy Unrestricted -Force -Scope CurrentUser

Docker 설치(선택 사항)Install Docker (optional)

Service Fabric은 머신 클러스터에 마이크로 서비스를 배포하기 위한 컨테이너 오케스트레이터입니다.Service Fabric is a container orchestrator for deploying microservices across a cluster of machines. 로컬 개발 클러스터에서 Windows 컨테이너 애플리케이션을 실행하려면 먼저 Windows용 Docker를 설치해야 합니다.To run Windows container applications on your local development cluster, you must first install Docker for Windows. Windows용 Docker CE(안정화)를 가져옵니다.Get Docker CE for Windows (stable). Docker를 설치하고 시작한 후에 트레이 아이콘을 마우스 오른쪽 단추로 클릭하고 Windows 컨테이너로 전환을 선택합니다.After installing and starting Docker, right-click on the tray icon and select Switch to Windows containers. 이 단계는 Windows 기반의 Docker 이미지를 실행하는 데 필요합니다.This step is required to run Docker images based on Windows.

다음 단계Next steps

개발 환경의 설정을 마쳤으므로 앱을 빌드하고 실행하기 시작할 수 있습니다.Now that you've finished setting up your development environment, start building and running apps.