hula 0.7.1

data/lib/hula/service_broker/client.rb

@@ -0,0 +1,69 @@
+# Copyright (c) 2014-2015 Pivotal Software, Inc.
+# All rights reserved.
+# 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.
+#
+
+require 'hula/service_broker/api'
+
+require 'forwardable'
+
+module Hula
+  module ServiceBroker
+    class Client
+
+      extend Forwardable
+      def_delegators :api,
+                     :catalog,
+                     :debug,
+                     :deprovision_instance,
+                     :bind_instance,
+                     :unbind_instance,
+                     :url
+
+      def initialize(args = {})
+        api_args = args.reject { |k, _v| k == :api }
+        @api = args.fetch(:api) { Api.new(api_args) }
+      end
+
+      def provision_and_bind(service_name, plan_name, &block)
+        raise Error, 'no block given' unless block_given?
+        provision_instance(service_name, plan_name) do |service_instance|
+          bind_instance(service_instance, &block)
+        end
+      end
+
+      def provision_instance(service_name, plan_name, &block)
+        plan = catalog.service_plan(service_name, plan_name)
+        service_instance = api.provision_instance(plan)
+        return service_instance unless block
+
+        begin
+          block.call(service_instance)
+        ensure
+          api.deprovision_instance(service_instance)
+        end
+      end
+
+      def bind_instance(service_instance, &block)
+        binding = api.bind_instance(service_instance)
+        return binding unless block
+
+        begin
+          block.call(binding, service_instance)
+        ensure
+          api.unbind_instance(binding)
+          sleep 1
+        end
+      end
+
+      private
+
+      attr_reader :api
+    end
+  end
+end

data/lib/hula/service_broker/errors.rb

@@ -0,0 +1,24 @@
+# Copyright (c) 2014-2015 Pivotal Software, Inc.
+# All rights reserved.
+# 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.
+#
+
+module Hula
+  module ServiceBroker
+    class Error < StandardError; end
+
+    class NotInCatalog < Error; end
+    class PlanNotFoundError < NotInCatalog; end
+    class ServiceNotFoundError < NotInCatalog; end
+
+    class JsonParseError < Error; end
+    class TimeoutError < Error; end
+    class HTTPError < Error; end
+
+  end
+end

data/lib/hula/service_broker/http_json_client.rb

@@ -0,0 +1,90 @@
+# Copyright (c) 2014-2015 Pivotal Software, Inc.
+# All rights reserved.
+# 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.
+#
+
+require 'net/http'
+
+require 'hula/service_broker/errors'
+
+module Hula
+  module ServiceBroker
+
+    class HttpProxyNull
+      def http_host
+        nil
+      end
+      def http_port
+        nil
+      end
+    end
+
+    class HttpJsonClient
+      def initialize(http_proxy: HttpProxyNull.new)
+        @http_proxy = http_proxy
+      end
+
+      def get(uri, auth: nil)
+        request = Net::HTTP::Get.new(uri)
+        request.basic_auth auth.fetch(:username), auth.fetch(:password) unless auth.nil?
+        send_request(request)
+      end
+
+      def put(uri, body: nil, auth: nil)
+        request = Net::HTTP::Put.new(uri)
+        request.body = JSON.generate(body) if body
+        request.basic_auth auth.fetch(:username), auth.fetch(:password) unless auth.nil?
+        send_request(request)
+      end
+
+      def delete(uri, auth: nil)
+        request = Net::HTTP::Delete.new(uri)
+        request.basic_auth auth.fetch(:username), auth.fetch(:password) unless auth.nil?
+        send_request(request)
+      end
+
+      private
+
+      attr_reader :http_proxy
+
+      def send_request(request)
+        uri = request.uri
+        make_request(uri.hostname, uri.port, uri.scheme, request)
+      end
+
+      def make_request(host, port, scheme, request)
+        response = Net::HTTP.start(
+          host,
+          port,
+          http_proxy.http_host,
+          http_proxy.http_port,
+          use_ssl: scheme == 'https',
+          verify_mode: OpenSSL::SSL::VERIFY_NONE
+        ) { |http| http.request(request) }
+
+        handle(response)
+      rescue Timeout::Error => e
+        raise TimeoutError, e
+      end
+
+      def handle(response)
+        unless response.is_a?(Net::HTTPSuccess)
+          fail HTTPError, [
+            response.uri.to_s,
+            response.code,
+            response.body
+          ].join("\n\n")
+        end
+
+        JSON.parse(response.body, symbolize_names: true)
+      rescue JSON::ParserError => e
+        raise JsonParseError, e
+      end
+    end
+  end
+end

