From a58a195390e83544c45052f58a5c0481817c368b Mon Sep 17 00:00:00 2001 From: Lisa Pettyjohn Date: Mon, 21 Jun 2021 10:46:09 -0400 Subject: [PATCH] OSDOCS-1984 Azure CSI --- _topic_map.yml | 2 + ...sistent-storage-csi-drivers-supported.adoc | 1 + modules/persistent-storage-csi-tp-enable.adoc | 1 + .../persistent-storage-csi-azure.adoc | 40 +++++++++++++++++++ 4 files changed, 44 insertions(+) create mode 100644 storage/container_storage_interface/persistent-storage-csi-azure.adoc diff --git a/_topic_map.yml b/_topic_map.yml index 400c960095..bc197c2543 100644 --- a/_topic_map.yml +++ b/_topic_map.yml @@ -1103,6 +1103,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 diff --git a/modules/persistent-storage-csi-drivers-supported.adoc b/modules/persistent-storage-csi-drivers-supported.adoc index 6af6a22f28..d49307a1ad 100644 --- a/modules/persistent-storage-csi-drivers-supported.adoc +++ b/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) | - | - | - diff --git a/modules/persistent-storage-csi-tp-enable.adoc b/modules/persistent-storage-csi-tp-enable.adoc index 5fbde5f91a..91f4c20540 100644 --- a/modules/persistent-storage-csi-tp-enable.adoc +++ b/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] ==== diff --git a/storage/container_storage_interface/persistent-storage-csi-azure.adoc b/storage/container_storage_interface/persistent-storage-csi-azure.adoc new file mode 100644 index 0000000000..44e03989d2 --- /dev/null +++ b/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]