Prepare your development environment
To build and run Azure Service Fabric applications on your development machine, install the runtime, SDK, and tools. You also need to enable execution of the Windows PowerShell scripts included in the SDK.
Supported operating system versions
The following operating system versions are supported for development:
- Windows 7
- Windows 8/Windows 8.1
- Windows Server 2012 R2
- Windows Server 2016
- Windows 10
Windows 7 only includes Windows PowerShell 2.0 by default. Service Fabric PowerShell cmdlets requires PowerShell 3.0 or higher. You can download Windows PowerShell 5.0 from the Microsoft Download Center.
Install the SDK and tools
To use Visual Studio 2017 RC
Service Fabric Tools are part of the Azure Development and Management workload in Visual Studio 2017 RC. Enable this workload as part of your Visual Studio installation. In addition, you need to install the Microsoft Azure Service Fabric SDK, using Web Platform Installer.
To use Visual Studio 2015 (requires Visual Studio 2015 Update 2 or later)
For Visual Studio 2015, Service Fabric tools are installed together with the SDK, using the Web Platform Installer:
SDK installation only
If you only need the SDK, you can install this package:
Customers have reported errors during installation when using these launch links, or when these links were used in Chrome browser. These errors are known issues in Web Platform Installer which are being addressed. Try the following workarounds:
- Launch the preceding links in Internet Explorer or Edge browsers, or
- Launch Web Platform Installer from the Start menu, search for "Service Fabric", and install the SDK
We apologize for the inconvenience.
The current versions are:
- Service Fabric SDK 2.4.164
- Service Fabric runtime 5.4.164
- Visual Studio 2015 tools 1.4.50124
For a list of supported versions, see Service Fabric support
Enable PowerShell script execution
Service Fabric uses Windows PowerShell scripts for creating a local development cluster and for deploying applications from Visual Studio. By default, Windows blocks these scripts from running. To enable them, you must modify your PowerShell execution policy. Open PowerShell as an administrator and enter the following command:
Set-ExecutionPolicy -ExecutionPolicy Unrestricted -Force -Scope CurrentUser
Now that you've finished setting up your development environment, start building and running apps.
- Create your first Service Fabric application in Visual Studio
- Learn how to deploy and manage applications on your local cluster
- Learn about the programming models: Reliable Services and Reliable Actors
- Check out the Service Fabric code samples on GitHub
- Visualize your cluster by using Service Fabric Explorer
- Follow the Service Fabric learning path to get a broad introduction to the platform
- Learn about Service Fabric support options