data/lib/hula/service_broker/instance_binding.rb

@@ -0,0 +1,30 @@
+# Copyright (c) 2014-2015 Pivotal Software, Inc.
+# All rights reserved.
+# 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.
+#
+
+module Hula
+  module ServiceBroker
+    class InstanceBinding
+      attr_reader :id, :credentials, :service_instance
+
+      def initialize(id:, credentials:, service_instance:)
+        @id = id
+        @credentials = credentials
+        @service_instance = service_instance
+      end
+
+      def ==(other)
+        is_a?(other.class) &&
+          id == other.id &&
+          credentials == other.credentials &&
+          service_instance == other.service_instance
+      end
+    end
+  end
+end

data/lib/hula/service_broker/plan.rb

@@ -0,0 +1,32 @@
+# Copyright (c) 2014-2015 Pivotal Software, Inc.
+# All rights reserved.
+# 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.
+#
+
+module Hula
+  module ServiceBroker
+    class Plan
+      def initialize(args = {})
+        @id = args.fetch(:id)
+        @name = args.fetch(:name)
+        @description = args.fetch(:description)
+        @service_id = args.fetch(:service_id)
+      end
+
+      attr_reader :id, :name, :description, :service_id
+
+      def ==(other)
+        is_a?(other.class) &&
+          id == other.id &&
+          name == other.name &&
+          description == other.description &&
+          service_id == other.service_id
+      end
+    end
+  end
+end

data/lib/hula/service_broker/service.rb

