1
0
mirror of https://github.com/openshift/openshift-docs.git synced 2026-02-05 12:46:18 +01:00
Files
openshift-docs/storage/container_storage_interface/persistent-storage-csi-azure.adoc

74 lines
4.7 KiB
Plaintext
Raw Permalink Normal View History

:_mod-docs-content-type: ASSEMBLY
2021-06-21 10:46:09 -04:00
[id="persistent-storage-csi-azure-disk"]
= Azure Disk CSI Driver Operator
2022-02-16 11:35:56 -05:00
include::_attributes/common-attributes.adoc[]
2021-06-21 10:46:09 -04:00
: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.
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.
2021-10-13 10:41:22 -04:00
To create CSI-provisioned PVs that mount to Azure Disk storage assets, {product-title} installs the Azure Disk CSI Driver Operator and the Azure Disk CSI driver by default in the `openshift-cluster-csi-drivers` namespace.
2021-06-21 10:46:09 -04:00
2023-01-27 10:47:37 -05:00
* The _Azure Disk CSI Driver Operator_ 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. You can disable this default storage class if desired (see xref:../../storage/container_storage_interface/persistent-storage-csi-sc-manage.adoc#persistent-storage-csi-sc-manage[Managing the default storage class]).
2021-06-21 10:46:09 -04:00
* The _Azure Disk CSI driver_ enables you to create and mount Azure Disk PVs.
include::modules/persistent-storage-csi-about.adoc[leveloffset=+1]
[NOTE]
2021-06-21 10:46:09 -04:00
====
{product-title} provides automatic migration for the Azure Disk in-tree volume plugin to its equivalent CSI driver. For more information, see xref:../../storage/container_storage_interface/persistent-storage-csi-migration.adoc#persistent-storage-csi-migration[CSI automatic migration].
2021-06-21 10:46:09 -04:00
====
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]
2022-07-01 09:50:16 -04:00
ifndef::openshift-rosa,openshift-dedicated[]
include::modules/persistent-storage-byok.adoc[leveloffset=+1]
[NOTE]
====
If the OS (root) disk is encrypted, and there is no encrypted key defined in the storage class, Azure Disk CSI driver uses the OS disk encryption key by default to encrypt provisioned storage volumes.
====
2024-06-19 16:20:53 +05:30
For information about installing with user-managed encryption for Azure, see xref:../../installing/installing_azure/ipi/installing-azure-preparing-ipi.adoc#preparing-disk-encryption-sets_installing-azure-preparing-ipi[Enabling user-managed encryption for Azure].
2022-07-01 09:50:16 -04:00
endif::openshift-rosa,openshift-dedicated[]
//Machine sets that deploy machines on ultra disks using PVCs
include::modules/machineset-azure-ultra-disk.adoc[leveloffset=+1]
2022-02-17 13:08:23 -05:00
[role="_additional-resources"]
.Additional resources
* link:https://docs.microsoft.com/en-us/azure/virtual-machines/disks-types#ultra-disks[Microsoft Azure ultra disks documentation]
* xref:../../storage/persistent_storage/persistent-storage-azure.adoc#machineset-azure-ultra-disk_persistent-storage-azure[Machine sets that deploy machines on ultra disks using in-tree PVCs]
* xref:../../machine_management/creating_machinesets/creating-machineset-azure.adoc#machineset-azure-ultra-disk_creating-machineset-azure[Machine sets that deploy machines on ultra disks as data disks]
2022-09-30 16:24:20 -04:00
//Creating machines on ultra disks by using compute machine sets
include::modules/machineset-creating-azure-ultra-disk.adoc[leveloffset=+2]
2022-09-30 16:24:20 -04:00
//Troubleshooting resources for compute machine sets that enable ultra disks
include::modules/machineset-troubleshooting-azure-ultra-disk.adoc[leveloffset=+2]
2021-10-13 10:41:22 -04:00
[id="additional-resources_persistent-storage-csi-azure"]
[role="_additional-resources"]
2021-10-13 10:41:22 -04:00
== Additional resources
2021-06-21 10:46:09 -04:00
* 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]