Skip to content

Commit 7dc9065

Browse files
author
Lisa Pettyjohn
committed
vSphere CSI (TP)
1 parent 4acbb08 commit 7dc9065

File tree

4 files changed

+146
-0
lines changed

4 files changed

+146
-0
lines changed

‎_topic_map.yml‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1106,6 +1106,8 @@ Topics:
11061106
File: persistent-storage-csi-manila
11071107
- Name: Red Hat Virtualization CSI Driver Operator
11081108
File: persistent-storage-csi-ovirt
1109+
- Name: VMware vSphere CSI Driver Operator
1110+
File: persistent-storage-csi-vsphere
11091111
- Name: Expanding persistent volumes
11101112
File: expanding-persistent-volumes
11111113
Distros: openshift-enterprise,openshift-origin,openshift-dedicated

‎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
|OpenStack Cinder | ✅ | ✅ | ✅
2222
|OpenStack Manila | ✅ | ✅ | ✅
2323
|Red Hat Virtualization (oVirt) | - | - | -
24+
|VMware vSphere (Tech Preview) | - | - | -
2425
|===
2526

2627
[IMPORTANT]

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

Lines changed: 103 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,103 @@
1+
// Module included in the following assemblies:
2+
//
3+
// persistent-storage-csi-vsphere.adoc
4+
// persistent-storage-csi-azure.adoc
5+
6+
ifeval::["{context}" == "persistent-storage-csi-vsphere"]
7+
:vsphere:
8+
endif::[]
9+
ifeval::["{context}" == "persistent-storage-csi-azure"]
10+
:azure:
11+
endif::[]
12+
13+
[id="csi-tp-enable_{context}"]
14+
= Enabling the {FeatureName} CSI Driver Operator
15+
To enable the {FeatureName} Container Storage Interface (CSI) Driver Operator, you must enable feature gates with the `TechPreviewNoUpgrade` feature set.
16+
17+
.Procedure
18+
19+
. Enable feature gates with the `TechPreviewNoUpgrade` feature set (see _Nodes_ -> _Enabling features using feature gates_).
20+
+
21+
[IMPORTANT]
22+
====
23+
After turning Technology Preview features on by using feature gates, they cannot be turned off and cluster upgrades are prevented.
24+
====
25+
. Verify the cluster operator storage:
26+
+
27+
[source,terminal]
28+
----
29+
$ oc get co storage
30+
----
31+
+
32+
[source, terminal]
33+
----
34+
NAME VERSION AVAILABLE PROGRESSING DEGRADED SINCE
35+
storage 4.8.0-0.nightly-2021-04-30-201824 True False False 4h26m
36+
----
37+
+
38+
* `AVAILABLE` should be "True".
39+
* `PROGRESSING` should be "False".
40+
* `DEGRADED` should be "False".
41+
42+
. Verify the status of the pods in the `openshift-cluster-csi-drivers` namespace to ensure that they are running:
43+
+
44+
[source,terminal]
45+
----
46+
$ oc get pod -n openshift-cluster-csi-drivers
47+
----
48+
+
49+
ifdef::vsphere[]
50+
[source, terminal]
51+
----
52+
NAME READY STATUS RESTARTS AGE
53+
vmware-vsphere-csi-driver-controller-5646dbbf54-cnsx7 9/9 Running 0 4h29m
54+
vmware-vsphere-csi-driver-node-ch22q 3/3 Running 0 4h37m
55+
vmware-vsphere-csi-driver-node-gfjrb 3/3 Running 0 4h37m
56+
vmware-vsphere-csi-driver-node-ktlmp 3/3 Running 0 4h37m
57+
vmware-vsphere-csi-driver-node-lgksl 3/3 Running 0 4h37m
58+
vmware-vsphere-csi-driver-node-vb4gv 3/3 Running 0 4h37m
59+
vmware-vsphere-csi-driver-operator-7c7fc474c-p544t 1/1 Running 0 4h29m
60+
----
61+
endif::vsphere[]
62+
63+
ifdef::azure[]
64+
[source, terminal]
65+
----
66+
NAME READY STATUS RESTARTS AGE
67+
azure-disk-csi-driver-controller-5949bf45fd-pm4qb 11/11 Running 0 39m
68+
azure-disk-csi-driver-node-2tcxr 3/3 Running 0 53m
69+
azure-disk-csi-driver-node-2xjzm 3/3 Running 0 53m
70+
azure-disk-csi-driver-node-6wrgk 3/3 Running 0 53m
71+
azure-disk-csi-driver-node-frvx2 3/3 Running 0 53m
72+
azure-disk-csi-driver-node-lf5kb 3/3 Running 0 53m
73+
azure-disk-csi-driver-node-mqdhh 3/3 Running 0 53m
74+
azure-disk-csi-driver-operator-7d966fc6c5-x74x5 1/1 Running 0 44m
75+
----
76+
endif::azure[]
77+
78+
. Verify that the storage class is installed:
79+
+
80+
[source,terminal]
81+
----
82+
$ oc get storageclass
83+
----
84+
+
85+
ifdef::vsphere[]
86+
[source,terminal]
87+
----
88+
NAME PROVISIONER RECLAIMPOLICY VOLUMEBINDINGMODE ALLOWVOLUMEEXPANSION AGE
89+
thin (default) kubernetes.io/vsphere-volume Delete Immediate false 5h43m
90+
thin-csi csi.vsphere.vmware.com Delete WaitForFirstConsumer false 4h38m <1>
91+
----
92+
<1> vSphere storage class
93+
endif::vsphere[]
94+
95+
ifdef::azure[]
96+
[source,terminal]
97+
----
98+
NAME PROVISIONER RECLAIMPOLICY VOLUMEBINDINGMODE ALLOWVOLUMEEXPANSION AGE
99+
managed-premium (default) kubernetes.io/azure-disk Delete WaitForFirstConsumer true 76m
100+
managed-csi disk.csi.azure.com Delete WaitForFirstConsumer true 51m <1>
101+
----
102+
<1> Azure storage class
103+
endif::azure[]

