cheftacular 2.0.0

data/lib/cheftacular/stateless_actions/upload_nodes.rb

@@ -0,0 +1,120 @@
+
+class Cheftacular
+  class StatelessActionDocumentation
+    def upload_nodes
+      @config['documentation']['stateless_action'] <<  [
+        "`cft upload_nodes` This command will resync the chef server's nodes with the data in our chef-repo/node_roles. ",
+
+        [
+          "    1. This command changes behavior depending on several factors about both your mode and the state of your environment",
+
+          "    2. In Devops mode, being run directly, this command will prompt you to update a data bag of node_role data that will help " +
+          "non-devops runs perform actions that involve setting roles on servers.",
+
+          "        1. In this setting, any time the chef server's data bag hash differs from the hash stored on disk for a role, you will be " +
+          "prompted to see if you really want to overwrite.",
+
+          "    3. When building new servers *in any mode*, this command will check the node_roles stored in the data bag only and update the " +
+          "run lists of the nodes from that data, NOT from the node_roles data stored on disk in the nodes_dir.",
+
+          "        1. Due to this, only users running this against their chef-repo need to worry about having a nodes_dir, the way it should be."
+        ]
+      ]
+    end
+  end
+
+  class StatelessAction
+    def upload_nodes invalidate_file_node_cache=false
+      raise "This action can only be performed if the mode is set to devops" if !@config['helper'].running_in_mode?('devops') && !@options['in_scaling']
+
+      @config['chef_environments'].each do |env|
+        @config['initializer'].initialize_data_bags_for_environment env, false, ['node_roles']
+
+        @config['initializer'].initialize_node_roles_bag_contents env
+      end
+
+      nodes = @options['multi-step'] ? @config['getter'].get_true_node_objects(true,true) : @config['getter'].get_true_node_objects(true)
+
+      node_roles_hash, bag_hash, allowed_changes_hash = {},{},{}
+
+      Dir.foreach(@config['locs']['nodes']) do |fr|
+        next if @config['helper'].is_junk_filename?(fr)
+
+        Dir.foreach("#{ @config['locs']['nodes'] }/#{ fr }") do |f|
+          next if @config['helper'].is_junk_filename?(f)
+
+          node_roles_hash[f.split('.json').first] = JSON.parse(File.read("#{ @config['locs']['nodes'] }/#{ fr }/#{ f }"))
+        end
+      end if @config['helper'].running_in_mode?('devops') #only devops modes should have a nodes_dir
+
+      @config['chef_environments'].each do |env|
+        @config[env]['node_roles_bag_hash']['node_roles'].each_pair do |role_name, role_hash|
+          bag_hash[role_hash['name']] = role_hash.to_hash #hashes from chef server are stored as hashie objects until forced into hashes
+        end
+      end
+
+      if !@options['force_yes'] && @config['helper'].running_in_mode?('devops') 
+        node_roles_hash.each_pair do |role_name, role_hash|
+          overwrite = false
+          if bag_hash[role_name] != role_hash
+            puts "Detected difference between saved roles hash and updated node_roles json hash."
+
+            puts "Saved roles hash:"
+            ap(bag_hash[role_name])
+
+            puts "New roles hash:"
+            ap(role_hash)
+
+            puts "Preparing to overwrite the saved roles hash with the node_roles hash, enter Y/y to confirm."
+
+            input = STDIN.gets.chomp
+
+            overwrite = true if ( input =~ /y|Y|yes|Yes/ ) == 0
+
+            allowed_changes_hash[role_name] = role_hash if overwrite
+          else #bag_hash does not have a key for that role, populate it.
+            allowed_changes_hash[role_name] = role_hash
+          end
+
+          @config[role_hash['chef_environment']]['node_roles_bag_hash']['node_roles'][role_name] = role_hash
+        end
+      else
+        allowed_changes_hash = bag_hash
+      end
+
+      nodes.each do |node|
+        # if there is a node_roles file that completely matches the name of the file, use it
+        changes_for_current_node = false
+
+        if allowed_changes_hash[node.name]
+          allowed_changes_hash[node.name].each_pair do |node_key, node_val|
+            if (node_key =~ /name/) != 0 && node.send(node_key) != node_val
+              puts("Updating #{ node.name } with attribute #{ node_key } = #{ node_val } from #{ node.name }.json") unless @options['quiet']
+              node.send("#{ node_key }=", node_val)
+
+              changes_for_current_node, invalidate_file_node_cache = true, true
+            end
+          end
+
+        elsif allowed_changes_hash.keys.include?(node.name.gsub(/\d/,'')) #if there is a template file that matches the stripped down name, use it
+          allowed_changes_hash[node.name.gsub(/\d/,'')].each_pair do |node_key, node_val|
+            if (node_key =~ /name/) != 0 && node.send(node_key) != node_val
+              puts("Updating #{ node.name } with attribute #{ node_key } = #{ node_val } from template json file") unless @options['quiet']
+              node.send("#{ node_key }=", node_val)
+
+              changes_for_current_node, invalidate_file_node_cache = true, true
+            end
+          end
+        end
+
+        node.save if changes_for_current_node
+      end
+
+      @config['chef_environments'].each do |env|
+        @config['ChefDataBag'].save_node_roles_bag env
+      end if !@options['force_yes'] && @config['helper'].running_in_mode?('devops')
+
+      @config['helper'].cleanup_file_caches('current') if invalidate_file_node_cache
+    end
+  end
+end

