closh 0.0.1.alpha.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: c2ccd50d3128e79f0170e486c6c41960224e9a76
+  data.tar.gz: b9e91861f3fc669bc8cf2dc1ca6d8c1bc45b51fd
+SHA512:
+  metadata.gz: 334acd5b103683388a71123a76c0e75c4f1d3ef9123a19a6d5afc9169b77a7b9a8f93d65fbb8707bb0349deb2a81e2501126ea88773e0d6c579d72b0c52b116b
+  data.tar.gz: f767a8e1e8279cefccfc8c63e02b83510d3e6b9d397b6e4e38958789accadc440ad584dd60d3b07c063b3e8c5cdfde53c0e2f2c4c3c573d6d7215ab52151768c

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2017 Vincent Ollivier
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,99 @@
+Cloud Shell
+===========
+
+A shell running in the cloud
+
+
+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.yaml)
+      -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](http://fog.io/) under the hood to create compute
+servers.
+
+The configuration is stored in a YAML file (`~/.closh.yaml`). 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`.
+
+```yaml
+---
+
+compute:
+  provider: AWS
+  aws_access_key_id: <%= ENV["AWS_ACCESS_KEY_ID"] %>
+  aws_secret_access_key: <%= ENV["AWS_SECRET_ACCESS_KEY"] %>
+  region: us-west-2
+
+server:
+  image_id: ami-70728c08 # ubuntu 17.04 amd64 hvm:ebs-ssd
+  flavor_id: t2.micro
+  username: ubuntu
+```
+
+
+License
+-------
+
+Copyright (C) 2017 Vincent Ollivier. Released under MIT.

data/bin/closh

@@ -0,0 +1,5 @@
+#!/usr/bin/env ruby
+
+require "closh"
+
+CloudShell::CLI.run

data/lib/closh.rb

@@ -0,0 +1,6 @@
+require "closh/session"
+require "closh/cli"
+require "closh/version"
+
+module CloudShell
+end

data/lib/closh/cli.rb

@@ -0,0 +1,63 @@
+require "active_support/core_ext/object/blank"
+require "active_support/hash_with_indifferent_access"
+require "erb"
+require "trollop"
+require "yaml"
+
+module CloudShell
+  module CLI
+    def self.run
+      opts = self.parse_opts(ARGV)
+
+      config_path = File.expand_path(opts[:config])
+      config = YAML.load(ERB.new(File.read(config_path)).result).deep_symbolize_keys
+
+      shell = CloudShell::Session.new(config, opts)
+
+      if opts[:list]
+        shell.list_servers
+        exit
+      end
+
+      if opts[:resume]
+        shell.find_server(opts[:resume])
+      else
+        key_path = File.expand_path(opts[:key])
+        key_body = File.read(key_path)
+        shell.upload_ssh_key(key_body)
+
+        shell.create_server
+      end
+
+      begin
+        command = ARGV.join(" ").presence || "$SHELL"
+        shell.exec(command) do |channel|
+          unless STDIN.tty?
+            channel.send_data(STDIN.read)
+            channel.eof!
+          end
+        end
+      ensure
+        shell.destroy_server if opts[:kill]
+      end
+    end
+
+    private
+
+    def self.parse_opts(args)
+      Trollop::options(ARGV) do
+        version "Cloud Shell v#{CloudShell::VERSION}"
+        usage "<command>"
+        opt :dry_run, "Create fake server and run locally", short: "n"
+        opt :config,  "Config file", type: :string, default: "~/.closh.yaml"
+        opt :key,     "SSH public key", type: :string, default: "~/.ssh/id_rsa.pub"
+        opt :resume,  "Resume session", type: :string
+        opt :kill,    "Kill session at the end", short: "x"
+        opt :list,    "List sessions"
+        opt :verbose, "Use verbose mode"
+        opt :help,    "Show this message"
+        opt :version, "Print version and exit", short: "V"
+      end
+    end
+  end
+end

data/lib/closh/session.rb

@@ -0,0 +1,95 @@
+require "fog"
+require "net/ssh"
+require "rainbow"
+
+module CloudShell
+  class Session
+    def initialize(config, options)
+      @config = config
+      @provider = config[:compute][:provider]
+      @key_name = config[:compute][:key_name] || "closh"
+
+      @options = options
+      Fog.mock! if options[:dry_run]
+
+      @compute = Fog::Compute.new(config[:compute])
+    end
+
+    def upload_ssh_key(key)
+      if @compute.key_pairs.get(@key_name).nil?
+        debug("uploading SSH public key to #{@provider} ...")
+        @compute.import_key_pair(@key_name, key)
+      end
+    end
+
+    def list_servers
+      debug("listing servers on #{@provider} ...")
+      @compute.servers.each do |server|
+        puts server.public_ip_address if server.public_ip_address
+      end
+    end
+
+    def find_server(address)
+      debug("finding server on #{@provider} ...")
+      config = @config[:server]
+      @username = config[:username] || "root"
+      @compute.servers.each do |server|
+        return @server = server if server.public_ip_address == address
+      end
+      error("could not find server on #{@provider}")
+      exit 1
+    end
+
+    def create_server
+      debug("creating server on #{@provider} ...")
+      config = @config[:server].merge({ key_name: @key_name })
+      @username = config[:username] || "root"
+      @server = @compute.servers.create(config)
+      @server.wait_for { ready? }
+    end
+
+    def destroy_server
+      debug("destroying server ...")
+      @server.destroy
+    end
+
+    def exec(command, &block)
+      debug("connecting to '#{@username}@#{@server.public_ip_address}' ...")
+      if @options[:dry_run]
+        debug("executing command '#{command}' ...")
+        system(command)
+      else
+        Net::SSH.start(@server.public_ip_address, @username) do |ssh|
+          ssh.open_channel do |channel|
+            debug("executing command `#{command}` ...")
+            channel.exec(command) do |_, success|
+              channel.on_data do |_, data|
+                print data
+              end
+
+              if block_given?
+                block.call(channel)
+              end
+            end
+          end
+          ssh.loop
+        end
+      end
+    rescue Errno::ECONNREFUSED
+      n = 10
+      error("connection refused, retrying in #{n} seconds")
+      sleep n
+      retry
+    end
+
+    private
+
+    def debug(text)
+      puts Rainbow("debug: ").cyan + text if @options[:verbose]
+    end
+
+    def error(text)
+      puts Rainbow("error: ").yellow + text if @options[:verbose]
+    end
+  end
+end

data/lib/closh/version.rb

@@ -0,0 +1,3 @@
+module CloudShell
+  VERSION = "0.0.1.alpha.1".freeze
+end

metadata

@@ -0,0 +1,171 @@
+--- !ruby/object:Gem::Specification
+name: closh
+version: !ruby/object:Gem::Version
+  version: 0.0.1.alpha.1
+platform: ruby
+authors:
+- Vincent Ollivier
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2017-10-17 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.1'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 5.1.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.1'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 5.1.0
+- !ruby/object:Gem::Dependency
+  name: fog
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.42'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.42.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.42'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.42.0
+- !ruby/object:Gem::Dependency
+  name: net-ssh
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.1'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 4.1.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.1'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 4.1.0
+- !ruby/object:Gem::Dependency
+  name: rainbow
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.2'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.2.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.2'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.2.0
+- !ruby/object:Gem::Dependency
+  name: trollop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.1'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.1.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.1'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.1.0
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.6'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.6.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.6'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.6.0
+description: Closh automatically bootstrap servers in the cloud to run shell commands
+email: v@vinc.cc
+executables:
+- closh
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- bin/closh
+- lib/closh.rb
+- lib/closh/cli.rb
+- lib/closh/session.rb
+- lib/closh/version.rb
+homepage: https://github.com/vinc/closh
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">"
+    - !ruby/object:Gem::Version
+      version: 1.3.1
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.6.11
+signing_key: 
+specification_version: 4
+summary: A shell running in the cloud
+test_files: []