Skip to content

Commit f9dcd55

Browse files
author
Lisa Pettyjohn
committed
OSDOCS-15304#Performance plus for Azure Disk
1 parent a103796 commit f9dcd55

5 files changed

+149
-0
lines changed

‎modules/persistent-storage-csi-azure-disk-perf-plus-create-new-disk-by-snapshot-clone.adoc‎

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,32 @@
1+
//
2+
// Module included in the following assemblies:
3+
//
4+
// * storage/container_storage_interface/persistent-storage-csi-azure.adoc
5+
//
6+
7+
:_mod-docs-content-type: PROCEDURE
8+
[id="persistent-storage-csi-azure-disk-perf-plus-create-new-disk-by-snapshot-clone_{context}"]
9+
= Enabling performance plus by snapshot or cloning
10+
11+
Normally, performance plus can be enabled only on new disks. For a workaround, you can use this procedure.
12+
13+
.Prerequisites
14+
15+
* Access to a Microsoft Azure cluster with cluster-admin privileges.
16+
17+
* Access to an Azure disk with performance plus enabled.
18+
19+
* Have created a storage class to use performance plus enhanced Azure disks.
20+
+
21+
For more information about creating the storage class, see Section _Creating a storage class to use performance plus enhanced disks_.
22+
23+
.Procedure
24+
To enable performance plus by snapshot or clone:
25+
26+
. Create a snapshot of the existing volume that does not have performance plus enabled on it.
27+
28+
. Provision a new disk from that snapshot using a storage class with `enablePerformancePlus` set to "true".
29+
30+
Or
31+
32+
* Clone the persistent volume claim (PVC) using a storage class with `enablePerformancePlus` set to "true" to create a new disk clone.

‎modules/persistent-storage-csi-azure-disk-perf-plus-limits.adoc‎

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,20 @@
1+
//
2+
// Module included in the following assemblies:
3+
//
4+
// * storage/container_storage_interface/persistent-storage-csi-azure.adoc
5+
//
6+
7+
:_mod-docs-content-type: CONCEPT
8+
[id="persistent-storage-csi-azure-disk-perf-plus-limits_{context}"]
9+
= Limitations
10+
11+
Performance plus for Azure Disk has the following limitations:
12+
13+
* Can be enabled only on Standard HDD, Standard SSD, and Premium SSD managed disks that are 513 GiB or larger.
14+
+
15+
[IMPORTANT]
16+
====
17+
If you request a smaller value, the disk size is rounded up to 513GiB.
18+
====
19+
20+
* Can be enabled only on new disks. For a workaround, see Section _Enabling performance plus by snapshot or cloning_.

‎modules/persistent-storage-csi-azure-disk-perf-plus-overview.adoc‎

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
//
2+
// Module included in the following assemblies:
3+
//
4+
// * storage/container_storage_interface/persistent-storage-csi-azure.adoc
5+
//
6+
7+
:_mod-docs-content-type: CONCEPT
8+
[id="persistent-storage-csi-azure-disk-perf-plus-overview_{context}"]
9+
= Overview
10+
11+
By enabling performance plus, the Input/Output Operations Per Second (IOPS) and throughput limits can be increased for the following types of disks that are 513 GiB, and larger:
12+
13+
* Azure Premium solid-state drives (SSD)
14+
15+
* Standard SSDs
16+
17+
* Standard hard disk drives (HDD)

‎modules/persistent-storage-csi-azure-disk-perf-plus-sc.adoc‎

