Class: Bcome::Stack::Environment

Inherits:
Base show all
Includes:
BecomeObject, EnvironmentSSH, FogHelper, Functions, Bcome::Selections
Defined in:
lib/stack/environment.rb

Direct Known Subclasses

View

Constant Summary

Constants included from Functions

Functions::CONFIGS_PATH

Constants included from BecomeObject

BecomeObject::CONFIGS_PATH

Constants included from Orchestrator::Registry

Orchestrator::Registry::CONFIGS_PATH

Constants included from ContextFunctions

ContextFunctions::CONFIGS_PATH

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Methods included from Functions

#F, #cmd_config_path, #cmd_for_ref, #cmd_functions, #functions, #has_cmd_functions?, #has_functions_config?, #load_cmd_functions

Methods included from EnvironmentSSH

#bastion_ip_address, #bastion_server, #bootstrap_proxy_command, #execute_cmd, #execute_command, #execute_scp_download, #execute_scp_upload, #proxy, #proxy_command, #ssh_key_path, #ssh_mode_type, #ssh_mode_user, #ssh_nat_user, #ssh_user, #valid_ssh_modes

Methods included from FogHelper

#colour_code_for_server_status, #credentials_key, #ec2_filters, #ec2_tags, #filter_by_tags, #fog_client, #instance_matches_tags?, #reload!, #render_servers_not_returned_by_filtered_lookup, #servers, #servers_not_returned_by_filtered_lookup, #show_all_unfiltered_status?, #unfiltered_fog_lookup, #unfiltered_search_params, #unfiltered_servers

Methods included from Bcome::Selections

#add, #add!, #add_object, #clear!, #find_resource_by_identifier, #get, #in_resources?, #manage_object, #no_selections?, #no_selections_error, #object_in_selections?, #put, #remove, #remove_object, #run, #selections

Methods included from BecomeObject

#all_items, #become_identifier, #context_breadcrumb, #has_main_context?, #has_potential_resources?, #identifier_for, #is_stack_level_resource?, #list, #local_download_path, #main_context, #main_context=, #mini_list, #namespace, #previous_workspace_object, #previous_workspace_object=, #resources, #responds_to_list?

Methods inherited from Base

#available_resources_options_string, #become, #become_identifier, const_missing, #construct_node, #describe, #has_sub_nodes?, #highlight?, #init, #interactive, #machines, #menu, #method_missing, #node, #recipes, #respond_to_bcome_context_method?, #workon

Methods included from Orchestrator::Registry

#config_for_registry, #do_load_recipes, #has_registry_config?, #load_recipe_registry, #recipe_registry, #registry_configs_path

Methods included from CommandHelper

#run_local

Methods included from ContextFunctions

#command_for_context, #context_cmd_config_path, #context_cmd_functions, #context_commands, #execute_command_for_context, #has_context_cmd_functions?, #has_context_functions_config?, #load_context_cmd_functions

Constructor Details

#initialize(meta_data, parent) ⇒ Environment

Returns a new instance of Environment.



22
23
24
25
26
 
# File 'lib/stack/environment.rb', line 22

def initialize(meta_data, parent)
  @meta_data = meta_data
  @identifier = meta_data[:environment]
  @platform = parent
end

Dynamic Method Handling

This class handles dynamic methods through the method_missing method in the class Bcome::Stack::Base

Instance Attribute Details

#identifier ⇒ Object (readonly)

Returns the value of attribute identifier.



20
21
22
 
# File 'lib/stack/environment.rb', line 20

def identifier
  @identifier
end

#meta_data ⇒ Object (readonly)

Returns the value of attribute meta_data.



20
21
22
 
# File 'lib/stack/environment.rb', line 20

def meta_data
  @meta_data
end

#platform ⇒ Object (readonly)

Returns the value of attribute platform.



20
21
22
 
# File 'lib/stack/environment.rb', line 20

def platform
  @platform
end

Class Method Details

.collection_from_config(parent, configuration) ⇒ Object 



11
12
13
14
15
16
17
 
# File 'lib/stack/environment.rb', line 11

def collection_from_config(parent, configuration)
  collection = []
  configuration.each do |meta_data|
    collection << new(meta_data, parent) if meta_data[:network].to_s == parent.identifier.to_s 
  end
  return collection
end

Instance Method Details

#child_reference_key ⇒ Object 



128
129
130
 
# File 'lib/stack/environment.rb', line 128

def child_reference_key
  :environment 
end

#collection_key ⇒ Object 



132
133
134
 
# File 'lib/stack/environment.rb', line 132

def collection_key
  :instances
end

#collection_klass ⇒ Object 



120
121
122
 
# File 'lib/stack/environment.rb', line 120

def collection_klass
  ::INSTANCE_STACK_KLASS
end

#config_path ⇒ Object 



100
101
102
 
# File 'lib/stack/environment.rb', line 100

def config_path
  "#{CONFIGS_PATH}/static_instances/#{platform.identifier}_#{identifier}-instances.yml"
end

#description ⇒ Object 



108
109
110
111
112
113
114
115
116
117
118
 
# File 'lib/stack/environment.rb', line 108

def description
  desc = "\tNode Id:".menu_item_cyan + "\s#{node.identifier}".menu_item_green + "\n"
  desc += "\tNet Lookup:".menu_item_cyan + "\s#{node.network_lookup_type}".menu_item_white + "\n"
  desc += "\tSSH Mode:".menu_item_cyan + "\s#{node.ssh_mode_type}".menu_item_white
  if has_views?
    views.each do |view|
      desc += "\n\t \\ #{"view".menu_item_cyan}: #{view.identifier.menu_item_green}"
    end
  end
  return desc + "\n\n"
