Project

kontena-plugin-shell

0.0
No commit activity in last 3 years
No release in over 3 years
kontena-plugin-shellkontena/kontena-plugin-shellHomepageDocumentationSource CodeBug TrackerWiki
Interactive shell for Kontena CLI aka KOSH
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Popularity
Downloads
9,667
Stars
2
Forks
1
Watchers
5
 Releases
Current version
0.2.0
Total releases
5
First release
2017-04-21
Latest release
2017-11-15
 Issues
Open Issues
0
Closed Issues
16
Total Issues
16
Issue Closure Rate
100%
 Pull Requests
Open Pull Requests
1
Closed Pull Requests
4
Merged Pull Requests
31
Pull Request Acceptance Rate
86%
 Development
Primary Language
Ruby
Licenses
Apache-2.0
Average date of last 50 commits
2017-07-15
Reverse Dependencies
0

 Dependencies

Development

bundler
~> 1.11
rake
~> 10.0
rspec
~> 3.5

Runtime

kontena-cli
~> 1.0
 Project Readme

Kontena Shell

Build Status Join the chat at https://slack.kontena.io Join the chat at https://gitter.im/kontena/kontena

asciicast

Kontena Shell, or KOSH for short, is an interactive console interface for the Kontena CLI.

Features:

  • Command context switching, for example jump to stack context and use ls and install instead of kontena stack ls and kontena stack install
  • Prompt shows current master and grid
  • Command history
  • Batch commands
  • Tab completion
  • ...

Installation

$ kontena plugin install shell

Usage

Starting the console:

$ kontena shell

or:

$ kosh

You can enter regular Kontena CLI subcommands without kontena:

kontena-master/grid-name > master ls
Name                     Url
kontena-master           http://192.168.66.100:8080

Or enter a command context:

kontena-master/grid-name > grid
kontena-master/grid-name grid > ls
Name                           Nodes    Services     Users
grid-name *                    2        1            1
test                           0        0            2

To go up in the context, use ..:

kontena-master/foo grid > ..
kontena-master/foo > _

Or go to top with /:

kontena-master/foo > master user
kontena-master/foo master user > /
kontena-master/foo > _

Or run commands from another context:

kontena-master/foo master user > / grid ls
Name                           Nodes    Services     Users
grid-name *                    2        1            1
kontena-master/foo master user > _

Use help to see help:

kontena-master/foo grid > help
Usage:
      SUBCOMMAND [ARG] ...

Parameters:
    SUBCOMMAND                    subcommand
    [ARG] ...                     subcommand arguments
...

Contributing

  1. Fork it ( https://github.com/kontena/kontena-plugin-shell )
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new Pull Request

License

Kontena Shell Plugin is licensed under the Apache License, Version 2.0. See LICENSE for full license text.