Go to file
derailed 3ff2f64255 Merge branch 'logs'
+ Added better namespace handling when > 9 namespaces
+ Added fail fast panic if k8s config is toast
+ Added new command line args and sub commands
+ Revamped logs to show more info
+ Added filtering ability on list views
+ And Mo bug fixes (hopefully)...
+ Changed log location file to golang temp dir
+ Added K9s config file to persist defaults
2019-02-05 17:02:20 -07:00
.semaphore init drop 2019-01-25 11:53:08 -07:00
assets updates logging, fail fast and added namespace/search features 2019-02-05 17:01:58 -07:00
change_logs updates logging, fail fast and added namespace/search features 2019-02-05 17:01:58 -07:00
cmd updates logging, fail fast and added namespace/search features 2019-02-05 17:01:58 -07:00
resource updates logging, fail fast and added namespace/search features 2019-02-05 17:01:58 -07:00
test_assets updates logging, fail fast and added namespace/search features 2019-02-05 17:01:58 -07:00
vendor updates logging, fail fast and added namespace/search features 2019-02-05 17:01:58 -07:00
views updates logging, fail fast and added namespace/search features 2019-02-05 17:01:58 -07:00
.gitignore init drop 2019-01-25 11:53:08 -07:00
.goreleaser.yml update release meta 2019-02-01 18:03:54 -07:00
.travis.yml cleanup + tests check 2019-02-01 14:33:00 -07:00
CNAME cleanup + tests check 2019-02-01 14:33:00 -07:00
LICENSE init drop 2019-01-25 11:53:08 -07:00
Makefile init drop 2019-01-25 11:53:08 -07:00
README.md updates logging, fail fast and added namespace/search features 2019-02-05 17:01:58 -07:00
go.mod updates logging, fail fast and added namespace/search features 2019-02-05 17:01:58 -07:00
go.sum updates logging, fail fast and added namespace/search features 2019-02-05 17:01:58 -07:00
main.go updates logging, fail fast and added namespace/search features 2019-02-05 17:01:58 -07:00

README.md

K9s - Kubernetes CLI To Manage Your Clusters In Style!

K9s provides a curses based terminal UI to interact with your Kubernetes clusters. The aim of this project is to make it easier to navigate, observe and manage your applications. This command line app continually watches Kubernetes for changes and offers subsequent commands to interact with observed resources.



Go Report Card Build Status



Installation

Homebrew (OSX)

brew tap derailed/k9s && brew install k9s

Binary Releases



Command Line Options

  • --namespace(-n) change the default namespace
  • --refresh(-r) changes the default(2sec) refresh


PreFlight

  • K9s uses 256 colors terminal mode. On OSX make sure TERM is set accordingly.

    export TERM=xterm-256color
    



Commands

  • K9s uses 2 or 3 letters alias to navigate most K8s resource
  • At any time you can use ?<Enter> to look up the various commands
  • Use alias<Enter> to activate a resource under that alias
  • Ctrl sequences are used to view, edit, delete, ssh ...
  • Use ctx<Enter> to switch between clusters
  • Use Q or Ctrl-C to Quit.


Demo Video



Screen Shots

Pod View

Log View



Known Issues...

This initial drop is brittle. k9s will most likely blow up if...

  • Your kube-config file does not live under $HOME/.kube or you use multiple configs
  • You don't have enough RBAC fu to manage your cluster
  • Your cluster does not run a metrics-server


Disclaimer

This is still work in progress! If there is enough interest in the Kubernetes community, we will enhance per your recommendations/contributions. Also if you dig this effort, please let us know that too!



ATTA Girls/Boys!

k9s sits on top of two very cool GO projects that provides the much needed terminal support. So big thanks and shootout to the good folks at tcell+tview for making k9s a reality!!



Contact Information



© 2018 Imhotep Software LLC. All materials licensed under Apache v2.0