end

#do_create_views ⇒ Object 



64
65
66
67
68
69
70
71
 
# File 'lib/stack/environment.rb', line 64

def do_create_views
  return [] unless meta_data[:sub_views]
  view_collection = []
  meta_data[:sub_views].each do |sub_view_data|
    view_collection << ::Bcome::Stack::View.new(@meta_data, @platform, self, sub_view_data)
  end
  return view_collection
end

#do_describe ⇒ Object 



104
105
106
 
# File 'lib/stack/environment.rb', line 104

def do_describe
  description
end

#do_load_resources ⇒ Object 



89
90
91
92
93
94
95
96
97
98
 
# File 'lib/stack/environment.rb', line 89

def do_load_resources
 if dynamic_network_lookup? 
   return collection_klass.collection_from_fog_data(self, servers)
 else
   path = config_path
   raise "Missing instances.yml configuration for your environment. You've selected a static network lookup, and yet I cannot find #{config_path}".failure unless File.exist?(config_path)
   config = YAML.load_file(path)
   return collection_klass.collection_from_config(self, config)
 end
end

#dynamic_network_lookup? ⇒ Boolean

Returns:

  • (Boolean) 


151
152
153
 
# File 'lib/stack/environment.rb', line 151

def dynamic_network_lookup?
  return network_lookup_type == "dynamic"
end

#has_views? ⇒ Boolean

Returns:

  • (Boolean) 


32
33
34
 
# File 'lib/stack/environment.rb', line 32

def has_views?
  views.any?
end

#list_views ⇒ Object Also known as: lv 



36
37
38
39
40
41
42
 
# File 'lib/stack/environment.rb', line 36

def list_views
  if has_views?
    ::RENDER.list_items("Sub-views", views)
  else
    puts "\n" + "This environment has no configured sub-views".warning + "\n\n"
  end
end

#menu_items ⇒ Object 



73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
 
# File 'lib/stack/environment.rb', line 73

def menu_items
  super + [
    { :command => "add", :description => "Add a resource you wish to work on.", :usage => "add MyServerIdentifier, OR add [array, of, identifiers]" },
    { :command => "add!", :description => "Add all resources from the current context." },
    { :command => "remove", :description => "Remove a resource you no longer with to work on.", :usage => "remove MyServerIdentifier, OR remove [array, of, identifiers]" },
    { :command => "clear!", :description => "Remove all selected resources." },
    { :command => "selections", :description => "Show all added resources.", :usage => "selections / s"},
    { :command => "run", :description => "Execute a command on all selected resources", :usage => "run 'command'" },
    { :command => "get", :description => "Download from remote from all selected resources (recursive - uses rsync)", :usage => "get 'remote_path'" },
    { :command => "put", :description => "Copy files up to all selected resources (recursive - uses rsync)", :usage => "put 'local_path', 'remote_path'" },
    { :command => "sudo", :description => "Run 'get' and 'put' in sudo mode (assumes you have passwordless sudo setup)" },
    { :command => 'functions', :description => "List all available custom functions" },
    { :command => 'lv', :description => "List all configured sub-views" },
  ]
end

#network_lookup ⇒ Object 



140
141
142
143
 
# File 'lib/stack/environment.rb', line 140

def network_lookup
  raise "Missing network lookup in networks_environment configuration".failure unless @meta_data[:network_lookup]
  return @meta_data[:network_lookup]
end

#network_lookup_type ⇒ Object 



145
146
147
148
149
 
# File 'lib/stack/environment.rb', line 145

def network_lookup_type
  type = network_lookup[:type]
  raise "Unknown network lookup type '#{type}" unless ["dynamic", "static"].include?(type)
  return type
end

#node_level_klass ⇒ Object 



136
137
138
 
# File 'lib/stack/environment.rb', line 136

def node_level_klass
  ::Bcome::Node::Environment
end

#reference_key ⇒ Object 



124
125
126
 
# File 'lib/stack/environment.rb', line 124

def reference_key
  :environments
end

#resource_for_identifier(identifier) ⇒ Object 



53
54
55
56
57
58
59
60
61
62
 
# File 'lib/stack/environment.rb', line 53

def resource_for_identifier(identifier)
  match = super
  unless match
    # Unless we've found a match amongst our server instances, look in our views
    matches = views.select {|view| view.identifier.to_sym == identifier.to_sym }
    raise "Retrieved more than one match for #{collection_key} '#{identifier}'. Selection is ambiguous" if matches.size > 1
    match = matches.first
  end
  return match
end

#resource_identifiers ⇒ Object 



45
46
47
 
# File 'lib/stack/environment.rb', line 45

def resource_identifiers
  @resource_identifiers ||= resource_identifiers_with_views
end

#resource_identifiers_with_views ⇒ Object 



49
50
51
 
# File 'lib/stack/environment.rb', line 49

def resource_identifiers_with_views
  return has_views? ? (resources.collect(&:identifier) << views.collect(&:identifier)).flatten : resources.collect(&:identifier)
end

#sudo ⇒ Object 



155
156
157
 
# File 'lib/stack/environment.rb', line 155

def sudo
  toggle_sudo
end

#views ⇒ Object 



28
29
30
 
# File 'lib/stack/environment.rb', line 28

def views
  @views ||= do_create_views
end