diff --git a/README.md b/README.md index 3c0afdb..71daa88 100644 --- a/README.md +++ b/README.md @@ -19,9 +19,9 @@ You can now use kubectl tmux-exec -l app=nginx /bin/bash ``` -# Installation +## Installation -## via Homebrew +### Homebrew > **Note**: This is for Mac users only. @@ -31,7 +31,7 @@ kubectl tmux-exec -l app=nginx /bin/bash The script should be installed under `/usr/local/bin/kubectl-tmux_exec` by default. Please ensure the `bin` directory is in your `$PATH` environment variable. -## via Krew +### Krew > **Note**: It is recommended for Linux users. > @@ -43,7 +43,7 @@ The script should be installed under `/usr/local/bin/kubectl-tmux_exec` by defau 3. Install the dependencies. ([Wiki: How-to-Install-Dependencies](https://github.com/predatorray/kubectl-tmux-exec/wiki/How-to-Install-Dependencies)) -## Manually +### Manually 1. Download the [latest release](https://github.com/predatorray/kubectl-tmux-exec/releases/latest). @@ -53,11 +53,11 @@ The script should be installed under `/usr/local/bin/kubectl-tmux_exec` by defau 4. Install the dependencies. ([Wiki: How-to-Install-Dependencies](https://github.com/predatorray/kubectl-tmux-exec/wiki/How-to-Install-Dependencies)) -# Usage +## Usage -To execute this script as a [plugin]((https://kubernetes.io/docs/tasks/extend-kubectl/kubectl-plugins/)), a `kubectl` version prior to `1.12.0` is required and the latest version is preferred. But you can execute the script directly like `kubectl-tmux_exec [...ARGS]` if it is not supported. +To execute this script as a [plugin]((https://kubernetes.io/docs/tasks/extend-kubectl/kubectl-plugins/)), a `kubectl` version prior to `1.12.0` is required and the latest version is preferred. Alternatively, you can also execute the script directly like `kubectl-tmux_exec [...ARGS]` if it is not supported. -If it is supported, you can check if the script has been added to kubectl's plugin list by +By executing the command below, you can check if the script has been successfully added. ```sh kubectl plugin list @@ -77,15 +77,12 @@ You can use the command below to get the usage of the script. ```sh kubectl tmux-exec --help -``` - -Or, execute it directly. -``` +# or kubectl-tmux_exec --help ``` -## Options +### Options Flag | Usage --- | --- @@ -106,7 +103,7 @@ Flag | Usage The usage of these options is also available by `--help`. -## Example +### Example The `tmux-exec` is similar to `exec`, except that it requires label selectors while `exec` requires a pod name. @@ -120,7 +117,7 @@ After you have successfully `bash`-ed into your selected containers, a Tmux wind If you are not familar with Tmux, you can have a look at tmux's man page or online tutorials. Or you can see the [cheatsheet](#tmux-cheatsheet) below, which will be sufficient I think. -## iTerm2 Integration +### iTerm2 Integration Since [iTerm2](https://iterm2.com/index.html) has been [integrated with tmux](https://iterm2.com/documentation-tmux-integration.html), we can have a better native user interface, instead of remembering all the shortcuts. @@ -138,7 +135,7 @@ will result in something like the screenshot below. Note that, the `synchronize-panes` will be disabled automatically in this mode, since the iTerm2 provides a much easier way to achieve this. To turn this on, press + + i, or click *"Shell"* - *"Broadcast Input"* - *"Broadcast Input to All Panes in Current Tab"* in the menu bar. -## Tmux Cheatsheet +### Tmux Cheatsheet All Tmux command starts with a `PREFIX`. By default the `PREFIX` is Ctrl + b. I will use `C-b` below to stand for it. @@ -154,6 +151,8 @@ All Tmux command starts with a `PREFIX`. By default the `PREFIX` is Ctrl