Merge pull request #96181 from lpettyjo/OSDOCS-15304

OSDOCS-15304#Performance plus for Azure Disk

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

@@ -0,0 +1,32 @@
+//
+// Module included in the following assemblies:
+//
+// * storage/container_storage_interface/persistent-storage-csi-azure.adoc
+//
+
+:_mod-docs-content-type: PROCEDURE
+[id="persistent-storage-csi-azure-disk-perf-plus-create-new-disk-by-snapshot-clone_{context}"]
+= Enabling performance plus by snapshot or cloning
+
+Normally, performance plus can be enabled only on new disks. For a workaround, you can use this procedure.
+
+.Prerequisites
+
+* Access to a Microsoft Azure cluster with cluster-admin privileges.
+
+* Access to an Azure disk with performance plus enabled.
+
+* Have created a storage class to use performance plus enhanced Azure disks.
++
+For more information about creating the storage class, see Section _Creating a storage class to use performance plus enhanced disks_.
+
+.Procedure
+To enable performance plus by snapshot or clone:
+
+. Create a snapshot of the existing volume that does not have performance plus enabled on it.
+
+. Provision a new disk from that snapshot using a storage class with `enablePerformancePlus` set to "true".
+
+Or
+
+* 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

@@ -0,0 +1,20 @@
+//
+// Module included in the following assemblies:
+//
+// * storage/container_storage_interface/persistent-storage-csi-azure.adoc
+//
+
+:_mod-docs-content-type: CONCEPT
+[id="persistent-storage-csi-azure-disk-perf-plus-limits_{context}"]
+= Limitations
+
+Performance plus for Azure Disk has the following limitations:
+
+* Can be enabled only on Standard HDD, Standard SSD, and Premium SSD managed disks that are 513 GiB or larger.
++
+[IMPORTANT]
+====
+If you request a smaller value, the disk size is rounded up to 513GiB.
+====
+
+* 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

@@ -0,0 +1,17 @@
+//
+// Module included in the following assemblies:
+//
+// * storage/container_storage_interface/persistent-storage-csi-azure.adoc
+//
+
+:_mod-docs-content-type: CONCEPT
+[id="persistent-storage-csi-azure-disk-perf-plus-overview_{context}"]
+= Overview
+
+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:
+
+* Azure Premium solid-state drives (SSD)
+
+* Standard SSDs
+
+* Standard hard disk drives (HDD)

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

@@ -0,0 +1,67 @@
+//
+// Module included in the following assemblies:
+//
+// * storage/container_storage_interface/persistent-storage-csi-azure.adoc
+//
+
+:_mod-docs-content-type: PROCEDURE
+[id="persistent-storage-csi-azure-disk-perf-plus-sc_{context}"]
+= Creating a storage class to use performance plus enhanced disks
+
+The following procedure explains how to create a storage class to use performance plus enhanced Azure disks.
+
+.Prerequisites
+
+* Access to a Microsoft Azure cluster with cluster-admin privileges.
+
+* Access to an Azure disk with performance plus enabled. 
++
+For information about enabling performance plus on disks, see the Microsoft Azure storage documentation.
+
+.Procedure
+
+To create a storage class to use performance plus enhanced disks:
+
+. Create a storage class using the following example YAML file:
++
+.Example storage class YAML file
+[resource,yaml]
+----
+apiVersion: storage.k8s.io/v1
+kind: StorageClass
+metadata:
+  name: <azure-disk-performance-plus-sc> <1>
+provisioner: disk.csi.azure.com <2>
+parameters:
+  skuName: Premium_LRS <3>
+  cachingMode: ReadOnly
+  enablePerformancePlus: "true" <4>
+reclaimPolicy: Delete
+volumeBindingMode: WaitForFirstConsumer
+allowVolumeExpansion: true
+----
+<1> Name of the storage class.
+<2> Specifies the Azure Disk Container Storage Interface (CSI) driver provisioner.
+<3> Specifies the Azure disk type SKU. In this example, `Premium_LRS` for Premium SSD Locally Redundant Storage. 
+<4> Enables Azure Disk performance plus.
+
+. Create a persistent volume claim (PVC) that uses this storage class by using the following example YAML file:
++
+.Example PVC YAML file
+[source,yaml]
+----
+apiVersion: v1
+kind: PersistentVolumeClaim
+metadata:
+  name: <my-azure-pvc> <1>
+spec:
+  accessModes:
+    - ReadWriteOnce
+  storageClassName: <azure-disk-performance-plus-sc> <2>
+  resources:
+    requests:
+      storage: 513Gi <3>
+----
+<1> PVC name.
+<2> Reference the performance plus storage class.
+<3> Any disk size smaller than 513GiB is automatically rounded up.

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

@@ -27,6 +27,18 @@ include::modules/persistent-storage-csi-about.adoc[leveloffset=+1]
 
 include::modules/persistent-storage-csi-azure-disk-sc-zrs.adoc[leveloffset=+1]
 
+== Performance plus for Azure Disk
+
+include::modules/persistent-storage-csi-azure-disk-perf-plus-overview.adoc[leveloffset=+2]
+
+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].
+
+include::modules/persistent-storage-csi-azure-disk-perf-plus-limits.adoc[leveloffset=+2]
+
+include::modules/persistent-storage-csi-azure-disk-perf-plus-sc.adoc[leveloffset=+2]
+
+include::modules/persistent-storage-csi-azure-disk-perf-plus-create-new-disk-by-snapshot-clone.adoc[leveloffset=+2]
+
 ifndef::openshift-rosa,openshift-dedicated[]
 include::modules/persistent-storage-byok.adoc[leveloffset=+1]
 
@@ -58,3 +70,4 @@ include::modules/machineset-troubleshooting-azure-ultra-disk.adoc[leveloffset=+2
 == Additional resources
 * xref:../../storage/persistent_storage/persistent-storage-azure.adoc#persistent-storage-using-azure[Persistent storage using Azure Disk]
 * xref:../../storage/container_storage_interface/persistent-storage-csi.adoc#persistent-storage-csi[Configuring CSI volumes]
+* link:https://learn.microsoft.com/azure/[Microsoft Azure storage documentation]