Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/dutchcoders/cloudman
Textual user interface to manage ec2 instances.
https://github.com/dutchcoders/cloudman
Last synced: 7 days ago
JSON representation
Textual user interface to manage ec2 instances.
- Host: GitHub
- URL: https://github.com/dutchcoders/cloudman
- Owner: dutchcoders
- License: mit
- Created: 2020-06-05T18:42:16.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2021-04-10T14:39:21.000Z (over 3 years ago)
- Last Synced: 2024-08-06T03:06:06.116Z (3 months ago)
- Language: Rust
- Homepage:
- Size: 841 KB
- Stars: 145
- Watchers: 4
- Forks: 12
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 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.
[](https://travis-ci.org/github/dutchcoders/cloudman)
[](https://crates.io/crates/cloudman)
[](https://repology.org/project/cloudman/badges)
[](./LICENSE)
### Screenshots
## Usage
Cloudman can be started optionally with a region and profile to use.
```
cloudman-rs 0.1.7
Remco Verhoef
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 ... One or more profiles to use
-r, --region ... One or more regions to use
```
## Shortcuts
| Shortcut | Description |
| ------------- | ------------- |
| F1 | display help |
| F2 | connect using [ssm](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/session-manager.html) 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:
```bash
brew install dutchcoders/cloudman/cloudman
```
### MacPorts
If you're a **MacPorts** user, you can install Cloudman using:
```bash
sudo port selfupdate
sudo port install cloudman
```
## Building
cloudman is written in Rust, so you'll need to grab a
[Rust installation](https://www.rust-lang.org/) 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
+ I :heart: pull requests and bug reports
+ Don't hesitate to [tell me my rust skills suck](https://github.com/dutchcoders/cloudman/issues/new), but please tell me why.
## Thanks
Special thanks to:
* [Doom Emacs](https://github.com/hlissner/doom-emacs) for making the Emacs framework I love.
* [Cursive](https://github.com/gyscos/cursive/) for making the textual user interface Cloudman is built upon.
* [htop](https://github.com/hishamhm/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](LICENSE).