Merge pull request #31491 from lpettyjo/OSDOC-1984

Author: Bob Furu

_topic_map.yml

@@ -1115,6 +1115,8 @@ Topics:
     File: persistent-storage-csi-migration
   - Name: AWS Elastic Block Store CSI Driver Operator
     File: persistent-storage-csi-ebs
+  - Name: Azure Disk CSI Driver Operator
+    File: persistent-storage-csi-azure
   - Name: GCP PD CSI Driver Operator
     File: persistent-storage-csi-gcp-pd
   - Name: OpenStack Cinder CSI Driver Operator

modules/persistent-storage-csi-drivers-supported.adoc

@@ -18,6 +18,7 @@ The following table describes the CSI drivers that are installed with {product-t
 
 |AWS EBS (Tech Preview) | ✅ | - | ✅
 |Google Cloud Platform (GCP) persistent disk (PD) (Tech Preview)| ✅ | - | ✅
+|Microsoft Azure Disk (Tech Preview) | ✅ | ✅ | ✅ 
 |OpenStack Cinder | ✅ | ✅ | ✅
 |OpenStack Manila | ✅ | ✅ | ✅
 |Red Hat Virtualization (oVirt) | - | - | -

modules/persistent-storage-csi-tp-enable.adoc

@@ -17,6 +17,7 @@ To enable the {FeatureName} Container Storage Interface (CSI) Driver Operator, y
 .Procedure
 
 . Enable feature gates with the `TechPreviewNoUpgrade` feature set (see _Nodes_ -> _Enabling features using feature gates_).
+
 +
 [IMPORTANT]
 ====

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

@@ -0,0 +1,40 @@
+[id="persistent-storage-csi-azure-disk"]
+= Azure Disk CSI Driver Operator
+include::modules/common-attributes.adoc[]
+:context: persistent-storage-csi-azure
+
+toc::[]
+
+== Overview
+
+{product-title} is capable of provisioning persistent volumes (PVs) using the Container Storage Interface (CSI) driver for Microsoft Azure Disk Storage.
+
+:FeatureName: Azure Disk CSI Driver Operator
+include::modules/technology-preview.adoc[leveloffset=+1]
+
+Familiarity with xref:../../storage/understanding-persistent-storage.adoc#understanding-persistent-storage[persistent storage] and xref:../../storage/container_storage_interface/persistent-storage-csi.adoc#persistent-storage-csi[configuring CSI volumes] is recommended when working with a CSI Operator and driver.
+
+To create CSI-provisioned PVs that mount to Azure Disk storage assets with this feature is enabled, {product-title} installs the Azure Disk CSI Driver Operator and the Azure Disk CSI driver by default in the `openshift-cluster-csi-drivers` namespace.
+
+* The _Azure Disk CSI Driver Operator_ , after being enabled, provides a storage class named `managed-csi` that you can use to create persistent volume claims (PVCs). The Azure Disk CSI Driver Operator supports dynamic volume provisioning by allowing storage volumes to be created on-demand, eliminating the need for cluster administrators to pre-provision storage.
+
+* The _Azure Disk CSI driver_ enables you to create and mount Azure Disk PVs.
+
+include::modules/persistent-storage-csi-about.adoc[leveloffset=+1]
+
+[IMPORTANT]
+====
+{product-title} defaults to using an in-tree (non-CSI) plug-in to provision Azure Disk storage.
+
+In future {product-title} versions, volumes provisioned using existing in-tree plug-ins are planned for migration to their equivalent CSI driver. CSI automatic migration should be seamless. Migration does not change how you use all existing API objects, such as persistent volumes, persistent volume claims, and storage classes. For more information about migration, see xref:../../storage/container_storage_interface/persistent-storage-csi-migration.adoc#persistent-storage-csi-migration[CSI automatic migration].
+
+After full migration, in-tree plug-ins will eventually be removed in later versions of {product-title}.
+====
+
+:FeatureName: Azure
+include::modules/persistent-storage-csi-tp-enable.adoc[leveloffset=+1]
+
+.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]
+* xref:../../nodes/clusters/nodes-cluster-enabling-features.adoc#[Enabling features using feature gates]