Kubeswap

Tool to manage multiple kubeconfig files and swap between clusters easily

Why kubeswap

If you interact with a lot of kubernetes clusters/contexts, and you dont want to manage it in a big single kubeconfig file (merging kubeconfigs is tedious...), this is the right tool for you!

Just throw your kubeconfig files inside $HOME/.kube/, and kubeswap will manage it for you.

Basic usage

Basically, you will use 2 commands:

kubeswap: scans your $HOME/.kube dir and shows you a pretty interactive list to choose the desired kubeconfig
kubeswap <name>: directly select the kubeconfig with that name from your $HOME/.kube/ dir
Extra: kubeswap none will remove the current kubeconfig.

Advanced usage

Besides the basic usage, kubeswap has a key-value store, so you can:

Add/delete kubeconfigs to/from the db
List the kubeconfigs stored
Select one to use
Much more... (not really)

I have implemented the store with 2 objectives:

Portability: you can use this db to store all your kubeconfigs and carry them with you
Backup/Restore: you can use the db to backup/restore the kubeconfigs

To use the store, check the help :)

Help

  ██   ██ ██    ██ ██████  ███████ ███████ ██     ██  █████  ██████  
  ██  ██  ██    ██ ██   ██ ██      ██      ██     ██ ██   ██ ██   ██ 
  █████   ██    ██ ██████  █████   ███████ ██  █  ██ ███████ ██████  
  ██  ██  ██    ██ ██   ██ ██           ██ ██ ███ ██ ██   ██ ██      
  ██   ██  ██████  ██████  ███████ ███████  ███ ███  ██   ██ ██

Manage your kubeconfig files easily

Usage:
  kubeswap [flags]
  kubeswap [command]

Available Commands:
  add         Adds a new kubeconfig to the database
  completion  Generate the autocompletion script for the specified shell
  delete      Deletes a kubeconfig from the database
  help        Help about any command
  list        Lists all the kubeconfigs in the db
  print       Prints the content of the kubeconfig referenced by <name>
  printall    Prints the content of all the kubeconfigs from the db
  sync        Removes the current db file and recreates it with all the $HOME/.kube kubeconfigs
  use         Select kubeconfig to use
  version     Print the version number

Flags:
      --db string         db path (default "$HOME/.kube/kubeswap.db")
  -h, --help              help for kubeswap
      --loglevel string   loglevel (info/debug) (default "info")

Use "kubeswap [command] --help" for more information about a command.

Tips

Use some shell/program that shows you your current k8s cluster/context.

Quickstart

Basic (without store):

Interactive list:

kubeswap

Select one kubeconfig from your $HOME/.kube/ directory:

kubeswap <filename>

Advanced (with store):

add:

kubeswap add --name test --kubeconfig test/kubeconfig.yml --db /tmp/kubeswap.db

list:

kubeswap list --db /tmp/kubeswap.db

print:

kubeswap print -n test --db /tmp/kubeswap.db

printall:

kubeswap printall --db /tmp/kubeswap.db

use:

kubeswap use -n test --db /tmp/kubeswap.db

delete:

kubeswap delete -n test --db /tmp/kubeswap.db

TODO

If the file to check is a folder just skip it
Test in windows & mac
status command:
- status: checks if the clusters referenced by each kubeconfig are reachable
  - -n <name>: checks if the cluster of <name> kubeconfig is reachable
Compress the db into a single file, to enable
- simplicity: the user has a single file with all the database, not a directory
- backup/restore: easier to backup, restore or move between machines
Refine the TUI list to show only the important stuff (remove '?' option for example)
Cleanup! like a lot...
Performance (we can just copy files if we know the name, not creating a kubeconfig.Kubeconfig etc etc...)

ebarped / kubeswap