Class: Fog::Compute::OpenStack::Server

Inherits:
Server show all
Defined in:
lib/fog/openstack/models/compute/server.rb

Instance Attribute Summary collapse

Attributes inherited from Server

#private_key, #private_key_path, #public_key, #public_key_path, #ssh_port, #username

Attributes inherited from Model

#collection, #service

Instance Method Summary collapse

Methods inherited from Server

#scp, #scp_download, #ssh, #sshable?

Methods inherited from Model

#inspect, #symbolize_keys, #to_json, #wait_for

Methods included from Attributes::ClassMethods

#_load, #aliases, #attribute, #attributes, #identity, #ignore_attributes, #ignored_attributes

Methods included from Fog::Core::DeprecatedConnectionAccessors

#connection, #connection=, #prepare_service_value

Methods included from Attributes::InstanceMethods

#_dump, #attributes, #dup, #identity, #identity=, #merge_attributes, #new_record?, #persisted?, #requires, #requires_one

Constructor Details

#initialize(attributes = {}) ⇒ Server

Returns a new instance of Server.



46
47
48
49
50
51
52
53
54
55
56
57
 
# File 'lib/fog/openstack/models/compute/server.rb', line 46

def initialize(attributes={})
  # Old 'connection' is renamed as service and should be used instead
  prepare_service_value(attributes)

  self.security_groups = attributes.delete(:security_groups)
  self.min_count = attributes.delete(:min_count)
  self.max_count = attributes.delete(:max_count)
  self.nics = attributes.delete(:nics)
  self.os_scheduler_hints = attributes.delete(:os_scheduler_hints)

  super
end

Instance Attribute Details

#flavor_ref ⇒ Object 



135
136
137
 
# File 'lib/fog/openstack/models/compute/server.rb', line 135

def flavor_ref
  @flavor_ref
end

#image_ref ⇒ Object 



127
128
129
 
# File 'lib/fog/openstack/models/compute/server.rb', line 127

def image_ref
  @image_ref
end

#nics=(value) ⇒ Object (writeonly)

Sets the attribute nics

Parameters:

  • value —

    the value to set the attribute nics to.



43
44
45
 
# File 'lib/fog/openstack/models/compute/server.rb', line 43

def nics=(value)
  @nics = value
end

#os_scheduler_hints=(value) ⇒ Object (writeonly)

Sets the attribute os_scheduler_hints

Parameters:

  • value —

    the value to set the attribute os_scheduler_hints to.



43
44
45
 
# File 'lib/fog/openstack/models/compute/server.rb', line 43

def os_scheduler_hints=(value)
  @os_scheduler_hints = value
end

#password ⇒ Object (readonly)

Returns the value of attribute password.



42
43
44
 
# File 'lib/fog/openstack/models/compute/server.rb', line 42

def password
  @password
end

Instance Method Details

#all_addresses ⇒ Object 



90
91
92
93
94
 
# File 'lib/fog/openstack/models/compute/server.rb', line 90

def all_addresses
  # currently openstack API does not tell us what is a floating ip vs a fixed ip for the vm listing,
  # we fall back to get all addresses and filter sadly.
  @all_addresses ||= service.list_all_addresses.body["floating_ips"].select{|data| data['instance_id'] == id}
end

#associate_address(floating_ip) ⇒ Object 



219
220
221
222
 
# File 'lib/fog/openstack/models/compute/server.rb', line 219

def associate_address(floating_ip)
  requires :id
  service.associate_address id, floating_ip
end

#attach_volume(volume_id, device_name) ⇒ Object 



258
259
260
261
262
 
# File 'lib/fog/openstack/models/compute/server.rb', line 258

def attach_volume(volume_id, device_name)
  requires :id
  service.attach_volume(volume_id, id, device_name)
  true
end

#change_password(admin_password) ⇒ Object 



147
148
149
150
151
 
# File 'lib/fog/openstack/models/compute/server.rb', line 147

def change_password(admin_password)
  requires :id
  service.change_server_password(id, admin_password)
  true
end

#confirm_resize ⇒ Object 



171
172
173
174
175
 
# File 'lib/fog/openstack/models/compute/server.rb', line 171

def confirm_resize
  requires :id
  service.confirm_resize_server(id)
  true
end

#console(log_length = nil) ⇒ Object 



204
205
206
207
 
# File 'lib/fog/openstack/models/compute/server.rb', line 204

def console(log_length = nil)
  requires :id
  service.get_console_output(id, log_length)
end

#create_image(name, metadata = {}) ⇒ Object 



