Skip to main content

Witboost Migration

This feature automatically transforms witboost configuration file (values.yaml) to make it ready for the target Witboost version you want to install. The transformation is accomplished by applying a sequence of migrations that are required by each version update.

warning

This CLI supports transformation of configuration files from a minimum Witboost Version 2.3.0 i.e. if your current Witboost deployment is older, you will need to manually migrate to version 2.3.0.

warning

This CLI supports transformation of stable releases only

Migration Workflow​

This command requires the CLI to be initialized (refer to the witboost init command). This step is very important because it needs to:

  • setup required credentials to communicate with the Witboost registry.
  • Initialize CLI configuration files and directory structure.

Initialize the CLI

./witboost-infra init --registry-username "foo" --registry-password "xyz"

Once the initialization is complete, initialized directory look similar to this.

~/.witboost-infra
├── config.yaml
├── output
├── rules
├── tool-config.yaml
└── values

Start the migration

With all the prerequisites in place, we can proceed with the migration, using the transform command. In the following example, we specify the version 2.3.1 as current and 2.3.2 as a target of the migration.

./witboost-infra transform --user-values user_values.yaml --current-version "2.3.1" --set-target "2.3.2"
info: Transform from version 2.3.1 to 2.3.2
info: Writing the transformed file to: /Users/jhob.doe/.witboost-infra/output/transformed_user_values.yaml

Configuration migration to version 2.3.2 has been successfully completed.

Command details can be referenced from transform detailed under Command-reference section.