USAGE.md

konfig

konfig helps to merge, split or import kubeconfig files

Usage

The following assumes that you have installed konfig via

kubectl krew install konfig

Import a kubeconfig

kubectl konfig import --save new-cfg

Imports the config file new-cfg into the default kubeconfig at ~/.kube/config. To show the result without changing your kubeconfig, do

kubectl konfig import new-cfg

CAVEAT: due to how shells work, the following will lose your current ~/.kube/config

# WRONG, don't do this!
kubectl konfig import new-cfg > ~/.kube/config

Merge several kubeconfig files

kubectl konfig merge config1 config2 > merged-config

This variant creates a self-contained kubeconfig where all credentials are stored inline in the kubeconfig. If you want to preserve the structure and keep credentials separate, use --preserve-structure.

Extract a minimal kubeconfig for one or several contexts

This will extract a minimal kubeconfig with a single context minikube:

# extract context minikube from the default kubeconfig
kubectl konfig export minikube > minikube.config

# extract context minikube and docker-for-desktop from two input configs
kubectl konfig export minikube docker-for-desktop -k ~/.kube/other,~/dockercfg > local