Class: Fog::Compute::OpenStack::Server
- Inherits:
-
Server
- Object
- Server
- Fog::Compute::OpenStack::Server
- Defined in:
- lib/fog/compute/openstack/models/server.rb
Instance Attribute Summary collapse
-
#block_device_mapping ⇒ Object
Returns the value of attribute block_device_mapping.
-
#block_device_mapping_v2 ⇒ Object
Returns the value of attribute block_device_mapping_v2.
-
#flavor_ref ⇒ Object
Returns the value of attribute flavor_ref.
-
#image_ref ⇒ Object
Returns the value of attribute image_ref.
-
#max_count ⇒ Object
writeonly
Sets the attribute max_count.
-
#min_count ⇒ Object
writeonly
Sets the attribute min_count.
-
#nics ⇒ Object
writeonly
Sets the attribute nics.
-
#os_scheduler_hints ⇒ Object
writeonly
Sets the attribute os_scheduler_hints.
-
#password ⇒ Object
readonly
Returns the value of attribute password.
-
#personality ⇒ Hash
Hash containing data to inject into the file system of the cloud server instance during server creation.
-
#project ⇒ Object
In some cases it’s handy to be able to store the project for the record, e.g.
- #security_groups ⇒ Object
Instance Method Summary collapse
- #all_addresses ⇒ Object
- #associate_address(floating_ip) ⇒ Object
- #attach_volume(volume_id, device_name) ⇒ Object
- #change_password(admin_password) ⇒ Object
- #confirm_resize ⇒ Object
- #console(log_length = nil) ⇒ Object
- #create_image(name, metadata = {}) ⇒ Object
- #destroy ⇒ Object
- #detach_volume(volume_id) ⇒ Object
- #disassociate_address(floating_ip) ⇒ Object
- #evacuate(host = nil, on_shared_storage = nil, admin_password = nil) ⇒ Object
- #failed? ⇒ Boolean
- #floating_ip_address ⇒ Object
- #floating_ip_addresses ⇒ Object
- #images ⇒ Object
-
#initialize(attributes = {}) ⇒ Server
constructor
A new instance of Server.
-
#ip_addresses ⇒ Object
returns all ip_addresses for a given instance this includes both the fixed ip(s) and the floating ip(s).
- #live_migrate(host, block_migration, disk_over_commit) ⇒ Object
- #metadata ⇒ Object
- #metadata=(new_metadata = {}) ⇒ Object
- #migrate ⇒ Object
- #networks ⇒ Object
- #os_interfaces ⇒ Object
- #pause ⇒ Object
- #private_ip_address ⇒ Object
- #private_ip_addresses ⇒ Object
- #public_ip_address ⇒ Object
- #public_ip_addresses ⇒ Object
- #ready? ⇒ Boolean
- #reboot(type = 'SOFT') ⇒ Object
- #rebuild(image_ref, name, admin_pass = nil, metadata = nil, personality = nil) ⇒ Object
- #reload ⇒ Object
- #reset_vm_state(vm_state) ⇒ Object
- #resize(flavor_ref) ⇒ Object
- #revert_resize ⇒ Object
- #save ⇒ Object
- #setup(credentials = {}) ⇒ Object
- #shelve ⇒ Object
- #shelve_offload ⇒ Object
- #start ⇒ Object
- #stop ⇒ Object
- #suspend ⇒ Object
- #unshelve ⇒ Object
- #user_data=(ascii_userdata) ⇒ Object
- #volume_attachments ⇒ Object
- #volumes ⇒ Object
Constructor Details
#initialize(attributes = {}) ⇒ Server
Returns a new instance of Server.
60 61 62 63 64 65 66 67 68 69 70 71 72 73 |
# File 'lib/fog/compute/openstack/models/server.rb', line 60 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) self.block_device_mapping = attributes.delete(:block_device_mapping) self.block_device_mapping_v2 = attributes.delete(:block_device_mapping_v2) super end |
Instance Attribute Details
#block_device_mapping ⇒ Object
Returns the value of attribute block_device_mapping.
54 55 56 |
# File 'lib/fog/compute/openstack/models/server.rb', line 54 def block_device_mapping @block_device_mapping end |
#block_device_mapping_v2 ⇒ Object
Returns the value of attribute block_device_mapping_v2.
54 55 56 |
# File 'lib/fog/compute/openstack/models/server.rb', line 54 def block_device_mapping_v2 @block_device_mapping_v2 end |
#flavor_ref ⇒ Object
Returns the value of attribute flavor_ref.
187 188 189 |
# File 'lib/fog/compute/openstack/models/server.rb', line 187 def flavor_ref @flavor_ref end |
#image_ref ⇒ Object
Returns the value of attribute image_ref.
183 184 185 |
# File 'lib/fog/compute/openstack/models/server.rb', line 183 def image_ref @image_ref end |
#max_count=(value) ⇒ Object (writeonly)
Sets the attribute max_count
332 333 334 |
# File 'lib/fog/compute/openstack/models/server.rb', line 332 def max_count=(value) @max_count = value end |
#min_count=(value) ⇒ Object (writeonly)
Sets the attribute min_count
330 331 332 |
# File 'lib/fog/compute/openstack/models/server.rb', line 330 def min_count=(value) @min_count = value end |
#nics=(value) ⇒ Object (writeonly)
Sets the attribute nics
53 54 55 |
# File 'lib/fog/compute/openstack/models/server.rb', line 53 def nics=(value) @nics = value end |
#os_scheduler_hints=(value) ⇒ Object (writeonly)
Sets the attribute os_scheduler_hints
53 54 55 |
# File 'lib/fog/compute/openstack/models/server.rb', line 53 def os_scheduler_hints=(value) @os_scheduler_hints = value end |
#password ⇒ Object (readonly)
Returns the value of attribute password.
52 53 54 |
# File 'lib/fog/compute/openstack/models/server.rb', line 52 def password @password end |
#personality ⇒ Hash
This attribute is only used for server creation. This field will be nil on subsequent retrievals.
Returns Hash containing data to inject into the file system of the cloud server instance during server creation.
29 |
# File 'lib/fog/compute/openstack/models/server.rb', line 29 attribute :personality |
#project ⇒ Object
In some cases it’s handy to be able to store the project for the record, e.g. swift doesn’t contain project info in the result, so we can track it in this attribute based on what project was used in the request
58 59 60 |
# File 'lib/fog/compute/openstack/models/server.rb', line 58 def project @project end |
#security_groups ⇒ Object
229 230 231 232 233 234 235 236 237 |
# File 'lib/fog/compute/openstack/models/server.rb', line 229 def security_groups requires :id groups = service.list_security_groups(:server_id => id).body['security_groups'] groups.map do |group| Fog::Compute::OpenStack::SecurityGroup.new group.merge(:service => service) end end |
Instance Method Details
#all_addresses ⇒ Object
104 105 106 107 108 109 |
# File 'lib/fog/compute/openstack/models/server.rb', line 104 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. # Only includes manually-assigned addresses, not auto-assigned @all_addresses ||= service.list_all_addresses.body["floating_ips"].select { |data| data['instance_id'] == id } end |
#associate_address(floating_ip) ⇒ Object
315 316 317 318 |
# File 'lib/fog/compute/openstack/models/server.rb', line 315 def associate_address(floating_ip) requires :id service.associate_address id, floating_ip end |
#attach_volume(volume_id, device_name) ⇒ Object
350 351 352 353 354 |
# File 'lib/fog/compute/openstack/models/server.rb', line 350 def attach_volume(volume_id, device_name) requires :id service.attach_volume(volume_id, id, device_name) true end |
#change_password(admin_password) ⇒ Object
199 200 201 202 203 |
# File 'lib/fog/compute/openstack/models/server.rb', line 199 def change_password(admin_password) requires :id service.change_server_password(id, admin_password) true end |
#confirm_resize ⇒ Object
223 224 225 226 227 |
# File 'lib/fog/compute/openstack/models/server.rb', line 223 def confirm_resize requires :id service.confirm_resize_server(id) true end |
#console(log_length = nil) ⇒ Object
295 296 297 298 |
# File 'lib/fog/compute/openstack/models/server.rb', line 295 def console(log_length = nil) requires :id service.get_console_output(id, log_length) end |
#create_image(name, metadata = {}) ⇒ Object
290 291 292 293 |
# File 'lib/fog/compute/openstack/models/server.rb', line 290 def create_image(name, = {}) requires :id service.create_image(id, name, ) end |
#destroy ⇒ Object
93 94 95 96 97 |
# File 'lib/fog/compute/openstack/models/server.rb', line 93 def destroy requires :id service.delete_server(id) true end |
#detach_volume(volume_id) ⇒ Object
356 357 358 359 360 |
# File 'lib/fog/compute/openstack/models/server.rb', line 356 def detach_volume(volume_id) requires :id service.detach_volume(id, volume_id) true end |
#disassociate_address(floating_ip) ⇒ Object
320 321 322 323 |
# File 'lib/fog/compute/openstack/models/server.rb', line 320 def disassociate_address(floating_ip) requires :id service.disassociate_address id, floating_ip end |
#evacuate(host = nil, on_shared_storage = nil, admin_password = nil) ⇒ Object
310 311 312 313 |
# File 'lib/fog/compute/openstack/models/server.rb', line 310 def evacuate(host = nil, on_shared_storage = nil, admin_password = nil) requires :id service.evacuate_server(id, host, on_shared_storage, admin_password) end |
#failed? ⇒ Boolean
195 196 197 |
# File 'lib/fog/compute/openstack/models/server.rb', line 195 def failed? state == 'ERROR' end |
#floating_ip_address ⇒ Object
165 166 167 |
# File 'lib/fog/compute/openstack/models/server.rb', line 165 def floating_ip_address floating_ip_addresses.first end |
#floating_ip_addresses ⇒ Object
127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 |
# File 'lib/fog/compute/openstack/models/server.rb', line 127 def floating_ip_addresses all_floating = if addresses flattened_values = addresses.values.flatten flattened_values.select { |d| d["OS-EXT-IPS:type"] == "floating" }.collect { |a| a["addr"] } else [] end # Return them all, leading with manually assigned addresses manual = all_addresses.collect { |addr| addr["ip"] } all_floating.sort do |a, b| a_manual = manual.include? a b_manual = manual.include? b if a_manual && !b_manual -1 elsif !a_manual && b_manual 1 else 0 end end all_floating.empty? ? manual : all_floating end |
#images ⇒ Object
99 100 101 102 |
# File 'lib/fog/compute/openstack/models/server.rb', line 99 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)
123 124 125 |
# File 'lib/fog/compute/openstack/models/server.rb', line 123 def ip_addresses addresses ? addresses.values.flatten.collect { |x| x['addr'] } : [] end |
#live_migrate(host, block_migration, disk_over_commit) ⇒ Object
305 306 307 308 |
# File 'lib/fog/compute/openstack/models/server.rb', line 305 def live_migrate(host, block_migration, disk_over_commit) requires :id service.live_migrate_server(id, host, block_migration, disk_over_commit) end |
#metadata ⇒ Object
75 76 77 78 79 80 |
# File 'lib/fog/compute/openstack/models/server.rb', line 75 def @metadata ||= begin Fog::Compute::OpenStack::Metadata.new(:service => service, :parent => self) end end |
#metadata=(new_metadata = {}) ⇒ Object
82 83 84 85 86 87 |
# File 'lib/fog/compute/openstack/models/server.rb', line 82 def ( = {}) return unless = [] .each_pair { |k, v| << {"key" => k, "value" => v} } @metadata = .load() end |
#migrate ⇒ Object
300 301 302 303 |
# File 'lib/fog/compute/openstack/models/server.rb', line 300 def migrate requires :id service.migrate_server(id) end |
#networks ⇒ Object
334 335 336 |
# File 'lib/fog/compute/openstack/models/server.rb', line 334 def networks service.networks(:server => self) end |
#os_interfaces ⇒ Object
111 112 113 114 |
# File 'lib/fog/compute/openstack/models/server.rb', line 111 def os_interfaces requires :id service.os_interfaces(:server => self) end |
#pause ⇒ Object
252 253 254 255 |
# File 'lib/fog/compute/openstack/models/server.rb', line 252 def pause requires :id service.pause_server(id) end |
#private_ip_address ⇒ Object
179 180 181 |
# File 'lib/fog/compute/openstack/models/server.rb', line 179 def private_ip_address private_ip_addresses.first end |
#private_ip_addresses ⇒ Object
173 174 175 176 177 |
# File 'lib/fog/compute/openstack/models/server.rb', line 173 def private_ip_addresses rfc1918_regexp = /(^10\.|^172\.1[6-9]\.|^172\.2[0-9]\.|^172.3[0-1]\.|^192\.168\.)/ almost_private = ip_addresses - public_ip_addresses - floating_ip_addresses almost_private.select { |ip| rfc1918_regexp.match ip } end |
#public_ip_address ⇒ Object
169 170 171 |
# File 'lib/fog/compute/openstack/models/server.rb', line 169 def public_ip_address public_ip_addresses.first end |
#public_ip_addresses ⇒ Object
153 154 155 156 157 158 159 160 161 162 163 |
# File 'lib/fog/compute/openstack/models/server.rb', line 153 def public_ip_addresses if floating_ip_addresses.empty? if addresses addresses.select { |s| s[0] =~ /public/i }.collect { |a| a[1][0]['addr'] } else [] end else floating_ip_addresses end end |
#ready? ⇒ Boolean
191 192 193 |
# File 'lib/fog/compute/openstack/models/server.rb', line 191 def ready? state == 'ACTIVE' end |
#reboot(type = 'SOFT') ⇒ Object
241 242 243 244 245 |
# File 'lib/fog/compute/openstack/models/server.rb', line 241 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
205 206 207 208 209 |
# File 'lib/fog/compute/openstack/models/server.rb', line 205 def rebuild(image_ref, name, admin_pass = nil, = nil, personality = nil) requires :id service.rebuild_server(id, image_ref, name, admin_pass, , personality) true end |
#reload ⇒ Object
116 117 118 119 |
# File 'lib/fog/compute/openstack/models/server.rb', line 116 def reload @all_addresses = nil super end |
#reset_vm_state(vm_state) ⇒ Object
325 326 327 328 |
# File 'lib/fog/compute/openstack/models/server.rb', line 325 def reset_vm_state(vm_state) requires :id service.reset_server_state id, vm_state end |
#resize(flavor_ref) ⇒ Object
211 212 213 214 215 |
# File 'lib/fog/compute/openstack/models/server.rb', line 211 def resize(flavor_ref) requires :id service.resize_server(id, flavor_ref) true end |
#revert_resize ⇒ Object
217 218 219 220 221 |
# File 'lib/fog/compute/openstack/models/server.rb', line 217 def revert_resize requires :id service.revert_resize_server(id) true end |
#save ⇒ Object
362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385 386 387 |
# File 'lib/fog/compute/openstack/models/server.rb', line 362 def save raise Fog::Errors::Error, 'Resaving an existing object may create a duplicate' if persisted? requires :flavor_ref, :name requires_one :image_ref, :block_device_mapping, :block_device_mapping_v2 = { 'personality' => personality, 'accessIPv4' => accessIPv4, 'accessIPv6' => accessIPv6, 'availability_zone' => availability_zone, 'user_data' => user_data_encoded, 'key_name' => key_name, 'config_drive' => config_drive, 'security_groups' => @security_groups, 'min_count' => @min_count, 'max_count' => @max_count, 'nics' => @nics, 'os:scheduler_hints' => @os_scheduler_hints, 'block_device_mapping' => @block_device_mapping, 'block_device_mapping_v2' => @block_device_mapping_v2, } ['metadata'] = .to_hash unless @metadata.nil? = .reject { |_key, value| value.nil? } data = service.create_server(name, image_ref, flavor_ref, ) merge_attributes(data.body['server']) true end |
#setup(credentials = {}) ⇒ Object
389 390 391 392 393 394 395 396 397 398 399 400 401 402 |
# File 'lib/fog/compute/openstack/models/server.rb', line 389 def setup(credentials = {}) requires :ssh_ip_address, :identity, :public_key, :username ssh = Fog::SSH.new(ssh_ip_address, username, credentials) ssh.run([ %(mkdir .ssh), %(echo "#{public_key}" >> ~/.ssh/authorized_keys), %(passwd -l #{username}), %(echo "#{Fog::JSON.encode(attributes)}" >> ~/attributes.json), %(echo "#{Fog::JSON.encode()}" >> ~/metadata.json) ]) rescue Errno::ECONNREFUSED sleep(1) retry end |
#shelve ⇒ Object
275 276 277 278 |
# File 'lib/fog/compute/openstack/models/server.rb', line 275 def shelve requires :id service.shelve_server(id) end |
#shelve_offload ⇒ Object
285 286 287 288 |
# File 'lib/fog/compute/openstack/models/server.rb', line 285 def shelve_offload requires :id service.shelve_offload_server(id) end |
#start ⇒ Object
262 263 264 265 266 267 268 269 270 271 272 273 |
# File 'lib/fog/compute/openstack/models/server.rb', line 262 def start requires :id case state.downcase when 'paused' service.unpause_server(id) when 'suspended' service.resume_server(id) else service.start_server(id) end end |
#stop ⇒ Object
247 248 249 250 |
# File 'lib/fog/compute/openstack/models/server.rb', line 247 def stop requires :id service.stop_server(id) end |
#suspend ⇒ Object
257 258 259 260 |
# File 'lib/fog/compute/openstack/models/server.rb', line 257 def suspend requires :id service.suspend_server(id) end |
#unshelve ⇒ Object
280 281 282 283 |
# File 'lib/fog/compute/openstack/models/server.rb', line 280 def unshelve requires :id service.unshelve_server(id) end |
#user_data=(ascii_userdata) ⇒ Object
89 90 91 |
# File 'lib/fog/compute/openstack/models/server.rb', line 89 def user_data=(ascii_userdata) self.user_data_encoded = [ascii_userdata].pack('m') if ascii_userdata end |
#volume_attachments ⇒ Object
345 346 347 348 |
# File 'lib/fog/compute/openstack/models/server.rb', line 345 def requires :id service.get_server_volumes(id).body['volumeAttachments'] end |
#volumes ⇒ Object
338 339 340 341 342 343 |
# File 'lib/fog/compute/openstack/models/server.rb', line 338 def volumes requires :id service.volumes.select do |vol| vol..find { || ["serverId"] == id } end end |