data/lib/cheftacular/stateless_actions/upload_roles.rb

@@ -0,0 +1,24 @@
+
+class Cheftacular
+  class StatelessActionDocumentation
+    def upload_roles
+      @config['documentation']['stateless_action'] <<  [
+        "`cft upload_roles` This command will resync the chef server's roles with the data in the chef-repo/roles."
+      ]
+    end
+  end
+
+  class StatelessAction
+    def upload_roles
+      raise "This action can only be performed if the mode is set to devops" if !@config['helper'].running_in_mode?('devops') && !@options['in_scaling']
+
+      Dir.foreach(@config['locs']['roles']) do |rd|
+        next if @config['helper'].is_junk_filename?(rd)
+
+        puts("Loading in role from file #{ rd }") if @options['verbose']
+
+        puts `knife role from file "#{ @config['locs']['roles'] }/#{ rd }"` 
+      end
+    end
+  end
+end

data/lib/cheftacular/version.rb

@@ -0,0 +1,5 @@
+class Cheftacular
+  #major_version.minor_version.bugfixes
+  VERSION      = "2.0.0"
+  RUBY_VERSION = "2.2.2"
+end

data/lib/cheftacular.rb

@@ -0,0 +1,4 @@
+require 'cheftacular/version'
+
+class Cheftacular
+end

data/lib/cloud_interactor/authentication.rb

@@ -0,0 +1,56 @@
+
+class CloudInteractor
+  class Authentication
+    def initialize auth_hash, options={} 
+      @auth_hash = auth_hash
+      @options   = options
+    end
+
+    def auth_service interaction_class
+      except_keys = []
+
+      interaction_class = case interaction_class.downcase
+                          when 'volume'
+                            case @options['preferred_cloud']
+                            when 'rackspace'
+                              except_keys = [:provider, :version]
+
+                              'Rackspace::BlockStorage'
+                            else
+                              raise "CloudInteractor Does not currently support this #{ options['preferred_cloud'] }'s' volume creation at this time"
+                            end
+                          when 'dns'
+                            case @options['preferred_cloud']
+                            when 'rackspace' 
+                              except_keys = [:version, :rackspace_region]
+
+                              interaction_class
+                            else
+                              except_keys = [:version]
+
+                              interaction_class
+                            end
+                          else
+                            interaction_class
+                          end
+
+      classes_to_inject = interaction_class.split('::')
+      classes_to_inject = classes_to_inject.map { |str| str.camelcase }  
+
+      cloud_hash = case @options['preferred_cloud']
+                   when 'rackspace' 
+                     {
+                       provider:            @options['preferred_cloud'].capitalize,
+                       rackspace_username:  @auth_hash['cloud_auth'][@options['preferred_cloud']]['username'],
+                       rackspace_api_key:   @auth_hash['cloud_auth'][@options['preferred_cloud']]['api_key'],
+                       version:             :v2,
+                       rackspace_region:    @options['preferred_cloud_region'].to_sym,
+                       connection_options:  {}
+                     }.delete_if { |key, value| except_keys.flatten.include?(key) }
+                   else raise "CloudInteractor Does not currently support #{ @options['preferred_cloud'] } at this time"
+                   end
+
+      Fog.class_eval(classes_to_inject.join('::')).new(cloud_hash)
+    end
+  end
+end

data/lib/cloud_interactor/cloud_interactor.rb

