Skip to content

Commit 6e53101

Browse files
author
Lisa Pettyjohn
committed
OSDOCS-xxxx:Automigration for Azure File and Vsphere
1 parent 144971a commit 6e53101

9 files changed

+117
-59
lines changed

‎modules/persistent-storage-csi-migration-overview.adoc

Lines changed: 6 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -6,30 +6,19 @@
66
[id="persistent-storage-csi-migration-overview_{context}"]
77
= Overview
88

9-
Volumes that are provisioned by using in-tree storage plugins, and that are supported by this feature, are migrated to their counterpart Container Storage Interface (CSI) drivers. This process does not perform any data migration; {product-title} only translates the persistent volume object in memory. As a result, the translated persistent volume object is not stored on disk, nor is its contents changed.
9+
This feature automatically migrates volumes that were provisioned using in-tree storage plugins to their counterpart Container Storage Interface (CSI) drivers.
1010

11-
The following in-tree to CSI drivers are supported:
11+
This process does not perform any data migration; {product-title} only translates the persistent volume object in memory. As a result, the translated persistent volume object is not stored on disk, nor is its contents changed. CSI automatic migration should be seamless. This feature does not change how you use all existing API objects: for example, `PersistentVolumes`, `PersistentVolumeClaims`, and `StorageClasses`.
1212

