Class: RemoteExecutionProvider

Inherits:
Object
  • Object
show all
Defined in:
app/models/remote_execution_provider.rb

Direct Known Subclasses

ScriptExecutionProvider

Constant Summary collapse

EFFECTIVE_USER_METHODS = 
%w[sudo dzdo su].freeze

Class Method Summary collapse

Class Method Details

.alternative_names(host) ⇒ Object 



152
153
154
 
# File 'app/models/remote_execution_provider.rb', line 152

def alternative_names(host)
  { :fqdn => find_fqdn(effective_interfaces(host)) }
end

.cleanup_working_dirs?(host) ⇒ Boolean

Returns:

  • (Boolean) 


71
72
73
74
 
# File 'app/models/remote_execution_provider.rb', line 71

def cleanup_working_dirs?(host)
  setting = host_setting(host, :remote_execution_cleanup_working_dirs)
  [true, 'true', 'True', 'TRUE', '1'].include?(setting)
end

.effective_interfaces(host) ⇒ Object 



80
81
82
83
84
85
86
 
# File 'app/models/remote_execution_provider.rb', line 80

def effective_interfaces(host)
  interfaces = []
  %w(execution primary provision).map do |flag|
    interfaces << host.send(flag + '_interface')
  end
  interfaces.compact.uniq
end

.effective_user(template_invocation) ⇒ Object 



58
59
60
 
# File 'app/models/remote_execution_provider.rb', line 58

def effective_user(template_invocation)
  template_invocation.effective_user
end

.effective_user_method(host) ⇒ Object 



62
63
64
65
66
67
68
69
 
# File 'app/models/remote_execution_provider.rb', line 62

def effective_user_method(host)
  method = host_setting(host, :remote_execution_effective_user_method)
  unless EFFECTIVE_USER_METHODS.include?(method)
    raise _('Effective user method "%{current_value}" is not one of %{valid_methods}') %
      { :current_value => method, :valid_methods => EFFECTIVE_USER_METHODS}
  end
  method
end

.effective_user_password(host) ⇒ Object 



76
77
78
 
# File 'app/models/remote_execution_provider.rb', line 76

def effective_user_password(host)
  host_setting(host, :remote_execution_effective_user_password)
end

.find_fqdn(interfaces) ⇒ Object 



107
108
109
 
# File 'app/models/remote_execution_provider.rb', line 107

def find_fqdn(interfaces)
  interfaces.find { |i| i.fqdn.present? }.try(:fqdn)
end

.find_ip(host, interfaces) ⇒ Object 



94
95
96
97
98
99
100
101
102
103
104
105
 
# File 'app/models/remote_execution_provider.rb', line 94

def find_ip(host, interfaces)
  if host_setting(host, :remote_execution_connect_by_ip)
    ip4_address = interfaces.find { |i| i.ip.present? }.try(:ip)
    ip6_address = interfaces.find { |i| i.ip6.present? }.try(:ip6)

    if host_setting(host, :remote_execution_connect_by_ip_prefer_ipv6)
      ip6_address || ip4_address
    else
      ip4_address || ip6_address
    end
  end
end

.find_ip_or_hostname(host) ⇒ Object 



88
89
90
91
92
 
# File 'app/models/remote_execution_provider.rb', line 88

def find_ip_or_hostname(host)
  interfaces = effective_interfaces host

  find_ip(host, interfaces) || find_fqdn(interfaces) || raise(_('Could not find any suitable interface for execution'))
end

.host_setting(host, setting) ⇒ Object 



111
112
113
114
 
# File 'app/models/remote_execution_provider.rb', line 111

def host_setting(host, setting)
  param_value = host.host_param(setting.to_s)
  param_value.nil? ? Setting[setting] : param_value
end

.humanized_name ⇒ Object 



47
48
49
 
# File 'app/models/remote_execution_provider.rb', line 47

def humanized_name
  self.name
end

.provider_for(type) ⇒ Object 



6
7
8
 
# File 'app/models/remote_execution_provider.rb', line 6

