254 lines
8.9 KiB
Markdown
254 lines
8.9 KiB
Markdown
|
# `kubectx` + `kubens`: Power tools for kubectl
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
This repository provides both `kubectx` and `kubens` tools.
|
|||
|
|
[Install →](#installation)
|
|||
|
|
|
|||
|
|
|
|||
|
|
**`kubectx`** helps you switch between clusters back and forth:
|
|||
|
|
|
|||
|
|
|
|||
|
|
**`kubens`** helps you switch between Kubernetes namespaces smoothly:
|
|||
|
|
|
|||
|
|
|
|||
|
|
# kubectx(1)
|
|||
|
|
|
|||
|
|
kubectx is a utility to manage and switch between kubectl(1) contexts.
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
USAGE:
|
|||
|
|
kubectx : list the contexts
|
|||
|
|
kubectx <NAME> : switch to context <NAME>
|
|||
|
|
kubectx - : switch to the previous context
|
|||
|
|
kubectx -c, --current : show the current context name
|
|||
|
|
kubectx <NEW_NAME>=<NAME> : rename context <NAME> to <NEW_NAME>
|
|||
|
|
kubectx <NEW_NAME>=. : rename current-context to <NEW_NAME>
|
|||
|
|
kubectx -d <NAME> : delete context <NAME> ('.' for current-context)
|
|||
|
|
(this command won't delete the user/cluster entry
|
|||
|
|
that is used by the context)
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### Usage
|
|||
|
|
|
|||
|
|
```sh
|
|||
|
|
$ kubectx minikube
|
|||
|
|
Switched to context "minikube".
|
|||
|
|
|
|||
|
|
$ kubectx -
|
|||
|
|
Switched to context "oregon".
|
|||
|
|
|
|||
|
|
$ kubectx -
|
|||
|
|
Switched to context "minikube".
|
|||
|
|
|
|||
|
|
$ kubectx dublin=gke_ahmetb_europe-west1-b_dublin
|
|||
|
|
Context "dublin" set.
|
|||
|
|
Aliased "gke_ahmetb_europe-west1-b_dublin" as "dublin".
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
`kubectx` supports <kbd>Tab</kbd> completion on bash/zsh/fish shells to help with
|
|||
|
|
long context names. You don't have to remember full context names anymore.
|
|||
|
|
|
|||
|
|
-----
|
|||
|
|
|
|||
|
|
# kubens(1)
|
|||
|
|
|
|||
|
|
kubens is a utility to switch between Kubernetes namespaces.
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
USAGE:
|
|||
|
|
kubens : list the namespaces
|
|||
|
|
kubens <NAME> : change the active namespace
|
|||
|
|
kubens - : switch to the previous namespace
|
|||
|
|
kubens -c, --current : show the current namespace
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
### Usage
|
|||
|
|
|
|||
|
|
```sh
|
|||
|
|
$ kubens kube-system
|
|||
|
|
Context "test" set.
|
|||
|
|
Active namespace is "kube-system".
|
|||
|
|
|
|||
|
|
$ kubens -
|
|||
|
|
Context "test" set.
|
|||
|
|
Active namespace is "default".
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
`kubens` also supports <kbd>Tab</kbd> completion on bash/zsh/fish shells.
|
|||
|
|
|
|||
|
|
-----
|
|||
|
|
|
|||
|
|
## Installation
|
|||
|
|
|
|||
|
|
There are several installation options:
|
|||
|
|
|
|||
|
|
- As kubectl plugins (macOS/Linux)
|
|||
|
|
- macOS
|
|||
|
|
- Homebrew (recommended)
|
|||
|
|
- MacPorts
|
|||
|
|
- Linux
|
|||
|
|
- manual installation/upgrades
|
|||
|
|
- Arch Linux
|
|||
|
|
- Debian/Ubuntu
|
|||
|
|
|
|||
|
|
### Kubectl Plugins (macOS and Linux)
|
|||
|
|
|
|||
|
|
You can install and use [Krew](https://github.com/kubernetes-sigs/krew/) kubectl
|
|||
|
|
plugin manager to get `kubectx` and `kubens`. **NOTE:** This will not install
|
|||
|
|
shell completion scripts, if you want those, choose another installation method
|
|||
|
|
below.
|
|||
|
|
|
|||
|
|
```sh
|
|||
|
|
kubectl krew install ctx
|
|||
|
|
kubectl krew install ns
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
After installing, the tools will be available as `kubectl ctx` and `kubectl ns`.
|
|||
|
|
|
|||
|
|
### macOS
|
|||
|
|
|
|||
|
|
#### Homebrew
|
|||
|
|
|
|||
|
|
:confetti_ball: If you use [Homebrew](https://brew.sh/) you can install like this:
|
|||
|
|
|
|||
|
|
brew install kubectx
|
|||
|
|
|
|||
|
|
This command will set up bash/zsh/fish completion scripts automatically.
|
|||
|
|
|
|||
|
|
- If you like to add context/namespace info to your shell prompt (`$PS1`),
|
|||
|
|
I recommend trying out [kube-ps1](https://github.com/jonmosco/kube-ps1).
|
|||
|
|
|
|||
|
|
#### MacPorts
|
|||
|
|
|
|||
|
|
If you use [MacPorts](https://www.macports.org) you can install like this:
|
|||
|
|
|
|||
|
|
sudo port install kubectx
|
|||
|
|
|
|||
|
|
### Linux
|
|||
|
|
|
|||
|
|
Since `kubectx`/`kubens` are written in Bash, you should be able to install
|
|||
|
|
them to any POSIX environment that has Bash installed.
|
|||
|
|
|
|||
|
|
- Download the `kubectx`, and `kubens` scripts.
|
|||
|
|
- Either:
|
|||
|
|
- save them all to somewhere in your `PATH`,
|
|||
|
|
- or save them to a directory, then create symlinks to `kubectx`/`kubens` from
|
|||
|
|
somewhere in your `PATH`, like `/usr/local/bin`
|
|||
|
|
- Make `kubectx` and `kubens` executable (`chmod +x ...`)
|
|||
|
|
- Install bash/zsh/fish [completion scripts](completion/).
|
|||
|
|
- For zsh:
|
|||
|
|
The completion scripts have to be in a path that belongs to `$fpath`. Either link or copy them to an existing folder.
|
|||
|
|
If using oh-my-zsh you can do as follows:
|
|||
|
|
```bash
|
|||
|
|
mkdir -p ~/.oh-my-zsh/completions
|
|||
|
|
chmod -R 755 ~/.oh-my-zsh/completions
|
|||
|
|
ln -s /opt/kubectx/completion/kubectx.zsh ~/.oh-my-zsh/completions/_kubectx.zsh
|
|||
|
|
ln -s /opt/kubectx/completion/kubens.zsh ~/.oh-my-zsh/completions/_kubens.zsh
|
|||
|
|
```
|
|||
|
|
Note that the leading underscore seems to be a convention. If completion doesn't work, add `autoload -U compinit && compinit` to your `.zshrc` (similar to [`zsh-completions`](https://github.com/zsh-users/zsh-completions/blob/master/README.md#oh-my-zsh)).
|
|||
|
|
If not using oh-my-zsh, you could link to `/usr/share/zsh/functions/Completion` (might require sudo), depending on the `$fpath` of your zsh installation.
|
|||
|
|
In case of error, calling `compaudit` might help.
|
|||
|
|
- For bash:
|
|||
|
|
```bash
|
|||
|
|
git clone https://github.com/ahmetb/kubectx.git ~/.kubectx
|
|||
|
|
COMPDIR=$(pkg-config --variable=completionsdir bash-completion)
|
|||
|
|
ln -sf ~/.kubectx/completion/kubens.bash $COMPDIR/kubens
|
|||
|
|
ln -sf ~/.kubectx/completion/kubectx.bash $COMPDIR/kubectx
|
|||
|
|
cat << FOE >> ~/.bashrc
|
|||
|
|
|
|||
|
|
|
|||
|
|
#kubectx and kubens
|
|||
|
|
export PATH=~/.kubectx:\$PATH
|
|||
|
|
FOE
|
|||
|
|
```
|
|||
|
|
- For fish:
|
|||
|
|
```fish
|
|||
|
|
mkdir -p ~/.config/fish/completions
|
|||
|
|
ln -s /opt/kubectx/completion/kubectx.fish ~/.config/fish/completions/
|
|||
|
|
ln -s /opt/kubectx/completion/kubens.fish ~/.config/fish/completions/
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Example installation steps:
|
|||
|
|
|
|||
|
|
``` bash
|
|||
|
|
sudo git clone https://github.com/ahmetb/kubectx /opt/kubectx
|
|||
|
|
sudo ln -s /opt/kubectx/kubectx /usr/local/bin/kubectx
|
|||
|
|
sudo ln -s /opt/kubectx/kubens /usr/local/bin/kubens
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
#### Arch Linux
|
|||
|
|
|
|||
|
|
Available as official Arch Linux package. Install it via:
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
sudo pacman -S kubectx
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
#### Debian/Ubuntu
|
|||
|
|
|
|||
|
|
Available as a Debian package for [Debian Buster (testing)](https://packages.debian.org/buster/kubectx), [Sid (unstable)](https://packages.debian.org/sid/kubectx) (_note: if you are unfamiliar with Debian release process and how to enable testing/unstable repos, check the [Debian Wiki](https://wiki.debian.org/DebianReleases)_):
|
|||
|
|
|
|||
|
|
``` bash
|
|||
|
|
sudo apt install kubectx
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
-----
|
|||
|
|
|
|||
|
|
### Interactive mode
|
|||
|
|
|
|||
|
|
If you want `kubectx` and `kubens` commands to present you an interactive menu
|
|||
|
|
with fuzzy searching, you just need to [install
|
|||
|
|
`fzf`](https://github.com/junegunn/fzf) in your PATH.
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
If you have `fzf` installed, but want to opt out of using this feature, set the environment variable `KUBECTX_IGNORE_FZF=1`.
|
|||
|
|
|
|||
|
|
|
|||
|
|
-----
|
|||
|
|
|
|||
|
|
### Customizing colors
|
|||
|
|
|
|||
|
|
If you like to customize the colors indicating the current namespace or context, set the environment variables `KUBECTX_CURRENT_FGCOLOR` and `KUBECTX_CURRENT_BGCOLOR` (refer color codes [here](https://linux.101hacks.com/ps1-examples/prompt-color-using-tput/)):
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
export KUBECTX_CURRENT_FGCOLOR=$(tput setaf 6) # blue text
|
|||
|
|
export KUBECTX_CURRENT_BGCOLOR=$(tput setab 7) # white background
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Colors in the output can be disabled by setting the
|
|||
|
|
[`NO_COLOR`](http://no-color.org/) environment variable.
|
|||
|
|
|
|||
|
|
-----
|
|||
|
|
|
|||
|
|
#### Users
|
|||
|
|
|
|||
|
|
| What are others saying about kubectx? |
|
|||
|
|
| ---- |
|
|||
|
|
| _“Thank you for kubectx & kubens - I use them all the time & have them in my k8s toolset to maintain happiness :) ”_ – [@pbouwer](https://twitter.com/pbouwer/status/925896377929949184) |
|
|||
|
|
| _“I can't imagine working without kubectx and especially kubens anymore. It's pure gold.”_ – [@timoreimann](https://twitter.com/timoreimann/status/925801946757419008) |
|
|||
|
|
| _“I'm liking kubectx from @ahmetb, makes it super-easy to switch #Kubernetes contexts [...]”_ — [@lizrice](https://twitter.com/lizrice/status/928556415517589505) |
|
|||
|
|
| _“Also using it on a daily basis. This and my zsh config that shows me the current k8s context 😉”_ – [@puja108](https://twitter.com/puja108/status/928742521139810305) |
|
|||
|
|
| _“Lately I've found myself using the kubens command more than kubectx. Both very useful though :-)”_ – [@stuartleeks](https://twitter.com/stuartleeks/status/928562850464907264) |
|
|||
|
|
| _“yeah kubens rocks!”_ – [@embano1](https://twitter.com/embano1/status/928698440732815360) |
|
|||
|
|
| _“Special thanks to Ahmet Alp Balkan for creating kubectx, kubens, and kubectl aliases, as these tools made my life better.”_ – [@strebeld](https://medium.com/@strebeld/5-ways-to-enhance-kubectl-ux-97c8893227a) |
|
|||
|
|
| _“❤️ this shell script @ahmetb wrote to help make switching between kubectl config contexts a breeze.”_ – [@briandanowski](https://twitter.com/briandanowski/status/1085409568165896193) |
|
|||
|
|
|
|||
|
|
> If you liked `kubectx`, you may like my [`kubectl-aliases`](https://github.com/ahmetb/kubectl-aliases) project, too.
|
|||
|
|
|
|||
|
|
-----
|
|||
|
|
|
|||
|
|
Disclaimer: This is not an official Google product.
|
|||
|
|
|
|||
|
|
|
|||
|
|
#### Stargazers over time
|
|||
|
|
|
|||
|
|
[](https://starcharts.herokuapp.com/ahmetb/kubectx)
|
|||
|
|
|