@@ -0,0 +1,47 @@
+# Copyright (c) 2014-2015 Pivotal Software, Inc.
+# All rights reserved.
+# 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.
+#
+
+require 'hula/service_broker/errors'
+require 'hula/service_broker/plan'
+
+module Hula
+  module ServiceBroker
+    class Service
+      def initialize(args = {})
+        @id          = args.fetch(:id)
+        @name        = args.fetch(:name)
+        @description = args.fetch(:description)
+        @bindable    = !!args.fetch(:bindable)
+        @plans       = args.fetch(:plans).map { |p| Plan.new(p.merge(service_id: self.id)) }
+      end
+
+      attr_reader :id, :name, :description, :bindable, :plans
+
+      def ==(other)
+        is_a?(other.class) &&
+          id == other.id &&
+          name == other.name &&
+          description == other.description &&
+          bindable == other.bindable &&
+          plans == other.plans
+      end
+
+      def plan(plan_name)
+        plans.find { |p| p.name == plan_name } or
+          fail(PlanNotFoundError, [
+            %{Unknown plan with name: #{plan_name.inspect}},
+            "  Known plan names are: #{plans.map(&:name).inspect}"
+            ].join("\n")
+          )
+      end
+
+    end
+  end
+end

data/lib/hula/service_broker/service_instance.rb

@@ -0,0 +1,24 @@
+# Copyright (c) 2014-2015 Pivotal Software, Inc.
+# All rights reserved.
+# 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.
+#
+
+module Hula
+  module ServiceBroker
+    class ServiceInstance
+      def initialize(id:)
+        @id = id
+      end
+      attr_reader :id
+
+      def ==(other)
+        is_a?(other.class) && id == other.id
+      end
+    end
+  end
+end

data/lib/hula/socks4_proxy_ssh.rb

@@ -0,0 +1,118 @@
+# Copyright (c) 2014-2015 Pivotal Software, Inc.
+# All rights reserved.
+# 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.
+#
+
+require 'hula/helpers/socket_tools'
+require 'pty'
+require 'expect'
+
+module Hula
+  class Socks4ProxySsh
+    class FailedToStart < StandardError; end
+    class DieSignal < StandardError; end
+
+    include Helpers::SocketTools
+
+    def initialize(
+      ssh_host:,
+      ssh_username:,
+      ssh_password:,
+      socks_host: 'localhost',
+      socks_port: free_port,
+      ssh_bin: 'ssh',
+      retry_count: 10
+    )
+      @ssh_bin      = String(ssh_bin)
+      @ssh_host     = String(ssh_host)
+      @ssh_username = String(ssh_username)
+      @ssh_password = String(ssh_password)
+      @socks_port   = String(socks_port)
+      @socks_host   = String(socks_host)
+      @retry_count = retry_count
+    end
+
+    attr_reader :socks_port, :socks_host
+
+    def stop
+      return unless @thread
+      @thread.raise(DieSignal)
+      @thread.join
+      @thread = nil
+    end
+
+    def start
+      @thread ||= begin
+        thread = start_ssh_socks_thread
+        wait_for_port(:host => socks_host, :port => socks_port, timeout_seconds: 30)
+        thread
+      end
+    end
+
+    private
+
+    attr_reader :ssh_host, :ssh_username, :ssh_password, :ssh_bin
+
+    def start_ssh_socks_thread
+      # We need to shell out to ssh as this has a SOCKS proxy facility
+      # However, there's a problem. SSH does not provide an argument for passing in a password
+      # We don't have keys available so we need to use expect to feed the password into the prompt
+      Thread.new(
+        ssh_command,
+        ssh_password
+      ) do |ssh_command, ssh_password|
+        tries_remaining = @retry_count
+
+        while true
+          puts "--- SSH Gateway attempt #{@retry_count + 1 - tries_remaining}"
+          sleep 1
+
+          begin
+            ssh_out, ssh_in, pid = PTY.spawn(*ssh_command)
+            # On BOSH lite a password is used, however on aws an identity is used
+            # The below statment will wait on a aws run and the pid is never returned
+            ssh_out.expect(/[Pp]assword\:/) { |r| ssh_in.print("#{ssh_password}\n") }
+            Process.wait(pid)
+
+            tries_remaining -= 1
+            if tries_remaining < 0
+              raise FailedToStart, "SSH finished early - SSH Socks Proxy could not be setup or failed"
+            end
+          rescue Errno::EIO
+            tries_remaining -= 1
+            # Can't read or write to dead process
+
+            if tries_remaining < 0
+              raise FailedToStart, "SSH finished early EIO - SSH Socks Proxy could not be setup or failed"
+            end
+          rescue DieSignal
+            Process.kill('KILL', pid) rescue Errno::ESRCH
+            Process.wait(pid)         rescue Errno::ECHILD
+            break
+          end
+        end
+      end.tap do |thread|
+        thread.abort_on_exception = true
+      end
+    end
+
+    def ssh_command
+      [
+        ssh_bin,
+        '-D', "#{socks_host}:#{socks_port}",
+        '-N',
+        "#{ssh_username}@#{ssh_host}",
+        '-o', 'UserKnownHostsFile=/dev/null',
+        '-o', 'StrictHostKeyChecking=no',
+        '-o', 'NumberOfPasswordPrompts=1',
+        '-o', 'StrictHostKeyChecking=no'
+      ]
+    end
+
+  end
+end

data/lib/hula/version.rb

@@ -0,0 +1,13 @@
+# Copyright (c) 2014-2015 Pivotal Software, Inc.
+# All rights reserved.
+# 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.
+#
+
+module Hula
+  VERSION = '0.7.1'
+end

data/lib/hula.rb

@@ -0,0 +1,16 @@
+# Copyright (c) 2014-2015 Pivotal Software, Inc.
+# All rights reserved.
+# 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.
+#
+
+require 'hula/version'
+require 'hula/bosh_director'
+require 'hula/cloud_foundry'
+
+module Hula
+end