@@ -0,0 +1,23 @@
+class CloudInteractor
+  ALLOWED_HLMS = ['domain', 'flavor', 'image', 'server', 'volume']
+
+  def initialize auth_hash, options
+    @main_obj, @classes = {},{}
+    @options            = options
+    @main_obj['output'] = {}
+    @auth_hash          = auth_hash
+    @classes['helper']  = Helper.new(@main_obj, @classes, @options)
+    @classes['domain']  = Domain.new(@main_obj, @auth_hash, @classes, @options)
+    @classes['flavor']  = Flavor.new(@main_obj, @classes, @options)
+    @classes['image']   = Image.new(@main_obj, @classes, @options)
+    @classes['server']  = Server.new(@main_obj, @classes, @options)
+    @classes['volume']  = Volume.new(@main_obj, @classes, @options)
+    @classes['auth']    = Authentication.new(@auth_hash, @options)
+  end
+
+  def run args
+    parse_args(args) unless args.empty?
+
+    @main_obj['output']
+  end
+end

data/lib/cloud_interactor/domain/create.rb

@@ -0,0 +1,17 @@
+class CloudInteractor
+  class Domain
+    def create args, already_created=false
+      read args, false
+
+      unless @main_obj["specific_#{ IDENTITY }"].empty?
+        puts "#{ IDENTITY } #{ args[IDENTITY.singularize] } already exists... returning."
+
+        return false
+      end
+
+      @classes['auth'].auth_service(RESOURCE).instance_eval('zones').create(domain: args[IDENTITY.singularize], email: @auth_hash['cloud_auth'][@options['preferred_cloud']]['email'])
+
+      puts "Created #{ IDENTITY } #{ args[IDENTITY.singularize] }..."
+    end
+  end
+end

data/lib/cloud_interactor/domain/create_record.rb

@@ -0,0 +1,27 @@
+class CloudInteractor
+  class Domain
+    def create_record args, already_created=false
+      args['type'] ||= 'A'
+      args['ttl']  ||= 300
+
+      read args, false
+
+      @main_obj['specific_records'][args[IDENTITY.singularize]].each do |record_hash|
+        already_created = true if record_hash['name'] == "#{ args['subdomain'] }.#{ args[IDENTITY.singularize] }"
+
+        break if already_created
+      end
+
+      if already_created
+        update_record args
+
+      else
+        specific_fog_object = @classes['auth'].auth_service(RESOURCE).instance_eval('zones').get @main_obj["specific_#{ IDENTITY }"].last['id']
+
+        specific_fog_object.records.create(name: "#{ args['subdomain'] }.#{ args[IDENTITY.singularize] }", value: args['target_ip'], type: args['type'], ttl: args['ttl'])
+
+        puts "Attached #{ args['subdomain'] } (#{ args['target_ip'] }) to #{ args[IDENTITY.singularize] }..."
+      end
+    end
+  end
+end

data/lib/cloud_interactor/domain/destroy.rb

@@ -0,0 +1,17 @@
+class CloudInteractor
+  class Domain
+    def destroy args
+      read args, false
+
+      if @main_obj["specific_#{ IDENTITY }"].empty? && @main_obj["specific_#{ IDENTITY }"].last[IDENTITY.singularize] != args[IDENTITY.singularize]
+        puts "#{ IDENTITY } #{ args[IDENTITY.singularize] } doesn't exist... returning."
+
+        return false
+      end
+
+      @classes['auth'].auth_service(RESOURCE).instance_eval('zones').get(@main_obj["specific_#{ IDENTITY }"].last['id']).destroy
+
+      puts "Destroyed #{ IDENTITY.singularize } #{ args[IDENTITY.singularize] }..."
+    end
+  end
+end

data/lib/cloud_interactor/domain/destroy_record.rb

@@ -0,0 +1,23 @@
+class CloudInteractor
+  class Domain
+    def destroy_record args, already_exists=false
+      read args, false
+
+      @main_obj['specific_records'][args[IDENTITY.singularize]].each do |record_hash|
+        already_exists = true if record_hash['name'] == "#{ args['subdomain'] }.#{ args[IDENTITY.singularize] }"
+
+        args['id'] = record_hash['id']
+
+        break if already_exists
+      end
+
+      raise "Subdomain not found for #{ args[IDENTITY.singularize] }" unless already_exists
+
+      puts "Destroying #{ args['subdomain'] } from #{ args[IDENTITY.singularize] }..."
+
+      specific_fog_object = @classes['auth'].auth_service(RESOURCE).instance_eval('zones').get @main_obj["specific_#{ IDENTITY }"].last['id']
+
+      specific_fog_object.records.get(args['id']).destroy
+    end
+  end
+end