‎storage/container_storage_interface/persistent-storage-csi-vsphere.adoc‎

Lines changed: 40 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,40 @@
1+
[id="persistent-storage-vsphere"]
2+
= VMware vSphere CSI Driver Operator
3+
include::modules/common-attributes.adoc[]
4+
:context: persistent-storage-csi-vsphere
5+
6+
toc::[]
7+
8+
== Overview
9+
10+
{product-title} can provision persistent volumes (PVs) using the Container Storage Interface (CSI) VMware vSphere driver for Virtual Machine Disk (VMDK) volumes.
11+
12+
:FeatureName: vSphere 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 persistent volumes (PVs) that mount to vSphere storage assets, {product-title}, after this feature is enabled, installs the vSphere CSI Driver Operator and the vSphere CSI driver by default in the `openshift-cluster-csi-drivers` namespace.
18+
19+
* *vSphere CSI Driver Operator*: After being enabled, the Operator provides a storage class, called `thin-csi`, that you can use to create persistent volumes claims (PVCs). The vSphere 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+
* *vSphere CSI driver*: The driver enables you to create and mount vSphere PVs.
22+
23+
[IMPORTANT]
24+
====
25+
{product-title} defaults to using an in-tree (non-CSI) plug-in to provision vSphere storage.
26+
27+
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].
28+
29+
After full migration, in-tree plug-ins will eventually be removed in future versions of {product-title}.
30+
====
31+
32+
include::modules/persistent-storage-csi-about.adoc[leveloffset=+1]
33+
.Additional resources
34+
* xref:../../storage/container_storage_interface/persistent-storage-csi.adoc#persistent-storage-csi[Configuring CSI volumes]
35+
36+
:FeatureName: vSphere
37+
include::modules/persistent-storage-csi-tp-enable.adoc[leveloffset=+1]
38+
39+
== Additional resources
40+
* xref:../../nodes/clusters/nodes-cluster-enabling-features.adoc#[Enabling features using feature gates]

0 commit comments

Comments
 (0)