konf-sh

konf-sh - the KubeConfig manager for your shell

⚠️ This repo is under active development 🏗

• Why yet another k8s tool?
• Description
• Install & configure
  • 1. Install binary
  • 2. Install shell wrapper
  • 3. Install autocompletion
  • 4. Advised customisations
• Usage
• Commands
• Some tech details
  • Flags
  • Environment variables
  • Error codes
• Roadmap
• Codebase
  • Build
  • Test

Why yet another k8s tool?

This project was inspired by kubectx+kubens, but that tool doesn't offer 2 must-to-have (in my opinion) features:

• set k8s context just for current shell
• manage k8s configuration file ~/.kube/config

Description

konf makes easier to manage, maintain and use Kubernetes configuration (a.k.a. ~/.kube/config).

konf offers following cool features:

• split k8s configuration into multiple k8s config separate files (one per context)
• list available single k8s config files
• set k8s context for current shell only
• set global k8s context
• view k8s context for current shell
• view global k8s context
• rename k8s context
• delete a specific k8s context
• reset k8s context to default
• cli autocompletion

Install and configure

1. Install binary

⚠️ PLEASE NOTE: A more automated installation process is under development

1. Download compressed binary from the release page
2. Extract binary wherever you prefer
3. Add binary to your PATH

2. Install shell wrapper

⚠️ PLEASE NOTE: Shell wrapper won't work if binary is not in PATH

zsh

Add the following to your .zshrc and restart the shell:

source <(konf-sh shellwrapper zsh)

bash

Add the following to your .bashrc and restart the shell:

source <(konf-sh shellwrapper bash)

3. Install autocompletion

⚠️ PLEASE NOTE: Autocompletion won't work if shell wrapper is not installed

Current supported shells: zsh, bash

zsh

Add the following to your .zshrc and restart the shell:

source <(konf completion zsh)

bash

Add the following to your .bashrc and restart the shell:

source <(konf completion bash)

4. Advised customisations

Here following some optional customisations to make your life even easier.

Aliases

⚠️ PLEASE NOTE: Aliases won't work if shell wrapper is not installed

Add the following to your .zshrc or .bashrc and restart the shell:

alias kctx="konf set"
alias kns="konf ns"

Usage

1. Split k8s config

First we have to split your Kubernetes config into multiple single Kubernetes konfigs

konf split

If we don't do this, no other command will have any effect.

2. List all available k8s konfigs

Let's list all available k8s konfigs to select the right k8s ctx we want to set

konf list

3. Set a global k8s ctx

We set our k8s ctx as global

konf set global <context>

4. Set a local k8s ctx

We open another terminal because we need access to different k8s ctx, then we execute

konf set local <context>

This will point our kubectl to the selected k8s ctx, but ONLY IN THE CURRENT SHELL! Amazing don't you think?

5. View our settings

Still from the second terminal window, we want to review our current settings

konf view

Commands

Split

konf split separates the Kubernetes configuration (by default ~/.kube/config) into single Kubernetes konfigurations (by default in ~/.kube/konfigs), one for each context.

⚠️ PLEASE NOTE: Almost all other commands don't work if split was not previously executed

List

konf list lists all Kubernetes context available in the Kubernetes configuration (by default ~/.kube/config) and in single Kubernetes konfigurations (by default in ~/.kube/konfigs).

Set

konf set local <context> sets the local (current shell) Kubernetes context (setting KUBECONFIG environment variable) to the specified one (by default ~/.kube/konfigs).

konf set global <context> sets the global Kubernetes context (by default currentContext in ~/.kube/config) to the specified one (by default ~/.kube/konfigs).

konf set [local | global] - switches back the local or global Kubernetes context to the previous one.

View

konf view shows both local (current shell) and global Kubernetes context.

konf view local shows only the local (current shell) Kubernetes context.

konf view global shows only the global Kubernetes context.

Delete

konf delete <context-list> removes the specified comma-separated context list from both Kubernetes configuration (by default ~/.kube/config) and single Kubernetes konfigurations (by default in ~/.kube/konfigs).

Rename

konf rename <context-to-rename> <new-context-name> renames the specified context in both Kubernetes configuration (by default in ~/.kube/config) and single Kubernetes konfigurations (by default in ~/.kube/konfigs).

Reset

konf reset local resets the local (current shell) Kubernetes configuration (unsetting KUBECONFIG environment variable).

konf reset global resets global Kubernetes context to N/A (by default currentContext in ~/.kube/config).

Completion

konf completion [zsh | bash] outputs the autocompletion script for the selected shell.

Help

konf help shows the helper.

Version

konf version shows the version.

Some tech details

Flags

⚠️ PLEASE NOTE

All flags must be specified BEFORE arguments

This works: konf set global --kube-config ./examples/config context_b

This doesn't work: konf set global context_b --kube-config ./examples/config

Environment variables

⚠️ PLEASE NOTE: KONF_LOG_ENCODING and KONF_LOG_LEVEL are available only as environment variables

Error codes

Roadmap

See here.

Codebase

Build

git clone git@github.com:bygui86/konf-sh.git && cd konf-sh

make build

Test

🏗 work in progress

git clone git@github.com:bygui86/konf-sh.git && cd konf-sh

make test