PageRenderTime 54ms CodeModel.GetById 27ms RepoModel.GetById 1ms app.codeStats 0ms

/articles/service-fabric/service-fabric-cluster-creation-via-visual-studio.md

https://gitlab.com/apachipa/azure-content
Markdown | 127 lines | 96 code | 31 blank | 0 comment | 0 complexity | 7dca1721d90593386fdc6b57648f3421 MD5 | raw file
    

  1. <properties
    2. 

  2.    pageTitle="Setting up a Service Fabric cluster using Visual Studio | Microsoft Azure"
    3. 

  3.    description="Describes how to set up a Service Fabric cluster by using Azure Resource Manager (ARM) template created by an Azure Resource Group project in Visual Studio"
    4. 

  4.    services="service-fabric"
    5. 

  5.    documentationCenter=".net"
    6. 

  6.    authors="karolz-ms"
    7. 

  7.    manager="adegeo"
    8. 

  8.    editor=""/>
    9. 

  9. 

  10. <tags
    11. 

  11.    ms.service="service-fabric"
    12. 

  12.    ms.devlang="dotNet"
    13. 

  13.    ms.topic="article"
    14. 

  14.    ms.tgt_pltfrm="NA"
    15. 

  15.    ms.workload="NA"
    16. 

  16.    ms.date="04/04/2016"
    17. 

  17.    ms.author="karolz@microsoft.com"/>
    18. 

  18. 

  19. # Set up a Service Fabric cluster by using Visual Studio
    20. 

  20. This article describes how to set up an Azure Service Fabric cluster by using Visual Studio and an Azure Resource Manager (ARM) template. We will use a Visual Studio Azure resource group project to create the template. After the template has been created, it can be deployed directly to Azure from Visual Studio, but it can also be used from a script or as part of continuous integration (CI) facility.
    21. 

  21. 

  22. ## Create a Service Fabric cluster template by using an Azure resource group project
    23. 

  23. To get started, open Visual Studio and create an Azure resource group project (it is available in the **Cloud** folder):
    24. 

  24. 

  25. ![New Project dialog with Azure Resource Group project selected][1]
    26. 

  26. 

  27. You can create a new Visual Studio solution for this project or add it to an existing solution.
    28. 

  28. 

  29. >[AZURE.NOTE] If you do not see the Azure resource group project under the Cloud node, you do not have the Azure SDK installed. Launch Web Platform Installer ([install it now](http://www.microsoft.com/web/downloads/platform.aspx) if you have not already), and then search for "Azure SDK for .NET" and install the version that is compatible with your version of Visual Studio.
    30. 

  30. 

  31. After you hit the OK button, Visual Studio will ask you to select the Resource Manager template you want to create:
    32. 

  32. 

  33. ![Select Azure Template dialog with Service Fabric Cluster template selected][2]
    34. 

  34. 

  35. Select the Service Fabric Cluster template and hit the OK button again. The project and the Resource Manager template have now been created.
    36. 

  36. 

  37. ## Prepare the template for deployment
    38. 

  38. Before the template is deployed to create the cluster, you must provide values for the required template parameters. These parameter values are read from the `ServiceFabricCluster.parameters.json` file, which is in the `Templates` folder of the resource group project. Open the file and provide the following values:
    39. 

  39. 

  40. |Parameter name           |Description|
    41. 

  41. |-----------------------  |--------------------------|
    42. 

  42. |certificateThumbprint    |The thumbprint of the certificate that will secure the cluster.|
    43. 

  43. |sourceVaultResourceId    |The *resource ID* of the key vault where the certificate that secures the cluster is stored.|
    44. 

  44. |certificateUrlValue      |The URL of the cluster security certificate.|
    45. 

  45. 

  46. The Visual Studio Service Fabric Resource Manager template creates a secure cluster that is protected by a certificate. This certificate is identified by the last three template parameters (`certificateThumbprint`, `sourceVaultValue`, and `certificateUrlValue`), and it must exist in an **Azure Key Vault**. For more information on how to create the cluster security certificate, see [How to secure a Service Fabric cluster using certificates](service-fabric-cluster-security.md#secure-a-service-fabric-cluster-by-using-certificates) article.
    47. 

  47. 

  48. ## Optional: change the cluster name
    49. 

  49. Every Service Fabric cluster has a name. When a Fabric cluster is created in Azure, cluster name determines (together with the Azure region) the Domain Name System (DNS) name for the cluster. For example, if you name your cluster `myBigCluster`, and the `clusterLocation` parameter is set to East US, the DNS name of the cluster will be `myBigCluster.eastus.cloudapp.azure.com`.
    50. 

  50. 

  51. By default the cluster name is generated automatically and made unique by attaching a random suffix to a "cluster" prefix. This makes it very easy to use the template as part of a **continuous integration** (CI) system. If you want to use a specific name for your cluster, one that is meaningful to you, set the value of the `clusterName` variable in the Resource Manager template file (`ServiceFabricCluster.json`) to your chosen name. It is the first variable defined in that file.
    52. 

  52. 

  53. ## Optional: add public application ports
    54. 

  54. You may also want to change the public application ports for the cluster before you deploy it. By default, the template opens up just two public TCP ports (80 and 8081). If you need more for your applications, modify the Azure Load Balancer definition in the template. The definition is stored in the main template file (`ServiceFabricCluster.json`). Open that file and search for `loadBalancedAppPort`. You will notice that each port is associated with three artifacts:
    55. 

  55. 

  56. 1. A template variable that defines the TCP port value for the port:
    57. 

  57. 

  58. 	```json
    59. 

  59. 	"loadBalancedAppPort1": "80"
    60. 

  60. 	```
    61. 

  61. 

  62. 2. A *probe* that defines how frequently and for how long the Azure load balancer will attempt to use a specific Service Fabric node before failing over to another one. The probes are part of the Load Balancer resource. Here is the probe definition for the first default application port:
    63. 

  63. 

  64. 	```json
    65. 

  65. 	{
    66. 

  66.         "name": "AppPortProbe1",
    67. 

  67.         "properties": {
    68. 

  68.             "intervalInSeconds": 5,
    69. 

  69.             "numberOfProbes": 2,
    70. 

  70.             "port": "[variables('loadBalancedAppPort1')]",
    71. 

  71.             "protocol": "Tcp"
    72. 

  72.         }
    73. 

  73.     }
    74. 

  74. 	```
    75. 

  75. 

  76. 3. A *load-balancing rule* that ties together the port and the probe, which enables load balancing across a set of Service Fabric cluster nodes:
    77. 

  77. 

  78.     ```json
    79. 

  79. 	{
    80. 

  80. 	    "name": "AppPortLBRule1",
    81. 

  81. 	    "properties": {
    82. 

  82. 	        "backendAddressPool": {
    83. 

  83. 	            "id": "[variables('lbPoolID0')]"
    84. 

  84. 	        },
    85. 

  85. 	        "backendPort": "[variables('loadBalancedAppPort1')]",
    86. 

  86. 	        "enableFloatingIP": false,
    87. 

  87. 	        "frontendIPConfiguration": {
    88. 

  88. 	            "id": "[variables('lbIPConfig0')]"
    89. 

  89. 	        },
    90. 

  90. 	        "frontendPort": "[variables('loadBalancedAppPort1')]",
    91. 

  91. 	        "idleTimeoutInMinutes": 5,
    92. 

  92. 	        "probe": {
    93. 

  93. 	            "id": "[concat(variables('lbID0'),'/probes/AppPortProbe1')]"
    94. 

  94. 	        },
    95. 

  95. 	        "protocol": "Tcp"
    96. 

  96. 	    }
    97. 

  97. 	}
    98. 

  98.     ```
    99. 

  99. If the applications that you plan to deploy to the cluster need more ports, you can add them by creating additional probe and load-balancing rule definitions. For more information on how to work with Azure Load Balancer through Resource Manager templates, see [Get started creating an internal load balancer using a template](../load-balancer/load-balancer-get-started-ilb-arm-template.md).
    100. 

  100. 

  101. ## Deploy the template by using Visual Studio
    102. 

  102. After you have saved all the required parameter values in the`ServiceFabricCluster.param.dev.json` file, you are ready to deploy the template and create your Service Fabric cluster. Right-click the resource group project in Visual Studio Solution Explorer and choose **Deploy**. Visual Studio will show the **Deploy to Resource Group** dialog box, asking you to authenticate to Azure, if necessary:
    103. 

  103. 

  104. ![Deploy to Resource Group dialog][3]
    105. 

  105. 

  106. The dialog box lets you choose an existing Resource Manager resource group for the cluster and gives you the option to create a new one. It normally makes sense to use a separate resource group for a Service Fabric cluster.
    107. 

  107. 

  108. After you hit the Deploy button, Visual Studio will prompt you to confirm the template parameter values. Hit the **Save** button. One parameter does not have a persisted value: the administrative account password for the cluster. You will need to provide a password value when Visual Studio prompts you for one.
    109. 

  109. 

  110. >[AZURE.NOTE] If PowerShell was never used to administer Azure from the machine that you are using now, you will need to do a little housekeeping.
    111. 

  111. >1. Enable PowerShell scripting by running the [`Set-ExecutionPolicy`](https://technet.microsoft.com/library/hh849812.aspx) command. For development machines, "unrestricted" policy is usually acceptable.
    112. 

  112. >2. Decide whether to allow diagnostic data collection from Azure PowerShell commands, and run [`Enable-AzureRmDataCollection`](https://msdn.microsoft.com/library/mt619303.aspx) or [`Disable-AzureRmDataCollection`](https://msdn.microsoft.com/library/mt619236.aspx) as necessary. This will avoid unnecessary prompts during template deployment.
    113. 

  113. 

  114. You can monitor the progress of the deployment process in the Visual Studio output window. Once the template deployment is completed, your new cluster is ready to use!
    115. 

  115. 

  116. If there are any errors, go to the [Azure portal](https://portal.azure.com/) and open the resource group that you deployed to. Click **All settings**, then click **Deployments** on the settings blade. A failed resource-group deployment will leave detailed diagnostic information there.
    117. 

  117. 

  118. >[AZURE.NOTE] Service Fabric clusters require a certain number of nodes to be up at all times in order to maintain availability and preserve state - referred to as "maintaining quorum". Consequently, it is typically not safe to shut down all of the machines in the cluster unless you have first performed a [full backup of your state](service-fabric-reliable-services-backup-restore.md).
    119. 

  119. 

  120. ## Next steps
    121. 

  121. - [Learn about setting up Service Fabric cluster using the Azure portal](service-fabric-cluster-creation-via-portal.md)
    122. 

  122. - [Learn how to manage and deploy Service Fabric applications using Visual Studio](service-fabric-manage-application-in-visual-studio.md)
    123. 

  123. 

  124. <!--Image references-->
    125. 

  125. [1]: ./media/service-fabric-cluster-creation-via-visual-studio/azure-resource-group-project-creation.png
    126. 

  126. [2]: ./media/service-fabric-cluster-creation-via-visual-studio/selecting-azure-template.png
    127. 

  127. [3]: ./media/service-fabric-cluster-creation-via-visual-studio/deploy-to-azure.png
    128. 

  128.