def provider_for(type)
  providers[type.to_s] || providers[:script]
end

.provider_input_namespace ⇒ Object 



51
52
 
# File 'app/models/remote_execution_provider.rb', line 51

def provider_input_namespace
end

.provider_inputs ⇒ Object 



122
123
124
 
# File 'app/models/remote_execution_provider.rb', line 122

def provider_inputs
  []
end

.provider_inputs_doc ⇒ Object 



126
127
128
 
# File 'app/models/remote_execution_provider.rb', line 126

def provider_inputs_doc
  {}
end

.provider_names ⇒ Object 



27
28
29
 
# File 'app/models/remote_execution_provider.rb', line 27

def provider_names
  providers.keys.map(&:to_s)
end

.provider_proxy_features ⇒ Object 



31
32
33
 
# File 'app/models/remote_execution_provider.rb', line 31

def provider_proxy_features
  providers.values.map(&:proxy_feature).flatten.uniq.compact
end

.providers ⇒ Object 



19
20
21
 
# File 'app/models/remote_execution_provider.rb', line 19

def providers
  @providers ||= { }.with_indifferent_access
end

.proxy_action_class ⇒ Object 



134
135
136
 
# File 'app/models/remote_execution_provider.rb', line 134

def proxy_action_class
  'Proxy::RemoteExecution::Ssh::Actions::RunScript'
end

.proxy_batch_size ⇒ Object 



138
139
140
 
# File 'app/models/remote_execution_provider.rb', line 138

def proxy_batch_size
  Setting['foreman_tasks_proxy_batch_size']
end

.proxy_command_options(template_invocation, host) ⇒ Object 



35
36
37
 
# File 'app/models/remote_execution_provider.rb', line 35

def proxy_command_options(template_invocation, host)
  {:proxy_operation_name => proxy_operation_name}.merge(proxy_command_provider_inputs(template_invocation))
end

.proxy_command_provider_inputs(template_invocation) ⇒ Object 



130
131
132
 
# File 'app/models/remote_execution_provider.rb', line 130

def proxy_command_provider_inputs(template_invocation)
  {}
end

.proxy_feature ⇒ Object 



15
16
17
 
# File 'app/models/remote_execution_provider.rb', line 15

def proxy_feature
  registered_name
end

.proxy_operation_name ⇒ Object 



43
44
45
 
# File 'app/models/remote_execution_provider.rb', line 43

def proxy_operation_name
  'ssh'
end

.register(key, klass) ⇒ Object 



23
24
25
 
# File 'app/models/remote_execution_provider.rb', line 23

def register(key, klass)
  providers[key.to_sym] = klass
end

.registered_name ⇒ Object 



10
11
12
13
 
# File 'app/models/remote_execution_provider.rb', line 10

def registered_name
  klass = self
  providers.key(klass)
end

.required_proxy_selector_for(template) ⇒ Object

Return a specific proxy selector to use for running a given template Returns either nil to use the default selector or an instance of a (sub)class of ::ForemanTasks::ProxySelector



144
145
146
147
148
149
150
 
# File 'app/models/remote_execution_provider.rb', line 144

def required_proxy_selector_for(template)
  if template.remote_execution_features
             .where(:proxy_selector_override => ::RemoteExecutionProxySelector::INTERNAL_PROXY)
             .any?
    ::DefaultProxyProxySelector.new
  end
end

.secrets(_host) ⇒ Object 



39
40
41
 
# File 'app/models/remote_execution_provider.rb', line 39

def secrets(_host)
  {}
end

.ssh_key_passphrase(_host) ⇒ Object 



119
120
 
# File 'app/models/remote_execution_provider.rb', line 119

def ssh_key_passphrase(_host)
end

.ssh_password(_host) ⇒ Object 



116
117
 
# File 'app/models/remote_execution_provider.rb', line 116

def ssh_password(_host)
end

.supports_effective_user? ⇒ Boolean

Returns:

  • (Boolean) 


54
55
56
 
# File 'app/models/remote_execution_provider.rb', line 54

def supports_effective_user?
  false
end