Cloud Shell
Get a shell running in the cloud in seconds
Installation
$ gem install closh
Alternatively you can build the gem from its repository:
$ git clone git://github.com/vinc/closh.git
$ cd closh
$ gem build closh.gemspec
$ gem install closh-0.0.1.gem
Usage
Run a command in the cloud:
$ closh -x "cut -d . -f 1 /proc/uptime"
23
More verbose:
$ closh -vx "cut -d . -f 1 /proc/uptime"
debug: uploading SSH public key to AWS ...
debug: creating server on AWS ...
debug: connecting to 'ubuntu@158.116.77.89' ...
debug: executing command 'cut -d . -f 1 /proc/uptime' ...
23
debug: destroying server ...
Pipe to stdin:
$ echo "cut -d . -f 1 /proc/uptime" | closh -x "bash -s"
Run a script remotely:
$ closh -x "bash -s" < example.sh
Skip the -x flag to keep a session alive for long running scripts.
Use -l to list sessions and -r to resume one:
$ closh -r 158.116.77.89 "tail -f screenlog.0"
More options:
$ closh -h
Usage: closh <command>
Cloud Shell v0.0.1
Options:
-n, --dry-run Create fake server and run locally
-c, --config=<s> Config file (default: ~/.closh.yml)
-k, --key=<s> SSH public key (default: ~/.ssh/id_rsa.pub)
-r, --resume=<s> Resume session
-x, --kill Kill session at the end
-l, --list List sessions
-v, --verbose Use verbose mode
-h, --help Show this message
-V, --version Print version and exit
Configure
Cloud Shell is based on Fog under the hood to create compute servers.
The configuration is stored in a YAML file (~/.closh.yml). It is divided in
two parts: compute and server. The former being fed to Fog::Compute.new and
the latter to Fog::Compute::*::Server.new.
---
compute:
provider: AWS
aws_access_key_id: <%= ENV["AWS_ACCESS_KEY_ID"] %>
aws_secret_access_key: <%= ENV["AWS_SECRET_ACCESS_KEY"] %>
region: us-east-1
server:
image_id: ami-b04847cf # Ubuntu 18.04 LTS
flavor_id: t2.micro
username: ubuntu
groups:
- default
- sshLicense
Copyright (c) 2017-2018 Vincent Ollivier. Released under MIT.