Class: Bosh::Cloud
- Inherits:
-
Object
- Object
- Bosh::Cloud
- Defined in:
- lib/cloud.rb
Overview
CPI - Cloud Provider Interface, used for interfacing with various IaaS APIs.
Key terms: Stemcell: template used for creating VMs (shouldn’t be powered on) VM: VM created from a stemcell with custom settings (networking and resources) Disk: volume that can be attached and detached from the VMs,
never attached to more than a single VM at one time
Instance Method Summary collapse
-
#attach_disk(vm_id, disk_id) ⇒ void
Attaches a disk.
-
#calculate_vm_cloud_properties(vm_properties) ⇒ Hash
Specify VM’s hardware resources can be used with #create_vm.
-
#create_disk(size, cloud_properties, vm_locality) ⇒ String
Creates a disk (possibly lazily) that will be attached later to a VM.
-
#create_stemcell(image_path, cloud_properties) ⇒ String
Creates a stemcell.
-
#create_vm(agent_id, stemcell_id, resource_pool, networks, disk_locality, env) ⇒ String
Creates a VM - creates (and powers on) a VM from a stemcell with the proper resources and on the specified network.
-
#current_vm_id ⇒ String
Get the vm_id of this host.
-
#delete_disk(disk_id) ⇒ void
Deletes a disk Will raise an exception if the disk is attached to a VM.
-
#delete_snapshot(snapshot_id) ⇒ void
Delete a disk snapshot.
-
#delete_stemcell(stemcell_id) ⇒ void
Deletes a stemcell.
-
#delete_vm(vm_id) ⇒ void
Deletes a VM.
-
#detach_disk(vm_id, disk_id) ⇒ void
Detaches a disk.
-
#get_disks(vm_id) ⇒ array[String]
List the attached disks of the VM.
-
#has_disk?(disk_id) ⇒ Boolean
Checks if a disk exists.
-
#has_vm?(vm_id) ⇒ Boolean
Checks if a VM exists.
-
#initialize(options) ⇒ Cloud
constructor
Cloud initialization.
-
#reboot_vm(vm_id) ⇒ void
Reboots a VM.
-
#set_vm_metadata(vm, metadata) ⇒ void
Set metadata for a VM.
-
#snapshot_disk(disk_id, metadata) ⇒ String
Take snapshot of disk.
Constructor Details
#initialize(options) ⇒ Cloud
Cloud initialization
26 27 |
# File 'lib/cloud.rb', line 26 def initialize() end |
Instance Method Details
#attach_disk(vm_id, disk_id) ⇒ void
This method returns an undefined value.
Attaches a disk
175 176 177 |
# File 'lib/cloud.rb', line 175 def attach_disk(vm_id, disk_id) not_implemented(:attach_disk) end |
#calculate_vm_cloud_properties(vm_properties) ⇒ Hash
Specify VM’s hardware resources can be used with #create_vm
214 215 216 |
# File 'lib/cloud.rb', line 214 def calculate_vm_cloud_properties(vm_properties) not_implemented(:calculate_vm_cloud_properties) end |
#create_disk(size, cloud_properties, vm_locality) ⇒ String
Creates a disk (possibly lazily) that will be attached later to a VM. When VM locality is specified the disk will be placed near the VM so it won’t have to move when it’s attached later.
157 158 159 |
# File 'lib/cloud.rb', line 157 def create_disk(size, cloud_properties, vm_locality) not_implemented(:create_disk) end |
#create_stemcell(image_path, cloud_properties) ⇒ String
Creates a stemcell
44 45 46 |
# File 'lib/cloud.rb', line 44 def create_stemcell(image_path, cloud_properties) not_implemented(:create_stemcell) end |
#create_vm(agent_id, stemcell_id, resource_pool, networks, disk_locality, env) ⇒ String
Creates a VM - creates (and powers on) a VM from a stemcell with the proper resources and on the specified network. When disk locality is present the VM will be placed near the provided disk so it won’t have to move when the disk is attached later.
Sample networking config:
{"network_a" =>
{
"netmask" => "255.255.248.0",
"ip" => "172.30.41.40",
"gateway" => "172.30.40.1",
"dns" => ["172.30.22.153", "172.30.22.154"],
"cloud_properties" => {"name" => "VLAN444"}
}
}
Sample resource pool config (CPI specific):
{
"ram" => 512,
"disk" => 512,
"cpu" => 1
}
or similar for EC2:
{"name" => "m1.small"}
92 93 94 95 |
# File 'lib/cloud.rb', line 92 def create_vm(agent_id, stemcell_id, resource_pool, networks, disk_locality, env) not_implemented(:create_vm) end |
#current_vm_id ⇒ String
Get the vm_id of this host
33 34 35 |
# File 'lib/cloud.rb', line 33 def current_vm_id not_implemented(:current_vm_id) end |
#delete_disk(disk_id) ⇒ void
This method returns an undefined value.
Deletes a disk Will raise an exception if the disk is attached to a VM
167 168 169 |
# File 'lib/cloud.rb', line 167 def delete_disk(disk_id) not_implemented(:delete_disk) end |
#delete_snapshot(snapshot_id) ⇒ void
This method returns an undefined value.
Delete a disk snapshot
190 191 192 |
# File 'lib/cloud.rb', line 190 def delete_snapshot(snapshot_id) not_implemented(:delete_snapshot) end |
#delete_stemcell(stemcell_id) ⇒ void
This method returns an undefined value.
Deletes a stemcell
53 54 55 |
# File 'lib/cloud.rb', line 53 def delete_stemcell(stemcell_id) not_implemented(:delete_stemcell) end |
#delete_vm(vm_id) ⇒ void
This method returns an undefined value.
Deletes a VM. If the VM has already been deleted, this call returns normally and has no effect.
102 103 104 |
# File 'lib/cloud.rb', line 102 def delete_vm(vm_id) not_implemented(:delete_vm) end |
#detach_disk(vm_id, disk_id) ⇒ void
This method returns an undefined value.
Detaches a disk
198 199 200 |
# File 'lib/cloud.rb', line 198 def detach_disk(vm_id, disk_id) not_implemented(:detach_disk) end |
#get_disks(vm_id) ⇒ array[String]
List the attached disks of the VM. other disk-related methods on the CPI
206 207 208 |
# File 'lib/cloud.rb', line 206 def get_disks(vm_id) not_implemented(:get_disks) end |
#has_disk?(disk_id) ⇒ Boolean
Checks if a disk exists
120 121 122 |
# File 'lib/cloud.rb', line 120 def has_disk?(disk_id) not_implemented(:has_disk?) end |
#has_vm?(vm_id) ⇒ Boolean
Checks if a VM exists
111 112 113 |
# File 'lib/cloud.rb', line 111 def has_vm?(vm_id) not_implemented(:has_vm?) end |
#reboot_vm(vm_id) ⇒ void
This method returns an undefined value.
Reboots a VM
130 131 132 |
# File 'lib/cloud.rb', line 130 def reboot_vm(vm_id) not_implemented(:reboot_vm) end |
#set_vm_metadata(vm, metadata) ⇒ void
This method returns an undefined value.
Set metadata for a VM
Optional. Implement to provide more information for the IaaS.
142 143 144 |
# File 'lib/cloud.rb', line 142 def (vm, ) not_implemented(:set_vm_metadata) end |
#snapshot_disk(disk_id, metadata) ⇒ String
Take snapshot of disk
183 184 185 |
# File 'lib/cloud.rb', line 183 def snapshot_disk(disk_id, ) not_implemented(:snapshot_disk) end |