Kubit

Kubit helps you manage multiple kubernetes configs on the same machine, it works similar to the wd utility in Zsh. With kubit add you can couple a simple label to the location of a kubeconfig file and kubit use will set the KUBECONFIG environment variable to the correct value.

Usage

• Add an entry

$ kubit add development ~/Projects/dev/kubeconfig

• List all entries

$ kubit list

• use an entry

$ kubit use development

This will output environment variable export statements to configure your environment for the given entry. You can eval the output of this command to apply the variables or apply them directly by executing kubit through its shell wrapper (see installation docs below)

• Remove an entry

$ kubit rm development

• Show currently configured entry

$ kubit current

• print usage with no opts or the help subcommand

$ kubit help

Installation

Kubit needs a Java 8 JRE (or higher) for running and a Java 8 JDK (or higher) for building from source.

From source

Clone the git repository and build with the following command

$ ./gradlew installDist

This will install the necessary files into build/install/kubit. Add the binary to your path by adding the following line to your .zshrc or .bashrc

export PATH=$PATH:/path/to/kubit_source/build/install/kubit/bin

Enabling automatic export of variables when using kubit use

To automatically export the new environment variables when using kubit use you need to run kubit with its shell wrapper. You can add this line to your .zshrc or .bashrc

eval "$(kubit init)"

As an alternative to improve startup time of your shell you can also run kubit init once in your shell and copy the output into your .zshrc/.bashrc

TODO

• kubit clean
• add binary distribution zip to Github
• finish docs
• shell autocompletion
• unify error handling

Inspiration

Kubit is inspired by the following projects

• wd https://github.com/mfaerevaag/wd