From 20d196212c59ab31b3cd04710a488c86b53afe26 Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Wed, 6 Jun 2018 16:24:54 -0700 Subject: [PATCH] update to latest copy from release-service-fabric-seabreeze --- ...ic-mesh-setup-developer-environment-sdk.md | 48 ++++++++----------- ...-fabric-mesh-tutorial-create-dotnetcore.md | 19 ++++---- 2 files changed, 29 insertions(+), 38 deletions(-) diff --git a/docs/conceptual-docs/service-fabric-mesh-setup-developer-environment-sdk.md b/docs/conceptual-docs/service-fabric-mesh-setup-developer-environment-sdk.md index a243624..478bb32 100644 --- a/docs/conceptual-docs/service-fabric-mesh-setup-developer-environment-sdk.md +++ b/docs/conceptual-docs/service-fabric-mesh-setup-developer-environment-sdk.md @@ -1,42 +1,37 @@ --- -title: Setup new Windows environment for Service Fabric Mesh on Azure -description: Details all of the prerequisites required to create a Service Fabric Application to deploy to Azure Service Fabric Mesh. +title: Setup your development environment to build Service Fabric Mesh applications +description: Details all of the prerequisites required to create a Service Fabric Application that can be deployed to Azure Service Fabric Mesh. services: Azure Service Fabric Mesh keywords: author: TylerMSFT ms.author: twhitney -ms.date: 05/24/2018 +ms.date: 06/5/2018 ms.topic: get-started-article ms.service: service-fabric-mesh manager: timlt #Customer intent: As a developer, I need to prepare install the prerequisites to enable service fabric mesh development in visual studio. --- -# Setup your Windows environment for Service Fabric Mesh +# Setup your development environment to build Service Fabric Mesh applications -To build and run Azure Service Fabric applications on your Windows development machine, install the Service Fabric runtime, SDK, and tools. You also need to enable use of the Windows PowerShell scripts. +To build and run Azure Service Fabric applications on your Windows development machine, install the Service Fabric runtime, SDK, and tools. [!INCLUDE [preview note](./includes/include-preview-note.md)] +**You will be installing a preview version of the Service Fabric runtime, version 6.3. This means that you should not do production development, nor attempt to deploy to a production Service Fabric cluster, unless you revert to a supported runtime.** + ## Supported operating system versions + The following operating system versions are supported for development: * Windows 10 (Enterprise, Professional, or Education) * Windows Server 2016 -## 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: - -```powershell -Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Force -Scope CurrentUser -``` - ## Enable Hyper-V Hyper-V must be enabled for you to create Service Fabric applications. -#### Windows 10 +### Windows 10 Open PowerShell as an administrator and run the following command: @@ -46,7 +41,7 @@ Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V -All Restart your computer. For more information about how to enable Hyper-V, see [Install Hyper-V on Windows 10](https://docs.microsoft.com/virtualization/hyper-v-on-windows/quick-start/enable-hyper-v). -#### Windows Server 2016 +### Windows Server 2016 Open PowerShell as an administrator and run the following command: @@ -56,29 +51,26 @@ Install-WindowsFeature -Name Hyper-V -IncludeManagementTools Restart your computer. For more information about how to enable Hyper-V, see [Install the Hyper-V role on Windows Server 2016](https://docs.microsoft.com/windows-server/virtualization/hyper-v/get-started/install-the-hyper-v-role-on-windows-server). - - - ## Visual Studio -Deploying Service Fabric Applications to Service Fabric Mesh requires Visual Studio 2017. [Install version 15.6.0][download-visual-studio] or greater and enable the following workloads: +Visual Studio 2017 is required to deploy Service Fabric Applications. [Install version 15.6.0][download-visual-studio] or greater and enable the following workloads: -- ASP.NET and Web Development +- ASP.NET and web development - Azure Development ## Docker -You'll need to install Docker to support the containerized Service Fabric applications used by Service Fabric Mesh. +Install Docker to support the containerized Service Fabric applications used by Service Fabric Mesh. -#### Windows 10 +### Windows 10 Download and install the latest version of [Docker Community Edition for Windows][download-docker]. -During the installation, select **Use Windows containers instead of Linux containers** when asked. You'll be required to log off and log back in. After logging back in, if you did not previously enable Hyper-V, you may be prompted to enable Hyper-V. You must enable Hyper-V and then restart your computer. +During the installation, select **Use Windows containers instead of Linux containers** when asked. You'll need to then log off and log back in. After logging back in, if you did not previously enable Hyper-V, you may be prompted to enable Hyper-V. You must enable Hyper-V and then restart your computer. After your computer has restarted, Docker will prompt you to enable the **Containers** feature, enable it and restart your computer. -#### Windows Server 2016 +### Windows Server 2016 Use the following PowerShell commands to install Docker. For more information, see [Docker Enterprise Edition for Windows Server][download-docker-server]. @@ -94,24 +86,24 @@ Restart your computer. Install the Service Fabric runtime, SDK, and tools. -1. Install the [Service Fabric Runtime][download-runtime] with the **/AcceptEULA** flag on the command line. +1. Download the [Service Fabric Runtime][download-runtime]. Then run it with the **/AcceptEULA** flag from the command line, e.g. c:\users\\downloads\MicrosoftServiceFabric.6.3.116.9494.exe /AcceptEULA 2. Install the [Service Fabric SDK][download-sdk]. 3. Install the [Service Fabric Mesh SDK][download-sdkmesh]. 4. Install the [Visual Studio Service Fabric Tools (preview)][download-tools]. ## Build a cluster -To create and run Service Fabric applications, you must have a single-node local development cluster. This cluster must be running whenever you use Visual Studio with a Service Fabric Mesh project. +For the best debugging performance when you create and run Service Fabric applications, we recommend creating a single-node local development cluster. This cluster must be running whenever you deploy or debug a Service Fabric Mesh project. Docker **must** be running before you can build a cluster. Test that Docker is running by opening a terminal window and running `docker ps` to see if an error occurs. If the response does not indicate an error, Docker is running and you're ready to build a cluster. -After you install the SDK and Visual Studio tools, create a development cluster. Open a **new**, **elevated**, PowerShell window and run the following PowerShell commands: +After you install the runtime, SDKs and Visual Studio tools, create a development cluster. Open a **new**, **elevated**, PowerShell window and run the following PowerShell commands: ```powershell . "C:\Program Files\Microsoft SDKs\Service Fabric\ClusterSetup\DevClusterSetup.ps1" -CreateOneNodeCluster -UseMachineName ``` -You're now ready to create Service Fabric Mesh services! +You're now ready to create Service Fabric Mesh applications! ## Next steps diff --git a/docs/conceptual-docs/service-fabric-mesh-tutorial-create-dotnetcore.md b/docs/conceptual-docs/service-fabric-mesh-tutorial-create-dotnetcore.md index fad35c8..f0bd1c3 100644 --- a/docs/conceptual-docs/service-fabric-mesh-tutorial-create-dotnetcore.md +++ b/docs/conceptual-docs/service-fabric-mesh-tutorial-create-dotnetcore.md @@ -13,7 +13,7 @@ ms.devlang: dotNet ms.topic: tutorial ms.tgt_pltfrm: NA ms.workload: NA -ms.date: 05/15/2018 +ms.date: 06/5/2018 ms.author: twhitney ms.custom: mvc, devcenter #Customer intent: As a developer, I want to use visual studio to locally run a .net core application on Service Fabric Mesh so that I can see it run and then I will deploy it to Azure. @@ -21,7 +21,7 @@ ms.custom: mvc, devcenter # Tutorial: Create an ASP.NET Core website for Service Fabric Mesh -In this tutorial you will create a new Service Fabric Mesh project, add an ASP.NET Core website to it, and run it locally in the Service Fabric cluster. After that, you will deploy the project to Azure. +In this tutorial you will create a new Service Fabric Mesh application which is made up of an ASP.NET Core website, and run it in the local development cluster. After that, you will publish the project to Azure. In this tutorial you learn how to: > [!div class="checklist"] @@ -57,26 +57,25 @@ You must set the **Service Name** to something unique. Why? Because the name of Press **OK** to create the ASP.NET Core project. - ![Visual studio new Service Fabric Mesh project dialog](media/service-fabric-mesh-tutorial-deploy-dotnetcore/visual-studio-new-service-fabric-service.png) A new dialog is displayed, **New ASP.NET Core Web Application** dialog. Select **Web Application** and then press **OK**. ![Visual studio new ASP.NET core application](media/service-fabric-mesh-tutorial-deploy-dotnetcore/visual-studio-new-aspnetcore-app.png) -Visual Studio will create both the Service Fabric Application project and the ASP.NET Core project. The combination of these two projects represent your service. +Visual Studio will create both the Service Fabric Application project and the ASP.NET Core project. ## Build and deploy A Docker image will automatically be built and deployed to your local cluster as soon as your project loads. This process may take some time and you can monitor the progress of the Service Fabric tools in the **Output** pane if you want. Select the **Service Fabric Tools** item in the pane. You are not prevented from running your project. -After the project has been created, press **F5** to compile and run your service locally. This may take some time if your project has never been run before. Whenever the project is run and debugged locally, Visual Studio will: +After the project has been created, press **F5** to compile and run your service locally. Whenever the project is run and debugged locally, Visual Studio will: 1. Make sure that Docker for Windows is running and set to use Windows as the container operating system. -2. Downloads any missing Docker base images. This part may take some time -3. Builds (or rebuilds) the Docker image used to host your code project. +2. Download any missing Docker base images. This part may take some time +3. Build (or rebuild) the Docker image used to host your code project. 4. Deploys and runs the container on the local Service Fabric development cluster. -6. Runs your services and hits any breakpoints you have set. +6. Run your services and hits any breakpoints you have set. After the local deployment is finished, and Visual Studio is running your projects, a browser window will open and automatically navigate to the sample webpage. @@ -104,7 +103,7 @@ Back in the **Publish Service Fabric Application** dialog, under **Azure Contain In the publish dialog, press the **Publish** button to deploy your Service Fabric application to Azure. -When you publish to Azure for the first time, it can take up to 10 or more minutes. Subsequent publishes of the same project generally take around five minutes. Obviously, these estimates will vary based on your internet connection speed and other factors. You can monitor the progress of the deployment by selecting the **Service Fabric Tools** item in the Visual Studio **Output** pane. Once the deployment has finished, the **Service Fabric Tools** output will display the IP address and port of your application in the form of a URL. +When you publish to Azure for the first time, it can take up to 10 or more minutes. Subsequent publishes of the same project generally take around five minutes. Obviously, these estimates will vary based on your internet connection speed and other factors. You can monitor the progress of the deployment by selecting the **Service Fabric Tools** pane in the Visual Studio **Output** window. Once the deployment has finished, the **Service Fabric Tools** output will display the IP address and port of your application in the form of a URL. ```json Packaging Application... @@ -133,4 +132,4 @@ Alternatively, you can delete the resource group [from the portal](../azure-reso ## Next steps -Explore the [samples](https://github.com/Azure/seabreeze-preview-pr/tree/master/samples) for Service Fabric Mesh. \ No newline at end of file +Explore the [Voting app sample](https://github.com/MikkelHegn/service-fabric-mesh-preview-pr/tree/private-preview_3/samples/src/quickstart/windows/VotingApp) to see an example of service-to-service communication. \ No newline at end of file