Skip to content

Commit 6c7a55e

Browse files
Merge pull request #176311 from saketharsh/manageddiskupdate
Documentation update for Supporting Managed data disks in Service fabric
2 parents bb91a87 + 0341387 commit 6c7a55e

File tree

2 files changed

+86
-0
lines changed

2 files changed

+86
-0
lines changed
Lines changed: 84 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,84 @@
1+
---
2+
title: Deploy Service Fabric node-types Managed Data disks
3+
description: Learn how to create and deploy Service fabric node-types with attached Managed data disks
4+
author: craftyhouse
5+
6+
ms.topic: conceptual
7+
ms.date: 10/19/2021
8+
ms.author: micraft
9+
10+
---
11+
12+
# Deploy an Azure Service Fabric cluster node-type with Managed data disks(Preview)
13+
14+
Service Fabric node types by default use the temporary disk on each VM in the underlying virtual machine scale set for data storage. However, since the temporary disk is not persistent, and the size of the temporary disk is bound to a given VM SKU, that can be too restrictive for some scenarios. With Azure Managed Disks customers have a persistent data disk they can specify the size and performance on that will be used for a node-type, separately from a VM SKU. The following document provides steps to use native support from Service fabric to configure and use Azure Managed Disks as the default data path. Service Fabric will automatically configure Azure Managed Disks on node type creation and handle situations where VMs or the virtual machine scale set is reimaged.
15+
16+
* Required minimum disk size for the managed data disk is 50 GB.
17+
* In scenarios where more than one managed data disk is attached, customer needs to manage the data disks on their own.
18+
19+
## Configuring virtual machine scale set to use managed data disks in Service fabric
20+
To use Azure Managed Disks on a node type, configure the underlying virtual machine scale set resource with the following:
21+
22+
* Add a managed disk in data disks section of the template for the virtual machine scale set.
23+
* Update the Service fabric extension with following settings:
24+
* For Windows - **useManagedDataDisk: true** and **dataPath: 'K:\\\\SvcFab'** . Note, the drive letter "K" is just a representation, it can be any drive Letter lexicographically greater than all the drive letter present in the virtual machine scale set SKU.
25+
* For Linux - **useManagedDataDisk:true** and **dataPath: '\mnt\sfdataroot'** .
26+
27+
>[!NOTE]
28+
> Support for Managed Data disks for Linux Service Fabric clusters is currently not available for Production, but customers can try it out by using Test Service Fabric extension for Linux.
29+
30+
Service Fabric Extension Azure Resource Manager template
31+
```json
32+
{
33+
"virtualMachineProfile": {
34+
"extensionProfile": {
35+
"extensions": [
36+
{
37+
"name": "[concat(parameters('vmNodeType1Name'),'_ServiceFabricNode')]",
38+
"properties": {
39+
"type": "ServiceFabricNode",
40+
"autoUpgradeMinorVersion": false,
41+
"publisher": "Microsoft.Azure.ServiceFabric",
42+
"settings": {
43+
"clusterEndpoint": "[reference(parameters('clusterName')).clusterEndpoint]",
44+
"nodeTypeRef": "[parameters('vmNodeType1Name')]",
45+
"dataPath": "K:\\\\SvcFab",
46+
"useManagedDataDisk": true,
47+
"durabilityLevel": "Bronze",
48+
"certificate": {
49+
"thumbprint": "[parameters('certificateThumbprint')]",
50+
"x509StoreName": "[parameters('certificateStoreValue')]"
51+
},
52+
"systemLogUploadSettings": {
53+
"Enabled": true
54+
},
55+
},
56+
"typeHandlerVersion": "1.1"
57+
}
58+
},
59+
]
60+
},
61+
"storageProfile":
62+
{
63+
"datadisks": [
64+
{
65+
"lun": "1",
66+
"createOption": "empty",
67+
"diskSizeGB": "100",
68+
"managedDisk": { "storageAccountType": "Standard_LRS" }
69+
}
70+
]
71+
}
72+
}
73+
}
74+
```
75+
76+
## Migrate to using Managed data disks for Service fabric node types
77+
* For all migration scenarios, a new node type needs to be added which uses managed data disks as specified above.
78+
* Once new node types are added, migrate the workloads to the new node types.
79+
* Once the resources have finished deploying, you can begin to disable the nodes in the node type that you want to remove from the original cluster.
80+
81+
## Next steps
82+
* [Service Fabric Overview](service-fabric-reliable-services-introduction.md)
83+
* [Node types and virtual machine scale sets](service-fabric-cluster-nodetypes.md)
84+
* [Service Fabric capacity planning](service-fabric-best-practices-capacity-scaling.md)

articles/service-fabric/toc.yml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -503,6 +503,8 @@
503503
href: service-fabric-cross-availability-zones.md
504504
- name: Deploy an Azure Service Fabric cluster with stateless node types
505505
href: service-fabric-stateless-node-types.md
506+
- name: Deploy an Azure Service Fabric cluster with Managed data disks
507+
href: service-fabric-managed-disk.md
506508
- name: Set up Azure Active Directory authentication
507509
href: service-fabric-cluster-creation-setup-aad.md
508510
- name: Create a custom cluster template

0 commit comments

Comments
 (0)