Skip to content

Commit d700c8d

Browse files
authored
Merge pull request #36951 from lpettyjo/OSDOCS-2188
OSDOCS-2188: Azure File CSI Operator (Tech Preview)
2 parents 8b0bdda + 6ec9662 commit d700c8d

File tree

4 files changed

+68
-3
lines changed

4 files changed

+68
-3
lines changed

_topic_maps/_topic_map.yml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1208,6 +1208,8 @@ Topics:
12081208
File: persistent-storage-csi-aws-efs
12091209
- Name: Azure Disk CSI Driver Operator
12101210
File: persistent-storage-csi-azure
1211+
- Name: Azure File CSI Driver Operator
1212+
File: persistent-storage-csi-azure-file
12111213
- Name: Azure Stack Hub CSI Driver Operator
12121214
File: persistent-storage-csi-azure-stack-hub
12131215
- Name: GCP PD CSI Driver Operator

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

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -21,6 +21,7 @@ The following table describes the CSI drivers that are installed with {product-t
2121
|Google Cloud Platform (GCP) persistent disk (PD)| ✅ | - | ✅
2222
|Microsoft Azure Disk | ✅ | ✅ | ✅
2323
|Microsoft Azure Stack Hub | ✅ | ✅ | ✅
24+
|Microsoft Azure File (Tech Preview) | - | - | ✅
2425
|OpenStack Cinder | ✅ | ✅ | ✅
2526
|OpenShift Container Storage | ✅ | ✅ | ✅
2627
|OpenStack Manila | ✅ | - | -

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

Lines changed: 34 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -2,13 +2,20 @@
22
//
33
// persistent-storage-csi-vsphere.adoc
44
// persistent-storage-csi-azure.adoc
5+
// persistent-storage-csi-azure-file.adoc
56

67
ifeval::["{context}" == "persistent-storage-csi-vsphere"]
78
:vsphere:
89
endif::[]
910
ifeval::["{context}" == "persistent-storage-csi-azure"]
1011
:azure:
1112
endif::[]
13+
ifeval::["{context}" == "persistent-storage-csi-azure-file"]
14+
:azure_file:
15+
endif::[]
16+
ifeval::["{context}" == "persistent-storage-csi-vsphere"]
17+
:vsphere:
18+
endif::[]
1219

1320
:_content-type: PROCEDURE
1421
[id="csi-tp-enable_{context}"]
@@ -33,8 +40,8 @@ $ oc get co storage
3340
+
3441
[source, terminal]
3542
----
36-
NAME VERSION AVAILABLE PROGRESSING DEGRADED SINCE
37-
storage 4.9.0-0.nightly-2021-09-08-162532 True False False 4h26m
43+
NAME VERSION AVAILABLE PROGRESSING DEGRADED SINCE
44+
storage 4.10.0-0.nightly-2021-11-15-034648 True False False 4m36s
3845
----
3946
+
4047
* `AVAILABLE` should be "True".
@@ -76,6 +83,20 @@ azure-disk-csi-driver-node-mqdhh 3/3 Running 0
7683
azure-disk-csi-driver-operator-7d966fc6c5-x74x5 1/1 Running 0 44m
7784
----
7885
endif::azure[]
86+
ifdef::azure_file[]
87+
[source, terminal]
88+
----
89+
NAME READY STATUS RESTARTS AGE
90+
azure-file-csi-driver-controller-5949bf45fd-pm4qb 11/11 Running 0 39m
91+
azure-file-csi-driver-node-2tcxr 3/3 Running 0 53m
92+
azure-file-csi-driver-node-2xjzm 3/3 Running 0 53m
93+
azure-file-csi-driver-node-6wrgk 3/3 Running 0 53m
94+
azure-file-csi-driver-node-frvx2 3/3 Running 0 53m
95+
azure-file-csi-driver-node-lf5kb 3/3 Running 0 53m
96+
azure-file-csi-driver-node-mqdhh 3/3 Running 0 53m
97+
azure-file-csi-driver-operator-7d966fc6c5-x74x5 1/1 Running 0 44m
98+
----
99+
endif::azure_file[]
79100

80101
. Verify that the storage class is installed:
81102
+
@@ -101,5 +122,15 @@ NAME PROVISIONER RECLAIMPOLICY VOLU
101122
managed-premium (default) kubernetes.io/azure-disk Delete WaitForFirstConsumer true 76m
102123
managed-csi disk.csi.azure.com Delete WaitForFirstConsumer true 51m <1>
103124
----
104-
<1> Azure storage class
125+
<1> Azure Disk storage class
105126
endif::azure[]
127+
ifdef::azure_file[]
128+
[source,terminal]
129+
----
130+
NAME PROVISIONER RECLAIMPOLICY VOLUMEBINDINGMODE ALLOWVOLUMEEXPANSION AGE
131+
azurefile-csi file.csi.azure.com Delete Immediate true 10m <1>
132+
managed-csi disk.csi.azure.com Delete WaitForFirstConsumer true 35m
133+
managed-premium (default) kubernetes.io/azure-disk Delete WaitForFirstConsumer true 35m
134+
----
135+
<1> Azure File storage class
136+
endif::azure_file[]
Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,31 @@
1+
[id="persistent-storage-csi-azure-file"]
2+
= Azure File CSI Driver Operator
3+
include::modules/common-attributes.adoc[]
4+
:context: persistent-storage-csi-azure-file
5+
6+
toc::[]
7+
8+
== Overview
9+
10+
{product-title} is capable of provisioning persistent volumes (PVs) by using the Container Storage Interface (CSI) driver for Microsoft Azure File Storage.
11+
12+
:FeatureName: Azure File CSI Driver Operator
13+
include::modules/technology-preview.adoc[leveloffset=+1]
14+
15+
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.
16+
17+
To create CSI-provisioned PVs that mount to Azure File storage assets with this feature enabled, {product-title} installs the Azure File CSI Driver Operator and the Azure File CSI driver by default in the `openshift-cluster-csi-drivers` namespace.
18+
19+
* The _Azure File CSI Driver Operator_, after being enabled, provides a storage class that is named `azurefile-csi` that you can use to create persistent volume claims (PVCs). The Azure File 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.
20+
21+
* The _Azure File CSI driver_ enables you to create and mount Azure File PVs.
22+
23+
include::modules/persistent-storage-csi-about.adoc[leveloffset=+1]
24+
25+
:FeatureName: Azure File
26+
include::modules/persistent-storage-csi-tp-enable.adoc[leveloffset=+1]
27+
28+
.Additional resources
29+
* xref:../../storage/persistent_storage/persistent-storage-azure-file.adoc#persistent-storage-using-azure-file[Persistent storage using Azure File]
30+
* xref:../../storage/container_storage_interface/persistent-storage-csi.adoc#persistent-storage-csi[Configuring CSI volumes]
31+
* xref:../../nodes/clusters/nodes-cluster-enabling-features.adoc#[Enabling features using feature gates]

0 commit comments

Comments
 (0)