data/lib/cloud_interactor/domain/list.rb

@@ -0,0 +1,9 @@
+class CloudInteractor
+  class Domain
+    def list args={}, output=true
+      @classes['helper'].generic_list_call 'zones', RESOURCE, output
+
+      @main_obj[IDENTITY] = @main_obj['zones']
+    end
+  end
+end

data/lib/cloud_interactor/domain/list_records.rb

@@ -0,0 +1,22 @@
+class CloudInteractor
+  class Domain
+    def list_records args, output=false
+      puts "Querying #{ args["domain"] } for rackspace..."
+
+      specific_fog_object = @classes['auth'].auth_service(RESOURCE).instance_eval('zones').get @main_obj["specific_#{ IDENTITY }"].last['id']
+
+      @main_obj['specific_records'] ||= {}
+      @main_obj['specific_records'][args[IDENTITY.singularize]]  ||= []
+      @main_obj["specific_#{ IDENTITY }"].last['records'] ||= []
+
+      specific_fog_object.records.each do |record|
+        record_obj = JSON.parse(record.to_json)
+
+        @main_obj["specific_#{ IDENTITY }"].last['records'] << record_obj
+        @main_obj['specific_records'][args[IDENTITY.singularize]]  << record_obj
+      end
+
+      ap(@main_obj["specific_#{ IDENTITY }"].last['records']) if output
+    end
+  end
+end

data/lib/cloud_interactor/domain/read.rb

@@ -0,0 +1,23 @@
+class CloudInteractor
+  class Domain
+    def read args={}, output=true
+      list [], false
+
+      @classes['helper'].generic_read_parse args, IDENTITY, output, IDENTITY.singularize
+
+      @main_obj["specific_#{ IDENTITY }"] ||= {}
+
+      specific_identity = @classes['helper'].set_specific_identity args, IDENTITY.singularize
+
+      @main_obj[IDENTITY].each do |identity_hash|
+        next if !specific_identity.nil? && !identity_hash[IDENTITY.singularize].include?(specific_identity)
+
+        self.list_records identity_hash
+      end
+
+      ap(@main_obj["specific_#{ IDENTITY }"]) if output
+
+      puts("#{ specific_identity } not found in #{ IDENTITY }!") if @main_obj["specific_#{ IDENTITY }"].empty?
+    end
+  end
+end

data/lib/cloud_interactor/domain/read_record.rb

@@ -0,0 +1,27 @@
+class CloudInteractor
+  class Domain
+    def read_record args, output=true, strict_match=false
+
+      specific_record = args['subdomain']
+
+      read args, false
+
+      @main_obj['specific_records'][args[IDENTITY.singularize]].each do |record_hash|
+        if strict_match
+          next unless record_hash['name'] == (specific_record)
+        else
+          next unless record_hash['name'].include?(specific_record)
+        end
+
+        @main_obj['specific_queried_domains'] ||= {}
+
+        @main_obj['specific_queried_domains'][args[IDENTITY.singularize]] ||= []
+        @main_obj['specific_queried_domains'][args[IDENTITY.singularize]]  << record_hash
+
+        ap(record_hash) if output
+      end
+
+      puts("#{ args[IDENTITY.singularize] } does not have the subdomain #{ args['subdomain'] }!") if @main_obj["specific_queried_domains"].nil?
+    end
+  end
+end

data/lib/cloud_interactor/domain/update.rb

@@ -0,0 +1,18 @@
+#TODO Grant more options to update?
+class CloudInteractor
+  class Domain
+    def update args
+      read args, false
+
+      if (@main_obj["specific_#{ IDENTITY }"].nil? || @main_obj["specific_#{ IDENTITY }"].empty?) && @main_obj["specific_#{ IDENTITY }"].last[IDENTITY.singularize] != args[IDENTITY.singularize]
+        puts "#{ IDENTITY } #{ args[IDENTITY.singularize] } doesn't exist... returning."
+
+        return false
+      end
+
+      @classes['auth'].auth_service(resource).instance_eval('zones').get(@main_obj["specific_#{ IDENTITY }"].last['id']).update(ttl: 5, email: @auth_hash['cloud_auth'][@options['preferred_cloud']]['email'])
+
+      puts "Updated #{ IDENTITY } #{ args[IDENTITY.singularize] }..."
+    end
+  end
+end

data/lib/cloud_interactor/domain/update_record.rb

