Chapter 8. Storage migration using the Kube Storage Version Migrator
Storage version migration is used to update existing objects in the cluster from their current version to the latest version. The Kube Storage Version Migrator embedded controller is used in MicroShift to migrate resources without having to recreate those resources. Either you or a controller can create a StorageVersionMigration
custom resource (CR) that will request a migration through the Migrator Controller.
8.1. Making a storage migration request
Storage migration is the process of updating stored data to the latest storage version, for example from v1beta1
to v1beta2
. To update your storage version, use the following procedure.
Procedure
Either you or any controller that has support for the
StorageVersionMigration
API must trigger a migration request. Use the following example request for reference:Example request
apiVersion: migration.k8s.io/v1alpha1 kind: StorageVersionMigration metadata: name: snapshot-v1 spec: resource: group: snapshot.storage.k8s.io resource: volumesnapshotclasses 1 version: v1 2
-
The progress of the migration is posted to the
StorageVersionMigration
status.
- Failures can occur because of a misnamed group or resource.
- Migration failures can also occur when there is an incompatibility between the previous and latest versions.