You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{product-title} provides the ability to deploy {product-title} for vSphere on different zones and regions, which allows you to deploy over multiple compute clusters, thus helping to avoid a single point of failure.
= Creating vSphere storage topology without an infra topology
11
9
12
10
[NOTE]
13
11
====
14
-
{product-title} on vSphere does not support multiple Datacenters.
12
+
{product-title} recommends using the infrastructure object for specifying failure domains in a topology aware setup. Specifying failure domains in the infrastructure object and specify topology-categories in the `ClusterCSIDriver` object at the same time is an unsupported operation.
15
13
====
16
14
17
-
This is accomplished by defining zone and region categories in vCenter, and then assigning these categories to different failure domains, such as a compute cluster, by creating tags for these zone and region categories. After you have created the appropriate categories, and assigned tags to vCenter objects, you can create additional machinesets that create virtual machines (VMs) that are responsible for scheduling pods in those failure domains.
18
-
19
-
.Procedure
15
+
== Procedure
20
16
. In the VMware vCenter vSphere client GUI, define appropriate zone and region catagories and tags.
21
17
+
22
18
While vSphere allows you to create categories with any arbitrary name, {product-title} strongly recommends use of `openshift-region` and `openshift-zone` names for defining topology.
23
19
+
24
-
The following example defines two failure domains with one region and two zones:
You can also create the storage class by editing the preceding YAML file and running the command `oc create -f $FILE`.
175
-
====
176
-
177
-
.Results
178
-
Creating persistent volume claims (PVCs) and PVs from the topology aware storage class are truly zonal, and should use the datastore in their respective zone depending on how pods are scheduled:
{product-title} provides the ability to deploy {product-title} for vSphere on different zones and regions, which allows you to deploy over multiple compute clusters and datacenters, thus helping to avoid a single point of failure.
11
+
12
+
This is accomplished by defining zone and region categories in vCenter, and then assigning these categories to different failure domains, such as a compute cluster, by creating tags for these zone and region categories. After you have created the appropriate categories, and assigned tags to vCenter objects, you can create additional machinesets that create virtual machines (VMs) that are responsible for scheduling pods in those failure domains.
13
+
14
+
The following example defines two failure domains with one region and two zones:
15
+
16
+
.vSphere storage topology with one region and two zones
. In the VMware vCenter vSphere client GUI, define appropriate zone and region catagories and tags.
12
+
+
13
+
While vSphere allows you to create categories with any arbitrary name, {product-title} strongly recommends use of `openshift-region` and `openshift-zone` names for defining topology categories.
14
+
+
15
+
For more information about vSphere categories and tags, see the VMware vSphere documentation.
16
+
17
+
. In {product-title}, create failure domains. See the _Specifying multiple regions and zones for your cluster on vSphere_ section.
18
+
19
+
. Create a tag to assign to datastores across failure domains:
20
+
+
21
+
When an {product-title} spans more than one failure domain, the datastore might not be shared across those failure domains, which is where topology-aware provisioning of persistent volumes (PVs) is useful.
22
+
+
23
+
.. In vCenter, create a category for tagging the datastores. For example, `openshift-zonal-datastore-cat`. You can use any other category name, provided the category uniquely is used for tagging datastores participating in {product-title} cluster. Also, ensure that `StoragePod`, `Datastore`, and `Folder` are selected as Associable Entities for the created category.
24
+
.. In vCenter, create a tag that uses the previously created category. This example uses the tag name `openshift-zonal-datastore`.
25
+
.. Assign the previously created tag (in this example `openshift-zonal-datastore`) to each datastore in a failure domain that would be considered for dynamic provisioning.
26
+
+
27
+
[NOTE]
28
+
====
29
+
You can use any names you like for datastore categories and tags. The names used in this example are provided as recommendations. Ensure that the tags and categories that you define uniquely identify only datastores that are shared with all hosts in the {product-title} cluster.
30
+
====
31
+
32
+
. As needed, create a storage policy that targets the tag-based datastores in each failure domain:
33
+
.. In vCenter, from the main menu, click *Policies and Profiles*.
34
+
.. On the *Policies and Profiles* page, in the navigation pane, click *VM Storage Policies*.
35
+
.. Click *CREATE*.
36
+
.. Type a name for the storage policy.
37
+
.. For the rules, choose Tag Placement rules and select the tag and category that targets the desired datastores (in this example, the `openshift-zonal-datastore` tag).
38
+
+
39
+
The datastores are listed in the storage compatibility table.
40
+
41
+
. Create a new storage class that uses the new zoned storage policy:
42
+
.. Click *Storage* > *StorageClasses*.
43
+
.. On the *StorageClasses* page, click *Create StorageClass*.
44
+
.. Type a name for the new storage class in *Name*.
45
+
.. Under *Provisioner*, select *csi.vsphere.vmware.com*.
46
+
.. Under *Additional parameters*, for the StoragePolicyName parameter, set *Value* to the name of the new zoned storage policy that you created earlier.
47
+
.. Click *Create*.
48
+
+
49
+
.Example output
50
+
+
51
+
[source, yaml]
52
+
----
53
+
kind: StorageClass
54
+
apiVersion: storage.k8s.io/v1
55
+
metadata:
56
+
name: zoned-sc <1>
57
+
provisioner: csi.vsphere.vmware.com
58
+
parameters:
59
+
StoragePolicyName: zoned-storage-policy <2>
60
+
reclaimPolicy: Delete
61
+
allowVolumeExpansion: true
62
+
volumeBindingMode: WaitForFirstConsumer
63
+
----
64
+
<1> New topology aware storage class name.
65
+
<2> Specify zoned storage policy.
66
+
+
67
+
[NOTE]
68
+
====
69
+
You can also create the storage class by editing the preceding YAML file and running the command `oc create -f $FILE`.
Creating persistent volume claims (PVCs) and PVs from the topology aware storage class are truly zonal, and should use the datastore in their respective zone depending on how pods are scheduled:
* https://docs.vmware.com/en/VMware-vSphere/8.0/vsphere-vcenter-esxi-management/GUID-16422FF7-235B-4A44-92E2-532F6AED0923.html?hWord=N4IghgNiBcIC5gOYgL5A[VMware vSphere tag documentation]
* xref:../../installing/installing_vsphere/installing-vsphere-installer-provisioned-network-customizations.adoc#configuring-vsphere-regions-zones_installing-vsphere-installer-provisioned-network-customizations[Configuring regions and zones for a VMware vCenter]
* xref:../../post_installation_configuration/post-install-vsphere-zones-regions-configuration.adoc#specifying-regions-zones-infrastructure-vsphere_post-install-vsphere-zones-regions-configuration[Specifying multiple regions and zones for your cluster on vSphere]
92
+
* https://docs.vmware.com/en/VMware-vSphere/8.0/vsphere-vcenter-esxi-management/GUID-16422FF7-235B-4A44-92E2-532F6AED0923.html?hWord=N4IghgNiBcIC5gOYgL5A[VMware vSphere tag documenation]
* https://docs.vmware.com/en/VMware-vSphere/8.0/vsphere-vcenter-esxi-management/GUID-16422FF7-235B-4A44-92E2-532F6AED0923.html?hWord=N4IghgNiBcIC5gOYgL5A[VMware vSphere tag documenation]
0 commit comments