@@ -0,0 +1,42 @@
+class CloudInteractor
+  class Domain
+    def update_record args, already_created=false
+      args['type'] ||= 'A'
+      args['ttl']  ||= 300
+
+      read args, false
+
+      puts "Updating #{ args['subdomain'] } for #{ args[IDENTITY.singularize] }..."
+
+      @main_obj['specific_records'][args[IDENTITY.singularize]].each do |record_hash|
+        already_created = true if record_hash['name'] == "#{ args['subdomain'] }.#{ args[IDENTITY.singularize] }"
+
+        args['id'] = record_hash['id']
+
+        break if already_created
+      end
+
+      if already_created
+        specific_fog_object = @classes['auth'].auth_service(RESOURCE).instance_eval('zones').get @main_obj["specific_#{ IDENTITY }"].last['id']
+
+        #the fact that there is no public update method is silly
+        specific_record = specific_fog_object.records.get(args['id'])
+
+        case @options['preferred_cloud']
+        when 'rackspace'
+          specific_record.type  = args['type']
+          specific_record.value = args['target_ip']
+          specific_record.ttl   = args['ttl']
+
+          specific_record.save
+        else
+          raise "Unsupported action #{ __method__ } for #{ @options['preferred_cloud'] }. Please create an issue on github or submit a PR to fix this issue."
+        end
+
+        puts "Updated #{ args['subdomain'] } (#{ args['target_ip'] }) to #{ args[IDENTITY.singularize] }..."
+      else
+        create_record [ args ]
+      end
+    end
+  end
+end

data/lib/cloud_interactor/domain.rb

@@ -0,0 +1,18 @@
+
+class CloudInteractor
+  class Domain #http://docs.rackspace.com/cdns/api/v1.0/cdns-devguide/content/API_Operations_Wadl-d1e2648.html
+    IDENTITY = 'domains'
+    RESOURCE = 'DNS'
+
+    def initialize main_obj, auth_hash, classes, options={} 
+      @main_obj  = main_obj
+      @auth_hash = auth_hash
+      @options   = options
+      @classes   = classes
+    end
+    
+    def run method, args
+      self.send(method, args)
+    end
+  end
+end

data/lib/cloud_interactor/flavor.rb

@@ -0,0 +1,27 @@
+
+class CloudInteractor
+  class Flavor #http://docs.rackspace.com/servers/api/v2/cs-devguide/content/List_Flavors-d1e4188.html
+    IDENTITY = 'flavors'
+    RESOURCE = 'compute'
+
+    def initialize main_obj, classes, options={} 
+      @main_obj  = main_obj
+      @options   = options
+      @classes   = classes
+    end
+    
+    def run method, args
+      self.send(method, args)
+    end
+
+    def list args={}, output=true
+      @classes['helper'].generic_list_call IDENTITY, RESOURCE, output
+    end
+
+    def read args, output=true
+      list [], false
+
+      @classes['helper'].generic_read_parse args, IDENTITY, output
+    end
+  end
+end

data/lib/cloud_interactor/helpers.rb

