This topic describes the CLI commands for Kompass Storage EZswitch.
All EZswitch commands are invoked via the CLI plugin:
kubectl zesty ezswitch <command> <stsName> [flags]
The following tables describe the commands, flags, and descriptions.
start
Starts the migration process, installing EZswitch components (including the Helm chart if not already installed) and creating the EZswitch CR. By default, all ezswitch resources will be on the zesty-ezswitch namespace
Flag | Default | Description |
| true | Run process automatically to completion if true. |
| default | Namespace of the original STS. |
| (none) | Override Helm chart values during installation. |
| 4 | Set the log level of ezswitch-controller. |
| <stsName>-zesty | Name of the new Zesty-based STS. |
| zesty-ezswitch | Namespace where ezswitch resources will be created |
Example:
kubectl zesty ezswitch start myapp-sts --autoMigrate=false --helm-namespace=custom-namespace --set logLevel=4
migrate
Resumes the migration if previously halted at ReadyForMigration.
Flag | Default | Description |
| default | Namespace of the original STS. |
Example:
kubectl zesty ezswitch migrate myapp-sts
pause
Pauses the ongoing migration.
Flag | Default | Description |
| default | Namespace of the original STS. |
Example:
kubectl zesty ezswitch pause myapp-sts
resume
Resumes a previously paused migration.
Flag | Default | Description |
| default | Namespace of the original StatefulSet. |
Example:
kubectl zesty ezswitch resume myapp-sts
abort
Aborts the current process before significantly impacting the original StatefulSet and cleans up created resources.
Flag | Default | Description |
| default | Namespace of the original STS. |
Example:
kubectl zesty ezswitch abort myapp-sts
rollback
Attempts to revert to the original state if changes to the StatefulSet have begun. This option is especially relevant at or after the ReadyForMigration phase.
The EZswitch resource from which the migration started must still exist.
The original StatefulSet and its PVCs must still exist.
Flag | Default | Description |
| default | Namespace of the original STS. |
Example:
kubectl zesty ezswitch rollback myapp-sts
status
Displays the current migration status, including phase and sync progress.
Flag | Default | Description |
| default | Namespace of the original STS. |
Example:
kubectl zesty ezswitch status myapp-sts
For a description of the statuses, see Migration statuses
set
Modifies attributes of the EZswitch CR.
Flag | Default | Description |
| true | Updates autoMigrate field. |
| -1 | Updates transferRateLimits field (-1 will unset its value, that is, no limit). |
Example:
To Disable automatic migration
kubectl zesty ezswitch set myapp-sts --autoMigrate=false
cleanup
Removes the EZswitch CR.
Flag | Default | Description |
| zesty-ezswitch | Namespace of the original STS. |
| false | Deletes the old StatefulSet on cleanup. |
| false | Forces abort of all EZswitch resources before cleanup. |
| false | Keeps EZswitch resources instead of deleting them. |
| default | Namespace of the original STS. |
Example:
kubectl zesty ezswitch cleanup <stsName> [flags]