199
200
201
202
 
# File 'lib/fog/openstack/models/compute/server.rb', line 199

def create_image(name, metadata={})
  requires :id
  service.create_image(id, name, metadata)
end

#destroy ⇒ Object 



79
80
81
82
83
 
# File 'lib/fog/openstack/models/compute/server.rb', line 79

def destroy
  requires :id
  service.delete_server(id)
  true
end

#detach_volume(volume_id) ⇒ Object 



264
265
266
267
268
 
# File 'lib/fog/openstack/models/compute/server.rb', line 264

def detach_volume(volume_id)
  requires :id
  service.detach_volume(id, volume_id)
  true
end

#disassociate_address(floating_ip) ⇒ Object 



224
225
226
227
 
# File 'lib/fog/openstack/models/compute/server.rb', line 224

def disassociate_address(floating_ip)
  requires :id
  service.disassociate_address id, floating_ip
end

#floating_ip_address ⇒ Object Also known as: public_ip_address 



113
114
115
 
# File 'lib/fog/openstack/models/compute/server.rb', line 113

def floating_ip_address
  floating_ip_addresses.first
end

#floating_ip_addresses ⇒ Object Also known as: public_ip_addresses 



107
108
109
 
# File 'lib/fog/openstack/models/compute/server.rb', line 107

def floating_ip_addresses
  all_addresses.map{|addr| addr["ip"]}
end

#images ⇒ Object 



85
86
87
88
 
# File 'lib/fog/openstack/models/compute/server.rb', line 85

def images
  requires :id
  service.images(:server => self)
end

#ip_addresses ⇒ Object

returns all ip_addresses for a given instance this includes both the fixed ip(s) and the floating ip(s)



103
104
105
 
# File 'lib/fog/openstack/models/compute/server.rb', line 103

def ip_addresses
  addresses.values.flatten.map{|x| x['addr']}
end

#live_migrate(host, block_migration, disk_over_commit) ⇒ Object 



214
215
216
217
 
# File 'lib/fog/openstack/models/compute/server.rb', line 214

def live_migrate(host, block_migration, disk_over_commit)
  requires :id
  service.live_migrate_server(id, host, block_migration, disk_over_commit)
end

#max_count=(new_max_count) ⇒ Object 



238
239
240
 
# File 'lib/fog/openstack/models/compute/server.rb', line 238

def max_count=(new_max_count)
  @max_count = new_max_count
end

#metadata ⇒ Object 



59
60
61
62
63
64
65
66
 
# File 'lib/fog/openstack/models/compute/server.rb', line 59

def metadata
  @metadata ||= begin
    Fog::Compute::OpenStack::Metadata.new({
      :service => service,
      :parent => self
    })
  end
end

#metadata=(new_metadata = {}) ⇒ Object 



68
69
70
71
72
73
 
# File 'lib/fog/openstack/models/compute/server.rb', line 68

def metadata=(new_metadata={})
  return unless new_metadata
  metas = []
  new_metadata.each_pair {|k,v| metas << {"key" => k, "value" => v} }
  @metadata = metadata.load(metas)
end

#migrate ⇒ Object 



209
210
211
212
 
# File 'lib/fog/openstack/models/compute/server.rb', line 209

def migrate
  requires :id
  service.migrate_server(id)
end

#min_count=(new_min_count) ⇒ Object 



234
235
236
 
# File 'lib/fog/openstack/models/compute/server.rb', line 234

def min_count=(new_min_count)
  @min_count = new_min_count
end

#networks ⇒ Object 



242
243
244
 
# File 'lib/fog/openstack/models/compute/server.rb', line 242

def networks
  service.networks(:server => self)
end

#private_ip_address ⇒ Object 



123
124
125
 
# File 'lib/fog/openstack/models/compute/server.rb', line 123

def private_ip_address
  private_ip_addresses.first
end

#private_ip_addresses ⇒ Object 



119
120
121
 
# File 'lib/fog/openstack/models/compute/server.rb', line 119

def private_ip_addresses
  ip_addresses - floating_ip_addresses
end

#ready? ⇒ Boolean

Returns:

  • (Boolean) 


143
144
145
 
# File 'lib/fog/openstack/models/compute/server.rb', line 143

def ready?
  self.state == 'ACTIVE'
end

#reboot(type = 'SOFT') ⇒ Object 



193
194
195
196
197
 
# File 'lib/fog/openstack/models/compute/server.rb', line 193

def reboot(type = 'SOFT')
  requires :id
  service.reboot_server(id, type)
  true
