Skip to content

Commit 0742fd4

Browse files
committed
Update Readme
1 parent a668683 commit 0742fd4

File tree

1 file changed

+22
-21
lines changed

1 file changed

+22
-21
lines changed

README.md

Lines changed: 22 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -13,47 +13,48 @@ Given a config similar to [config.sample.yaml](./config.sample.yaml), `kube-tmux
1313
* kube config (Kubernetes context) for each Kubernetes cluster under `~/.kube/configs`
1414
* `tmuxp` config for each Kubernetes cluster under `~/.tmuxp`
1515

16-
The generated `tmuxp` configs are used to start preconfigured `tmux` sessions.
16+
The generated `tmuxp` configs can be used to start preconfigured `tmux` sessions.
1717

18-
## How to use?
19-
20-
### Prerequisites
18+
## Prerequisites
2119

2220
* [gcloud](https://cloud.google.com/sdk/)
2321
* [kubectl](https://kubernetes.io/docs/tasks/tools/install-kubectl/)
2422
* [tmux](https://github.com/tmux/tmux)
2523
* [tmuxp](https://github.com/tmux-python/tmuxp)
2624

27-
### Generate kube configs and `tmuxp` configs
25+
## Install
2826

29-
* Clone the repo
27+
### Homebrew
3028

31-
```
32-
git clone https://github.com/arunvelsriram/kube-tmuxp.git
33-
```
29+
To be updated
3430

35-
* Setup `virtualenv`
31+
### Manual
3632

37-
```
38-
virtualenv --python=python3.6 venv
39-
source venv/bin/activate
40-
pip install -r requirements.txt
41-
```
33+
```
34+
git clone https://github.com/arunvelsriram/kube-tmuxp.git
35+
cd kube-tmuxp
36+
make build
37+
cp ./out/kube-tmuxp /usr/local/bin/kube-tmuxp
38+
```
39+
40+
## Generate kubeconfigs and `tmuxp` configs
4241

4342
* Copy the sample config ([config.sample.yaml](./config.sample.yaml))
4443

4544
```
46-
cp config.sample.yaml config.yaml
45+
cp config.sample.yaml ~/.kube-tmuxp.yaml
4746
```
4847

49-
* Add your clusters to the copied config
50-
* Generate kube configs and tmuxp configs
48+
* Add your projects and clusters to the copied config
49+
* Generate kubeconfigs and tmuxp configs
5150

5251
```
53-
python kube_tmuxp.py config.yaml
52+
kube-tmuxp gen
5453
```
5554

56-
### Start a session
55+
Default config path is `$HOME/.kube-tmuxp.yaml`. If you are using a different path, then use the `--config` flag to specify that path. Refer `kube-tmuxp --help` for more details.
56+
57+
## Start a session
5758

5859
```
5960
tmuxp load my-context-name
@@ -63,4 +64,4 @@ Now you will be inside a `tmux` session preconfigured with Kubernetes context `m
6364

6465
## Limitations
6566

66-
* Generates kube configs for Kubernetes clusters (GKE) on Google Cloud Platform (GCP) only
67+
* Currently works for Google Kubernetes Engine (GKE) only. However, it can be extended to work with any Kubernetes clusters. Feel free to submit a PR for this.

0 commit comments

Comments
 (0)