Skip to content

Commit 779aad3

Browse files
Merge pull request #271594 from tomvcassidy/windowsInstallInstructionUpdate
updating install instructions for clarity
2 parents 07410d6 + d47b3c5 commit 779aad3

File tree

1 file changed

+17
-5
lines changed

1 file changed

+17
-5
lines changed

articles/service-fabric/service-fabric-get-started.md

Lines changed: 17 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -24,11 +24,11 @@ To build and run [Azure Service Fabric applications][1] on your Windows developm
2424

2525
Ensure you're using a supported [Windows version](service-fabric-versions.md#supported-windows-versions-and-support-end-date).
2626

27-
## Install the SDK and tools
27+
## Download and install the runtime and SDK
2828
> [!NOTE]
2929
> WebPI used previously for SDK/Tools installation was deprecated on July 1 2022
3030
31-
For latest Runtime and SDK you can download from below:
31+
The runtime can be installed independently. However, the SDK requires the runtime, so for a development environment, you must install both the runtime and SDK. The following links are download for the latest versions of both the runtime and SDK:
3232

3333
| Package |Version|
3434
| --- | --- |
@@ -39,12 +39,24 @@ You can find direct links to the installers for previous releases on [Service Fa
3939

4040
For supported versions, see [Service Fabric versions.](service-fabric-versions.md)
4141

42+
### Install the runtime
43+
44+
The runtime installer must be run from a command line shell, and you must use the `/accepteula` flag. We recommend that you run your command line shell with elevated privileges to retain the log printouts. The following example is in PowerShell:
45+
46+
```powershell
47+
.\MicrosoftServiceFabric.<version>.exe /accepteula
48+
```
49+
50+
### Install the SDK
51+
52+
Once the runtime is installed, you can install the SDK successfully. You can run the installer from the command line shell or your file explorer.
53+
4254
> [!NOTE]
4355
> Single machine clusters (OneBox) are not supported for Application or Cluster upgrades; delete the OneBox cluster and recreate it if you need to perform a Cluster upgrade, or have any issues performing an Application upgrade.
4456
4557
### To use Visual Studio 2017 or 2019
4658

47-
The Service Fabric Tools are part of the Azure Development workload in Visual Studio 2019 and 2017. Enable this workload as part of your Visual Studio installation. In addition, you need to install the Microsoft Azure Service Fabric SDK and runtime as described above [Install the SDK and tools.](#install-the-sdk-and-tools)
59+
The Service Fabric Tools are part of the Azure Development workload in Visual Studio 2019 and 2017. Enable this workload as part of your Visual Studio installation. In addition, you need to install the Microsoft Azure Service Fabric SDK and runtime as described above [Download and install the runtime and SDK.](#download-and-install-the-runtime-and-sdk)
4860

4961
## Enable PowerShell script execution
5062

@@ -56,11 +68,11 @@ Set-ExecutionPolicy -ExecutionPolicy Unrestricted -Force -Scope CurrentUser
5668

5769
## Install Docker (optional)
5870

59-
[Service Fabric is a container orchestrator](service-fabric-containers-overview.md) for deploying microservices across a cluster of machines. To run Windows container applications on your local development cluster, you must first install Docker for Windows. Get [Docker CE for Windows (stable)](https://store.docker.com/editions/community/docker-ce-desktop-windows?tab=description). After installing and starting Docker, right-click on the tray icon and select **Switch to Windows containers**. This step is required to run Docker images based on Windows.
71+
[Service Fabric is a container orchestrator](service-fabric-containers-overview.md) for deploying microservices across a cluster of machines. To run Windows container applications on your local development cluster, you must first install Docker for Windows. Get [Docker CE for Windows (stable)](https://store.docker.com/editions/community/docker-ce-desktop-windows?tab=description). After you install and start Docker, right-click on the tray icon and select **Switch to Windows containers**. This step is required to run Docker images based on Windows.
6072

6173
## Next steps
6274

63-
Now that you've finished setting up your development environment, start building and running apps.
75+
Now that you finished setting up your development environment, start building and running apps.
6476

6577
* [Learn how to create, deploy, and manage applications](service-fabric-tutorial-create-dotnet-app.md)
6678
* [Learn about the programming models: Reliable Services and Reliable Actors](service-fabric-choose-framework.md)

0 commit comments

Comments
 (0)