end

#rebuild(image_ref, name, admin_pass = nil, metadata = nil, personality = nil) ⇒ Object 



153
154
155
156
157
 
# File 'lib/fog/openstack/models/compute/server.rb', line 153

def rebuild(image_ref, name, admin_pass=nil, metadata=nil, personality=nil)
  requires :id
  service.rebuild_server(id, image_ref, name, admin_pass, metadata, personality)
  true
end

#reload ⇒ Object 



96
97
98
99
 
# File 'lib/fog/openstack/models/compute/server.rb', line 96

def reload
  @all_addresses = nil
  super
end

#reset_vm_state(vm_state) ⇒ Object 



229
230
231
232
 
# File 'lib/fog/openstack/models/compute/server.rb', line 229

def reset_vm_state(vm_state)
  requires :id
  service.reset_server_state id, vm_state
end

#resize(flavor_ref) ⇒ Object 



159
160
161
162
163
 
# File 'lib/fog/openstack/models/compute/server.rb', line 159

def resize(flavor_ref)
  requires :id
  service.resize_server(id, flavor_ref)
  true
end

#revert_resize ⇒ Object 



165
166
167
168
169
 
# File 'lib/fog/openstack/models/compute/server.rb', line 165

def revert_resize
  requires :id
  service.revert_resize_server(id)
  true
end

#save ⇒ Object

TODO: Implement /os-volumes-boot support with ‘block_device_mapping’

Raises:



271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
 
# File 'lib/fog/openstack/models/compute/server.rb', line 271

def save
  raise Fog::Errors::Error.new('Resaving an existing object may create a duplicate') if persisted?
  requires :flavor_ref, :image_ref, :name
  options = {
    'personality' => personality,
    'accessIPv4' => accessIPv4,
    'accessIPv6' => accessIPv6,
    'availability_zone' => availability_zone,
    'user_data' => user_data_encoded,
    'key_name'    => key_name,
    'security_groups' => @security_groups,
    'min_count'   => @min_count,
    'max_count'   => @max_count,
    'nics' => @nics,
    'os:scheduler_hints' => @os_scheduler_hints,
  }
  options['metadata'] = metadata.to_hash unless @metadata.nil?
  options = options.reject {|key, value| value.nil?}
  data = service.create_server(name, image_ref, flavor_ref, options)
  merge_attributes(data.body['server'])
  true
end

#security_groups ⇒ Object 



177
178
179
180
181
182
183
184
185
186
187
 
# File 'lib/fog/openstack/models/compute/server.rb', line 177

def security_groups
  requires :id

  groups = service.list_security_groups(id).body['security_groups']

  groups.map do |group|
    sg = Fog::Compute::OpenStack::SecurityGroup.new group
    sg.connection = service
    sg
  end
end

#security_groups=(new_security_groups) ⇒ Object 



189
190
191
 
# File 'lib/fog/openstack/models/compute/server.rb', line 189

def security_groups=(new_security_groups)
  @security_groups = new_security_groups
end

#setup(credentials = {}) ⇒ Object 



294
295
296
297
298
299
300
301
302
303
304
305
306
 
# File 'lib/fog/openstack/models/compute/server.rb', line 294

def setup(credentials = {})
  requires :public_ip_address, :identity, :public_key, :username
  Fog::SSH.new(public_ip_address, username, credentials).run([
    %{mkdir .ssh},
    %{echo "#{public_key}" >> ~/.ssh/authorized_keys},
    %{passwd -l #{username}},
    %{echo "#{Fog::JSON.encode(attributes)}" >> ~/attributes.json},
    %{echo "#{Fog::JSON.encode(metadata)}" >> ~/metadata.json}
  ])
rescue Errno::ECONNREFUSED
  sleep(1)
  retry
end

#user_data=(ascii_userdata) ⇒ Object 



75
76
77
 
# File 'lib/fog/openstack/models/compute/server.rb', line 75

def user_data=(ascii_userdata)
  self.user_data_encoded = [ascii_userdata].pack('m')
end

#volume_attachments ⇒ Object 



253
254
255
256
 
# File 'lib/fog/openstack/models/compute/server.rb', line 253

def volume_attachments
  requires :id
  service.get_server_volumes(id).body['volumeAttachments']
end

#volumes ⇒ Object 



246
247
248
249
250
251
 
# File 'lib/fog/openstack/models/compute/server.rb', line 246

def volumes
  requires :id
  service.volumes.find_all do |vol|
    vol.attachments.find { |attachment| attachment["serverId"] == id }
  end
end