Skip to content

Latest commit

 

History

History
137 lines (104 loc) · 4.12 KB

README.md

File metadata and controls

137 lines (104 loc) · 4.12 KB
Raw

Cloudman

Cloudman is a textual user interface (heavily inspired by htop) to manage your Amazon EC2 fleet instantly. By using Cloudman you'll find an overview of your instances, navigate through regions, retrieve instance details, show console outputs and connect to instance terminal using SSM.

The profiles and defaults as configured in ~/.aws/credentials will be used.

Build status Crates.io Packaging status MIT licensed

Screenshots

Usage

Cloudman can be started optionally with a region and profile to use.

cloudman-rs 0.1.7
Remco Verhoef <[email protected]>

USAGE:
    cloudman [FLAGS] [OPTIONS]

FLAGS:
        --disable-dry-run    Disable dry run
    -h, --help               Prints help information
        --use-env            Usen environment credentials
    -V, --version            Prints version information

OPTIONS:
    -p, --profile <profile>...    One or more profiles to use
    -r, --region <region>...      One or more regions to use

Shortcuts

Shortcut Description
F1 display help
F2 connect using ssm to instance
F3 search through displayed instances
F4 filter displayed instances
F5 refresh displayed instances
F6 show actions for instances
F7 switch region
L display console output for instance
ESC close window
Q quit

Installation

Homebrew

If you're a macOS Homebrew or a Linuxbrew user, then you can install cloudman from homebrew tap:

brew install dutchcoders/cloudman/cloudman

MacPorts

If you're a MacPorts user, you can install Cloudman using:

sudo port selfupdate
sudo port install cloudman

Building

cloudman is written in Rust, so you'll need to grab a Rust installation in order to compile it. cloudman compiles with Rust 1.44.0 (stable) or newer. In general, cloudman tracks the latest stable release of the Rust compiler.

To build cloudman:

$ git clone https://github.com/dutchcoders/cloudman
$ cd cloudman
$ cargo build --release
$ ./target/release/cloudman --version
0.1.0

Current features

  • overview of all instances
  • support different profiles
  • switch easily between aws regions
  • connect using SSM to instance (using tmux)
  • search through instances
  • filter instances
  • show detailed information for instances
  • show console output if supported

Roadmap

  • start and stop instances (actions)
  • request spot instances
  • modifyable columns
  • sorting
  • show filter active
  • show indicator of loading
  • search through console output
  • much more

Contribute

Thanks

Special thanks to:

  • Doom Emacs for making the Emacs framework I love.
  • Cursive for making the textual user interface Cloudman is built upon.
  • htop for the inspirational interface.

Everyone else that inspired me.

Creator

Remco Verhoef

Copyright and license

Code and documentation copyright 2011-2020 Remco Verhoef.

Code released under the MIT license.