13-
.CSI automatic migration feature supported in-tree/CSI drivers
14-
[cols=",^v,^v,^v width="100%",options="header"]
15-
|===
16-
|In-tree/CSI drivers |Support level |CSI auto migration enabled automatically?
13+
The following in-tree to CSI drivers are automatically migrated:
1714

18-
a|
1915
* Azure Disk
2016
* OpenStack Cinder
2117
* Amazon Web Services (AWS) Elastic Block Storage (EBS)
2218
* Google Compute Engine Persistent Disk (GCP PD)
23-
|Generally available (GA)
24-
| Yes. For more information, see "_Automatic migration of in-tree volumes to CSI_".
25-
26-
a|
2719
* Azure File
28-
* VMware vSphere
29-
|Technology Preview (TP)
30-
| No. To enable, see "_Manually enabling CSI automatic migration_".
31-
|===
20+
* VMware vSphere (see information below for specific migration behavior for vSphere)
3221
33-
CSI automatic migration should be seamless. This feature does not change how you use all existing API objects: for example, `PersistentVolumes`, `PersistentVolumeClaims`, and `StorageClasses`.
22+
CSI migration for these volume types is considered generally available (GA), and requires no manual intervention.
3423

35-
Enabling CSI automatic migration for in-tree persistent volumes (PVs) or persistent volume claims (PVCs) does not enable any new CSI driver features, such as snapshots or expansion, if the original in-tree storage plugin did not support it.
24+
CSI automatic migration of in-tree persistent volumes (PVs) or persistent volume claims (PVCs) does not enable any new CSI driver features, such as snapshots or expansion, if the original in-tree storage plugin did not support it.

‎modules/persistent-storage-csi-migration-sc.adoc

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
// Module included in the following assemblies:
2+
//
3+
// * storage/container_storage_interface/persistent-storage-csi-migration.adoc
4+
5+
:_content-type: CONCEPT
6+
[id="persistent-storage-csi-migration-sc-implications_{context}"]
7+
= Storage class implications
8+
9+
For new {product-title} 4.13, and later, installations, the default storage class is the CSI storage class. All volumes provisioned using this storage class are CSI persistent volumes (PVs).
10+
11+
For clusters upgraded from 4.12, and earlier, to 4.13, and later, the CSI storage class is created, and is set as the default if no default storage class was set prior to the upgrade. In the very unlikely case that there is a storage class with the same name, the existing storage class remains unchanged. Any existing in-tree storage classes remain, and might be necessary for certain features, such as volume expansion to work for existing in-tree PVs. While storage class referencing to the in-tree storage plugin will continue working, we recommend that you switch the default storage class to the CSI storage class.

‎modules/persistent-storage-csi-migration-vsphere.adoc

Lines changed: 86 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,86 @@
1+
// Module included in the following assemblies:
2+
//
3+
// * storage/container_storage_interface/persistent-storage-csi-migration.adoc
4+
5+
:_content-type: CONCEPT
6+
[id="persistent-storage-csi-migration-sc-vsphere_{context}"]
7+
= vSphere automatic migration
8+
9+
=== New installations of {product-title}
10+
For new installations of {product-title} 4.13, or later, automatic migration is enabled by default.
11+
12+
=== Upgrading {product-title}
13+
When upgrading from {product-title} 4.12, or earlier, to 4.13, automatic CSI migration for vSphere only occurs if you opt in.
14+
15+
[IMPORTANT]
16+
====
17+
Carefully review the following consequences before opting in to migration:
18+
19+
* link:https://access.redhat.com/node/7011683[There are known issues that can occur that can cause the migration to fail].
20+
21+
* Enabling migration cannot be undone.
22+
23+
* Migration can take awhile to complete depending on how many nodes are on the cluster.
24+
25+
* Migration is a disruptive process. The Machine Config Operator (MCO) has to update kubelet, which means degrading each node as it rolls out the new MachineConfig to each machine.
26+
====
27+
28+
==== Using the web console to opt in to automatic CSI migration
29+
30+
===== Prerequisites
31+
32+
* Access to the {product-title} web console.
33+
34+
* Access to the cluster with cluster-admin privileges.
35+
36+
===== Procedure
37+
38+
To opt in to automatic CSI migration for vSphere:
39+
40+
. Log in to the web console.
41+
42+
. Click *Administration* -> *CustomResourceDefinitions*.
43+
44+
. On the *CustomResourceDefinitions* page, type "Storage" to find the `Storage` custom resource (CR).
45+
46+
. Click the *Storage* CR.
47+
48+
. On the *storages.operator.openshift.io* page, click the *Instances* tab.
49+
50+
. Click the name of the desired instance, and then click the *YAML* tab.
51+
52+
. Set the `spec.vsphereStorageDriver` parameter to `CSIWithMigrationDriver`, as shown in the following example:
53+
+
54+
[source, yaml]
55+
----
56+
....
57+
spec:
58+
logLevel: Normal
59+
managementState: Managed
60+
operatorLogLevel: Normal
61+
vsphereStorageDriver: CSIWithMigrationDriver <1>
62+
...
63+
----
64+
<1> `spec.vsphereStorageDriver` parameter set to `CSIWithMigrationDriver`
65+
66+
. Click *Save*.
67+
68+
==== Using the CLI to opt in to automatic CSI migration
69+
70+
===== Prerequisites
71+
72+
* Access to the cluster with cluster-admin privileges.
73+
74+
===== Procedure
75+
76+
To opt in to automatic CSI migration for vSphere, run the following command:
77+
78+
[source, cli]
79+
----
80+
oc patch storage cluster --type=merge -p '{"spec":{"vsphereStorageDriver":"CSIWithMigrationDriver"}}'
81+
----
82+
83+
[NOTE]
84+
====
85+
You can determine when migration is complete by verifying that the `VSphereMigrationControllerAvailable` condition is set to "true" in the `Storage` object.
86+
====

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

Lines changed: 1 addition & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -22,11 +22,7 @@ include::modules/persistent-storage-csi-about.adoc[leveloffset=+1]
2222

2323
[IMPORTANT]
2424
====
25-
{product-title} defaults to using an in-tree (non-CSI) plugin to provision Azure Disk storage.
26-
27-
In future {product-title} versions, volumes provisioned using existing in-tree plugins 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 plugins will eventually be removed in later versions of {product-title}.
25+
{product-title} defaults to using the CSI plugin to provision Azure Disk storage.
3026
====
3127

3228
include::modules/persistent-storage-csi-azure-disk-sc-zrs.adoc[leveloffset=+1]

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

Lines changed: 1 addition & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -25,11 +25,7 @@ include::modules/persistent-storage-csi-about.adoc[leveloffset=+1]
2525

2626
[IMPORTANT]
2727
====
28-
{product-title} defaults to using an in-tree (non-CSI) plugin to provision Cinder storage.
29-
30-
In future {product-title} versions, volumes provisioned using existing in-tree plugins 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].
31-
32-
After full migration, in-tree plugins will eventually be removed in future versions of {product-title}.
28+
{product-title} defaults to using the CSI plugin to provision Cinder storage.
3329
====
3430

3531
include::modules/persistent-storage-csi-cinder-storage-class.adoc[leveloffset=+1]

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

Lines changed: 1 addition & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -29,14 +29,7 @@ include::modules/persistent-storage-csi-about.adoc[leveloffset=+1]
2929

3030
[IMPORTANT]
3131
====
32-
{product-title} defaults to using an in-tree (non-CSI) plugin to provision AWS EBS storage.
33-
34-
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.
35-
ifndef::openshift-rosa,openshift-dedicated[]
36-
For more information about migration, see xref:../../storage/container_storage_interface/persistent-storage-csi-migration.adoc#persistent-storage-csi-migration[CSI automatic migration].
37-
endif::openshift-rosa,openshift-dedicated[]
38-
39-
After full migration, in-tree plugins will eventually be removed in future versions of {product-title}.
32+
{product-title} defaults to using the CSI plugin to provision AWS EBS storage.
4033
====
4134

