fleetctl-setup 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: b11ccb97ecf00fb9a6d8a63e587da980ad6d5220
+  data.tar.gz: 36eab04e98702a95ccc206c99197b37c9ff125d7
+SHA512:
+  metadata.gz: 8e9c07775947af698dad1a5a22fd382548223af2dc94292fe3cd70396fe8fc2df3488ffdaca7c0f2993ac26f2da7776011c6f9d15fd944db1cf9a5827856e8b1
+  data.tar.gz: 9e67f5db032811e7731027303d2e9b81f52421b128cb554d14522ed60af62e204956f2ad5401144bb8cf92c9bb2673b6fa183c945d54d453c2f89486eeb8e9ef

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in fleetctl-setup.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 Ryan Taylor Long
+
+MIT License
+
+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,63 @@
+# fleetctl-setup
+
+This tool assists you in using `fleetctl` to control a remote CoreOS cluster.  Doing so requires an IP address to one of the nodes on the Cluster. Rather than logging in to AWS and finding that IP manually (which would have to happen everytime, as the IP could change, especialy if you're using the recommended CloudFormation approach with an Auto-Scaling Group), this tool helps by picking a node in a cluster which you specify by a search term.
+
+At the moment, it only uses the Search term for finding a CloudFormation stack based on its `stack_name`. It should be rather trivial to expand the search to other services.
+
+## Installation
+
+    $ gem install fleetctl-setup
+
+## Usage
+
+It uses the `aws-core-api` gem to talk to AWS. This requires authentication with
+IAM credentials, and a region, to be configured.
+
+```shell
+export AWS_ACCESS_KEY_ID="..."
+export AWS_SECRET_ACCESS_KEY="..."
+export AWS_REGION=us-east-1
+```
+
+Then, run `fleetctl-setup [search]`.
+
+Assuming you have a CloudFormation stack called 'internal-tools', a search for
+"tools" may result in this:
+
+```
+$ fleetctl-setup tools
+Looking up instances for CloudFormation Stack: internal-tools
+Picking randomly from <ip_addr1>, <ip_addr2>, <ip_addr3>, <ip_addr4>.
+export FLEETCTL_TUNNEL=<ip_addr3>
+```
+
+The last line is the variable you need to set in your shell to use `fleetctl`.
+
+All the output of this tool is on STDERR, save for that last line, so you can eval
+the output for easier use:
+
+```
+$ eval `fleetctl-setup tools`
+Looking up instances for CloudFormation Stack: internal-tools
+Picking randomly from <ip_addr1>, <ip_addr2>, <ip_addr3>, <ip_addr4>.
+
+$ echo $FLEETCTL_TUNNEL
+<ip_addr4>
+
+$ fleetctl list-machines
+MACHINE          IP               METADATA
+3f5399cd...      <ip_addr1>       -
+b7ff2469...      <ip_addr2>       -
+cd411b1d...      <ip_addr3>       -
+aa07c493...      <ip_addr4>       -
+```
+
+If you use an ambiguous search term, it will prompt you to choose among the
+results, before it grabs any info about instances.
+
+## fleetctl Setup
+
+To get `fleetctl` installed on your system, refer to the following resources:
+
+- [CoreOS: Controlling the cluster with fleetctl](https://coreos.com/docs/launching-containers/launching/fleet-using-the-client/)
+- [fleet: Remote fleet Access](https://github.com/coreos/fleet/blob/master/Documentation/remote-access.md)

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/bin/fleetctl-setup

@@ -0,0 +1,11 @@
+#!/usr/bin/env ruby
+
+require 'fleetctl/setup/cli'
+
+cli = Fleetctl::Setup::CLI.new(ARGV)
+cli.parse_opts!
+
+warn "Picking randomly from #{cli.instance_ips.join(', ')}."
+ip_address = cli.instance_ips.sample
+
+puts "export FLEETCTL_TUNNEL=#{ip_address}"

data/fleetctl-setup.gemspec

@@ -0,0 +1,25 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'fleetctl/setup/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "fleetctl-setup"
+  spec.version       = Fleetctl::Setup::VERSION
+  spec.authors       = ["Ryan Taylor Long"]
+  spec.email         = ["ryan@rtlong.com"]
+  spec.summary       = %q{Determines the endpoint for a CoreOS node in a cluster running on Amazon Web Services}
+  spec.description   = %q{Finds the public IP of a random node on a CodeOS cluster running in AWS, and sets the FLEETCTL_TUNNEL variable to allow dev-ops engineers a simple workflow of controlling CoreOS cluster without delving into the AWS console each time}
+  spec.homepage      = ""
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.5"
+  spec.add_development_dependency "pry"
+  spec.add_development_dependency "rake"
+  spec.add_dependency "aws-sdk-core", ">= 2.0.0.rc6"
+end

data/lib/fleetctl/setup/aws/cloud_formation_search.rb

@@ -0,0 +1,62 @@
+require 'aws-sdk-core'
+require 'fleetctl/setup'
+
+module Fleetctl::Setup
+  module AWS
+    class CloudFormationSearch
+      class Result
+        def initialize(resource)
+          @resource = resource
+        end
+
+        def description
+          "CloudFormation Stack: #{@resource.stack_name}"
+        end
+
+        def instances
+          [].tap do |instances|
+            Aws.ec2.describe_instances(filters: [filter]).each do |response|
+              response.reservations.each do |res|
+                instances.concat res.instances
+              end
+            end
+          end
+        end
+
+        private
+
+        def filter
+          { name: 'tag:aws:cloudformation:stack-id', values: [@resource.stack_id] }
+        end
+      end
+
+      class <<self
+        def search(search_term)
+          new(search_term).results
+        end
+      end
+
+      def initialize(search_term)
+        @search_term = search_term
+      end
+
+      def results
+        filtered_resources.map { |r| Result.new(r) }
+      end
+
+      private
+
+      def filtered_resources
+        all_resources.select do |stack|
+          /#{@search_term}/.match(stack.stack_name)
+        end
+      end
+
+      def all_resources
+        @all_resources ||= Aws::CloudFormation.new.describe_stacks.stacks
+      end
+    end
+  end
+end
+
+

data/lib/fleetctl/setup/aws/search.rb

@@ -0,0 +1,33 @@
+require 'fleetctl/setup'
+require 'fleetctl/setup/aws/cloud_formation_search'
+
+module Fleetctl::Setup
+  module AWS
+    class Search
+      class <<self
+        def search(search_term)
+          new(search_term).results
+        end
+
+        def service_classes
+          {
+            cloud_formation: CloudFormationSearch
+          }
+        end
+      end
+
+      def initialize(search_term)
+        @search_term = search_term
+      end
+
+      def results
+        [].tap do |results|
+          self.class.service_classes.values.each do |klass|
+            results.concat klass.search(@search_term)
+          end
+        end
+      end
+    end
+  end
+end
+

data/lib/fleetctl/setup/cli.rb

@@ -0,0 +1,72 @@
+require 'optparse'
+require 'fleetctl/setup'
+require 'fleetctl/setup/aws/search'
+
+module Fleetctl::Setup
+  class CLI
+    def initialize(argv=ARGV)
+      @options = {}
+      @argv = argv
+    end
+    attr_reader :options
+
+    def parse_opts!
+      opt_parser = OptionParser.new do |opts|
+        opts.banner = "Usage: fleetctl-setup [search-term]"
+
+        opts.on_tail '-h', '--help', 'show this message' do
+          warn opts
+          exit
+        end
+      end
+      opt_parser.parse!(@argv)
+
+      if @argv.empty?
+        warn "ERROR: You must supply a keyword or ID to pick a cluster.\n\n"
+        puts opt_parser
+        exit
+      end
+      options[:search_term] = @argv.join(' ')
+      options.freeze
+    end
+
+    def instance_ips
+      return @instance_ips if @instance_ips
+
+      results = AWS::Search.search(options[:search_term])
+      raise "No results found" if results.empty?
+
+      choice = user_choice(results)
+      warn "Looking up instances for #{choice.description}"
+
+      @instance_ips = choice.instances.map(&:public_ip_address)
+    end
+
+    private
+
+    def user_choice(choices)
+      return nil if choices.empty?
+      return choices.first if choices.length == 1
+      choices.each_with_index do |choice, i|
+        $stderr.puts "#{i+1}. #{choice.description}"
+      end
+      choice_index = prompt_int('Please enter a number to select an option: ', 1..choices.length)
+      choices[choice_index - 1]
+    end
+
+    def prompt(message, format=nil)
+      begin
+        $stderr.print message
+        response = $stdin.gets.chomp
+      end while format && !format.match(response)
+      response
+    end
+
+    def prompt_int(message, range=nil)
+      begin
+        int = Integer(prompt(message, /\A\d+\z/))
+      end while range && !range.include?(int)
+      int
+    end
+  end
+end

data/lib/fleetctl/setup/version.rb

@@ -0,0 +1,5 @@
+module Fleetctl
+  module Setup
+    VERSION = "0.0.1"
+  end
+end

data/lib/fleetctl/setup.rb

@@ -0,0 +1,6 @@
+require "fleetctl/setup/version"
+
+module Fleetctl
+  module Setup
+  end
+end

metadata

@@ -0,0 +1,117 @@
+--- !ruby/object:Gem::Specification
+name: fleetctl-setup
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Ryan Taylor Long
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-04-18 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.5'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: aws-sdk-core
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.0.0.rc6
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.0.0.rc6
+description: Finds the public IP of a random node on a CodeOS cluster running in AWS,
+  and sets the FLEETCTL_TUNNEL variable to allow dev-ops engineers a simple workflow
+  of controlling CoreOS cluster without delving into the AWS console each time
+email:
+- ryan@rtlong.com
+executables:
+- fleetctl-setup
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/fleetctl-setup
+- fleetctl-setup.gemspec
+- lib/fleetctl/setup.rb
+- lib/fleetctl/setup/aws/cloud_formation_search.rb
+- lib/fleetctl/setup/aws/search.rb
+- lib/fleetctl/setup/cli.rb
+- lib/fleetctl/setup/version.rb
+homepage: ''
+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: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.0
+signing_key: 
+specification_version: 4
+summary: Determines the endpoint for a CoreOS node in a cluster running on Amazon
+  Web Services
+test_files: []
+has_rdoc: