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

This article uses the Azure Az PowerShell module, which is the recommended PowerShell module for interacting with Azure. To get started with the Az PowerShell module, see Install Azure PowerShell. 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 Manger 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.