4235
For information about dynamically provisioning AWS EBS persistent volumes in {product-title}, see xref:../../storage/persistent_storage/persistent-storage-aws.adoc#persistent-storage-aws[Persistent storage using AWS Elastic Block Store].

‎storage/container_storage_interface/persistent-storage-csi-gcp-pd.adoc

Lines changed: 1 addition & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -22,14 +22,7 @@ To create CSI-provisioned persistent volumes (PVs) that mount to GCP PD storage
2222

2323
[IMPORTANT]
2424
====
25-
{product-title} defaults to using an in-tree (non-CSI) plugin to provision GCP PD 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.
28-
ifndef::openshift-dedicated[]
29-
For more information about migration, see xref:../../storage/container_storage_interface/persistent-storage-csi-migration.adoc#persistent-storage-csi-migration[CSI automatic migration].
30-
endif::openshift-dedicated[]
31-
32-
After full migration, in-tree plugins will eventually be removed in future versions of {product-title}.
25+
{product-title} defaults to using the CSI plugin to provision GCP PD storage.
3326
====
3427

3528
include::modules/persistent-storage-csi-about.adoc[leveloffset=+1]

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

Lines changed: 4 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -6,21 +6,11 @@ include::_attributes/common-attributes.adoc[]
66

77
toc::[]
88

9-
In-tree storage drivers that are traditionally shipped with {product-title} are being deprecated and replaced by their equivalent Container Storage Interface (CSI) drivers. {product-title} provides automatic migration for certain supported in-tree volume plugins to their equivalent CSI drivers.
9+
In-tree storage drivers that are traditionally shipped with {product-title} are being deprecated and replaced by their equivalent Container Storage Interface (CSI) drivers. {product-title} provides automatic migration for in-tree volume plugins to their equivalent CSI drivers.
1010

1111
include::modules/persistent-storage-csi-migration-overview.adoc[leveloffset=+1]
12+
include::modules/persistent-storage-csi-migration-sc.adoc[leveloffset=+1]
1213

13-
[role="_additional-resources"]
14-
.Additional resources
15-
* xref:../../storage/container_storage_interface/persistent-storage-csi-migration.adoc#persistent-storage-csi-migration-automatic-ga_persistent-storage-csi-migration[Automatic migration of in-tree volumes to CSI]
14+
To change the default storage class, see xref:../../storage/container_storage_interface/persistent-storage-csi-sc-manage.adoc#change-default-storage-class_persistent-storage-csi-sc-manage[Changing the default storage class].
1615

17-
* xref:../../storage/container_storage_interface/persistent-storage-csi-migration.adoc#persistent-storage-csi-migration-enable_persistent-storage-csi-migration[Manually enabling CSI automatic migration]
18-
19-
include::modules/persistent-storage-csi-migration-automatic-ga.adoc[leveloffset=+1]
20-
21-
include::modules/persistent-storage-csi-migration-enable.adoc[leveloffset=+1]
22-
23-
[role="_additional-resources"]
24-
.Additional resources
25-
26-
* xref:../../nodes/clusters/nodes-cluster-enabling-features.adoc#nodes-cluster-enabling[Enabling features using feature gates]
16+
include::modules/persistent-storage-csi-migration-vsphere.adoc[leveloffset=+1]

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

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -24,9 +24,13 @@ To create CSI-provisioned persistent volumes (PVs) that mount to vSphere storage
2424

2525
[IMPORTANT]
2626
====
27-
{product-title} defaults to using an in-tree (non-CSI) plugin to provision vSphere storage.
27+
For vSphere:
2828
29-
In future {product-title} versions, volumes provisioned using existing in-tree plugins 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].
29+
* For new installations of {product-title} 4.13, or later, automatic migration is enabled by default.
30+
+
31+
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].
32+
33+
* When upgrading from {product-title} 4.12, or earlier, to 4.13, automatic CSI migration for vSphere only occurs if you opt in. If you do not opt in, {product-title} defaults to using the in-tree (non-CSI) plugin to provision vSphere storage. xref:../../storage/container_storage_interface/persistent-storage-csi-migration.adoc#upgrading-openshift-container-platform[Carefully review the indicated consequences before opting in to migration].
3034
3135
After full migration, in-tree plugins will eventually be removed in future versions of {product-title}.
3236
====

0 commit comments

Comments
 (0)