@@ -0,0 +1,70 @@
+class CloudInteractor
+  class Helper
+    def initialize main_obj, classes, options={}
+      @main_obj  = main_obj
+      @options   = options
+      @classes   = classes
+    end
+
+    def set_specific_identity args, key_to_extract
+      case args.class.to_s
+      when "Hash"   then args[key_to_extract]
+      when "String" then args
+      end
+    end
+
+    def generic_list_call identity, resource, output=true
+      puts "Returning list of #{ identity } for #{ @options['preferred_cloud'] }..."
+
+      @main_obj[identity] = JSON.parse(@classes['auth'].auth_service(resource).instance_eval(identity).to_json)
+
+      ap(@main_obj[identity]) if output && !@options['in_scaling']
+    end
+
+    def generic_read_parse args, identity, output=true, mode='name', search_key='name'
+      search_key = mode if mode != 'name' && search_key == 'name'
+
+      specific_identity = set_specific_identity args, search_key
+
+      @main_obj["specific_#{ identity }"] ||= []
+
+      @main_obj[identity].each do |identity_hash|
+        if specific_identity.nil?
+          puts("Query arguments \"#{ args }\" are not being mapped correctly for #{ identity.singularize } reads from method #{ caller[3][/`.*'/][1..-2] }! This read will return no objects.")
+        
+          break
+        end
+
+        next if identity_hash[mode] && !identity_hash[mode].include?(specific_identity)
+        next if identity == 'servers' && identity_hash['state'] == 'DELETED' #FOR SOME REASON you will get status 'DELETED' items on reads sometimes for rackspace servers
+
+        case identity
+        when 'image' then @main_obj["specific_#{ identity }"] << identity_hash unless identity_hash[mode].include?(@options['virtualization_mode'])
+        else              @main_obj["specific_#{ identity }"] << identity_hash
+        end
+
+        ap(identity_hash) if output
+      end
+
+      puts("#{ specific_identity } not found in #{ identity }!") if @main_obj["specific_#{ identity }"].empty?
+    end
+
+    def generic_destroy_parse destroy_hash, identity, resource, mode='name'
+      puts("Queried #{ identity } #{ ap @main_obj["specific_#{ identity }"] }") if @options['verbose']
+
+      raise "#{ identity.singularize } not found for #{ destroy_hash[mode] }" unless @main_obj["specific_#{ identity }"]
+
+      if destroy_hash[mode].empty? || @main_obj["specific_#{ identity }"].last[mode] != destroy_hash[mode] #without this it will delete the first object in the list, this is obviously bad
+        raise "Name mismatch on destroy! Expected #{ destroy_hash[mode] } and was going to destroy #{ @main_obj["specific_#{ identity }"].last[mode] }"
+      end
+
+      puts "Destroying #{ destroy_hash[mode] }..."
+
+      specific_fog_object = @classes['auth'].auth_service(resource).instance_eval(identity).get @main_obj["specific_#{ identity }"].last['id']
+
+      @main_obj["#{ identity }_destroy_request"] = specific_fog_object.destroy
+
+      puts "REMINDER! This destroy is not instant! It can take up to a few minutes for a #{ identity.singularize } to actually be fully destroyed!"
+    end
+  end
+end

data/lib/cloud_interactor/image.rb

@@ -0,0 +1,27 @@
+
+class CloudInteractor
+  class Image #http://docs.rackspace.com/servers/api/v2/cs-devguide/content/List_Images-d1e4435.html
+    IDENTITY = 'images'
+    RESOURCE = 'compute'
+
+    def initialize main_obj, classes, options={} 
+      @main_obj  = main_obj
+      @options   = options
+      @classes   = classes
+    end
+    
+    def run method, args
+      self.send(method, args)
+    end
+
+    def list args, output=true
+      @classes['helper'].generic_list_call IDENTITY, RESOURCE, output
+    end
+
+    def read args, output=true
+      list [], false
+
+      @classes['helper'].generic_read_parse args, IDENTITY, output
+    end
+  end
+end

data/lib/cloud_interactor/parser.rb

@@ -0,0 +1,37 @@
+class CloudInteractor
+  def parse_args args, final_args={}
+    #example args: domain "create:mydomain.us:23.253.44.192:my"
+
+    raise "This class does not support #{ args[0] } at this time" unless ALLOWED_HLMS.include?(args[0])
+
+    @classes[args[0]].send(:run, args[1].split(':').first, parse_args_hash(args))
+  end
+
+  def parse_args_hash args, hash_args={}
+    prep_args = args[1].split(':')
+
+    hash_args[prep_args[0]] = {}
+
+    if prep_args.count > 1
+      prep_args[1..(prep_args.count-1)].each do |arg|
+        hash_args[prep_args[0]][prep_args.index(arg)] = arg
+      end
+    else
+      hash_args[prep_args[0]]['type'] = prep_args[0]
+    end
+
+    mappings = case
+               #this case should always be first or else "server" case overrides
+               when prep_args[0] =~ /attach_volume|detach_volume|list_volumes|read_volume/ then { 1 => "server_name", 2 => "volume_name", 3 => "size", 4 => "device_location", 5 => 'volume_type'}
+               #remap the args from generic args to ones specific for a case
+               when args[0] =~ /domain/                                                    then { 1 => "domain", 2 => "subdomain", 3 => "target_ip", 4 => 'type' }
+               when args[0] =~ /server/                                                    then { 1 => "name", 2 => "flavor" }
+               when args[0] =~ /volume/                                                    then { 1 => "display_name", 2 => "size", 3 => 'volume_type' }
+               when args[0] =~ /flavor/                                                    then { 1 => "name" }
+               when args[0] =~ /image/                                                     then { 1 => "name" }
+               else raise "FATAL! Unsupported High Level Class #{ args[0] } for CloudInteractor! Please raise an issue on github with this stacktrace! args:#{ args }"
+               end 
+
+    Hash[hash_args[hash_args.keys.first].map {|k,v| [mappings[k], v]}]
+  end
+end