kowen-rh / manyshift

A POSIX-compliant shell script to install, manage, and run multiple versions of Minishift.

Manyshift

Manyshift is a POSIX-compliant shell script designed to allow you to easily install, manage, and run multiple versions of Minishift.

• Installing Manyshift
  • On GNU/Linux
• Using Manyshift
  • Installing versions
  • Setting the active version
  • Displaying the active version
  • Listing installed versions
  • Removing installed versions
• Contributing to Manyshift
  • License

Installing Manyshift

Note	Manyshift is a portable, POSIX-compliant shell script. The included manyshift script should run in any POSIX-compliant shell. Manyshift has been developed and tested on Fedora GNU/Linux.

On GNU/Linux

1. Download the latest version of Manyshift.

2. Place manyshift in your $PATH. The ~/bin directory is recommended.

3. Add ~/.manyshift/bin to your $PATH. In Bash, run the following command to add ~/.manyshift/bin to your $PATH:

   $ echo 'export PATH="$HOME/.manyshift/bin:$PATH"' >> ~/.bashrc

4. Start a new shell instance.

Using Manyshift

Installing versions

Use the manyshift add command to install the given versions of Minishift. You may supply multiple versions as arguments to the manyshift add command.

Note	The add command includes access to the latest version string. Using the latest version string will automatically download and install the most recent release of Minishift. This is the only command that includes the latest version string.

Example:

$ manyshift add latest 1.25.0 1.13.0

Note	The manyshift add command is also aliased as manyshift install.

Setting the active version

The active Minishift version used by Manyshift may be set with the manyshift use command. The manyshift use command expects to be given the desired version string as an argument.

Example:

$ manyshift use 1.26.1

You may clear the active version by using the manyshift use command without arguments.

Example:

$ manyshift use

Important

The manyshift use command does not manage Minishift profiles. Use the minishift profile set command to ensure that there are no conflicts between profiles and Minishift versions. Including the version number in the profile name is recommended. Example: $ manyshift use 1.26.1 $ minishift profile set minishift-1-26-1

Note	The manyshift use command is also aliased as manyshift set.

Displaying the active version

Use the manyshift which command to display which version is currently active.

Example:

$ manyshift which
1.26.1

Note	The manyshift which command is also aliased as manyshift active and manyshift current.

Listing installed versions

Use the manyshift ls command to list the currently installed Minishift versions managed by Manyshift. The currently active version is displayed as “(active)”.

Example:

$ manyshift ls
1.13.0
1.25.0
1.26.1 (active)

Note	The manyshift ls command is also aliased as manyshift list and manyshift versions.

Removing installed versions

Minishift versions managed by Manyshift can be removed with the manyshift rm command. You may supply multiple versions as arguments to the manyshift rm command.

Example:

$ manyshift rm 1.13.0 1.25.0

Important

Removing the currently active version will remove the active version setting. You will need to run the manyshift use command to set a new active version. Removing a Minishift version does not remove the profiles or virtual machines associated with that Minishift version. Ensure that you have removed these artifacts via Minishift before running the manyshift rm command. Example: $ manyshift which 1.26.1 $ for profile in $(minishift profile list | awk '{ print $2 }') ; do minishift profile delete "$profile" done $ manyshift rm 1.26.1

Note	The manyshift rm command is also aliased as manyshift remove and manyshift uninstall.

Contributing to Manyshift

License

Manyshift is made available under the terms of the MIT Expat license. See the included LICENSE file for more information.