Upgrade the configuration of a cluster in Azure

This article describes how to customize the various fabric settings for your Service Fabric cluster. For clusters hosted in Azure, you can customize settings through the Azure portal or by using an Azure Resource Manager template.

Note

Not all settings are available in the portal, and it is a best practice to customize it using an Azure Resource Manager template; Portal is for Service Fabric Dev\Test scenario's only.

Note

We recommend that you use the Azure Az PowerShell module to interact with Azure. See Install Azure PowerShell to get started. To learn how to migrate to the Az PowerShell module, see Migrate Azure PowerShell from AzureRM to Az.

Customize cluster settings using Resource Manager templates

Azure clusters can be configured through the JSON Resource Manager template. To learn more about the different settings, see Configuration settings for clusters. As an example, the steps below show how to add a new setting MaxDiskQuotaInMB to the Diagnostics section using Azure Resource Explorer.

1. Go to https://resources.azure.com
2. Navigate to your subscription by expanding subscriptions -> <Your Subscription> -> resourceGroups -> <Your Resource Group> -> providers -> Microsoft.ServiceFabric -> clusters -> <Your Cluster Name>
3. In the top right corner, select Read/Write.
4. Select Edit and update the fabricSettings JSON element and add a new element:

{
  "name": "Diagnostics",
  "parameters": [
    {
      "name": "MaxDiskQuotaInMB",
      "value": "65536"
    }
  ]
}

You can also customize cluster settings in one of the following ways with Azure Resource Manager:

• Use the Azure portal to export and update the Resource Manager template.
• Use PowerShell to export and update the Resource Manager template.
• Use the Azure CLI to export and update the Resource Manager template.
• Use the Azure PowerShell Set-AzServiceFabricSetting and Remove-AzServiceFabricSetting commands to modify the setting directly.
• Use the Azure CLI az sf cluster setting commands to modify the setting directly.

Next steps

• Learn about the Service Fabric cluster settings.
• Learn how to scale your cluster in and out.