Lines changed: 67 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,67 @@
1+
//
2+
// Module included in the following assemblies:
3+
//
4+
// * storage/container_storage_interface/persistent-storage-csi-azure.adoc
5+
//
6+
7+
:_mod-docs-content-type: PROCEDURE
8+
[id="persistent-storage-csi-azure-disk-perf-plus-sc_{context}"]
9+
= Creating a storage class to use performance plus enhanced disks
10+
11+
The following procedure explains how to create a storage class to use performance plus enhanced Azure disks.
12+
13+
.Prerequisites
14+
15+
* Access to a Microsoft Azure cluster with cluster-admin privileges.
16+
17+
* Access to an Azure disk with performance plus enabled.
18+
+
19+
For information about enabling performance plus on disks, see the Microsoft Azure storage documentation.
20+
21+
.Procedure
22+
23+
To create a storage class to use performance plus enhanced disks:
24+
25+
. Create a storage class using the following example YAML file:
26+
+
27+
.Example storage class YAML file
28+
[resource,yaml]
29+
----
30+
apiVersion: storage.k8s.io/v1
31+
kind: StorageClass
32+
metadata:
33+
name: <azure-disk-performance-plus-sc> <1>
34+
provisioner: disk.csi.azure.com <2>
35+
parameters:
36+
skuName: Premium_LRS <3>
37+
cachingMode: ReadOnly
38+
enablePerformancePlus: "true" <4>
39+
reclaimPolicy: Delete
40+
volumeBindingMode: WaitForFirstConsumer
41+
allowVolumeExpansion: true
42+
----
43+
<1> Name of the storage class.
44+
<2> Specifies the Azure Disk Container Storage Interface (CSI) driver provisioner.
45+
<3> Specifies the Azure disk type SKU. In this example, `Premium_LRS` for Premium SSD Locally Redundant Storage.
46+
<4> Enables Azure Disk performance plus.
47+
48+
. Create a persistent volume claim (PVC) that uses this storage class by using the following example YAML file:
49+
+
50+
.Example PVC YAML file
51+
[source,yaml]
52+
----
53+
apiVersion: v1
54+
kind: PersistentVolumeClaim
55+
metadata:
56+
name: <my-azure-pvc> <1>
57+
spec:
58+
accessModes:
59+
- ReadWriteOnce
60+
storageClassName: <azure-disk-performance-plus-sc> <2>
61+
resources:
62+
requests:
63+
storage: 513Gi <3>
64+
----
65+
<1> PVC name.
66+
<2> Reference the performance plus storage class.
67+
<3> Any disk size smaller than 513GiB is automatically rounded up.

‎storage/container_storage_interface/persistent-storage-csi-azure.adoc‎

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -27,6 +27,18 @@ include::modules/persistent-storage-csi-about.adoc[leveloffset=+1]
2727

2828
include::modules/persistent-storage-csi-azure-disk-sc-zrs.adoc[leveloffset=+1]
2929

30+
== Performance plus for Azure Disk
31+
32+
include::modules/persistent-storage-csi-azure-disk-perf-plus-overview.adoc[leveloffset=+2]
33+
34+
To see what the increased limits are for IOPS and throughput, consult the columns that begin with *Expanded* in the tables in link:https://learn.microsoft.com/en-us/azure/virtual-machines/disks-scalability-targets[Scalability and performance targets for VM disks].
35+
36+
include::modules/persistent-storage-csi-azure-disk-perf-plus-limits.adoc[leveloffset=+2]
37+
38+
include::modules/persistent-storage-csi-azure-disk-perf-plus-sc.adoc[leveloffset=+2]
39+
40+
include::modules/persistent-storage-csi-azure-disk-perf-plus-create-new-disk-by-snapshot-clone.adoc[leveloffset=+2]
41+
3042
ifndef::openshift-rosa,openshift-dedicated[]
3143
include::modules/persistent-storage-byok.adoc[leveloffset=+1]
3244

@@ -58,3 +70,4 @@ include::modules/machineset-troubleshooting-azure-ultra-disk.adoc[leveloffset=+2
5870
== Additional resources
5971
* xref:../../storage/persistent_storage/persistent-storage-azure.adoc#persistent-storage-using-azure[Persistent storage using Azure Disk]
6072
* xref:../../storage/container_storage_interface/persistent-storage-csi.adoc#persistent-storage-csi[Configuring CSI volumes]
73+
* link:https://learn.microsoft.com/azure/[Microsoft Azure storage documentation]

0 commit comments

Comments
 (0)