The watcher.common.nova_helper Module¶

class watcher.common.nova_helper.NovaHelper(osc=None)[source]¶

Bases: object

abort_live_migrate(instance_id, source, destination, retry=240)[source]¶

confirm_resize(instance, previous_status, retry=60)[source]¶

create_image_from_instance(instance_id, image_name, metadata={'reason': 'instance_migrate'})[source]¶

This method creates a new image from a given instance.

It waits for this image to be in ‘active’ state before returning. It returns the unique UUID of the created image if successful, None otherwise.

Parameters:	instance_id – the uniqueid of the instance to backup as an image. image_name – the name of the image to create. metadata – a dictionary containing the list of key-value pairs to associate to the image as metadata.

create_instance(node_id, inst_name='test', image_id=None, flavor_name='m1.tiny', sec_group_list=['default'], network_names_list=['demo-net'], keypair_name='mykeys', create_new_floating_ip=True, block_device_mapping_v2=None)[source]¶

This method creates a new instance

It also creates, if requested, a new floating IP and associates it with the new instance It returns the unique id of the created instance.

delete_instance(instance_id)[source]¶

This method deletes a given instance.

Parameters:	instance_id – the unique id of the instance to delete.

disable_service_nova_compute(hostname, reason=None)[source]¶

enable_service_nova_compute(hostname)[source]¶

find_instance(instance_id)[source]¶

get_aggregate_detail(aggregate_id)[source]¶

get_aggregate_list()[source]¶

get_availability_zone_list()[source]¶

get_compute_node_by_hostname(node_hostname)[source]¶

Get compute node by hostname

get_compute_node_by_id(node_id)[source]¶

Get compute node by ID (not UUID)

get_compute_node_list()[source]¶

get_flavor_list()[source]¶

get_hostname(instance)[source]¶

get_instance_by_name(instance_name)[source]¶

get_instance_by_uuid(instance_uuid)[source]¶

get_instance_list()[source]¶

get_instances_by_node(host)[source]¶

get_network_id_from_name(net_name='private')[source]¶

This method returns the unique id of the provided network name

get_running_migration(instance_id)[source]¶

get_security_group_id_from_name(group_name='default')[source]¶

This method returns the security group of the provided group name

get_service(service_id)[source]¶

get_service_list()[source]¶

live_migrate_instance(instance_id, dest_hostname, retry=120)[source]¶

This method does a live migration of a given instance

This method uses the Nova built-in live_migrate() action to do a live migration of a given instance.

It returns True if the migration was successful, False otherwise.

Parameters:	instance_id – the unique id of the instance to migrate. dest_hostname – the name of the destination compute node, if destination_node is None, nova scheduler choose the destination host

resize_instance(instance_id, flavor, retry=120)[source]¶

This method resizes given instance with specified flavor.

This method uses the Nova built-in resize() action to do a resize of a given instance.

It returns True if the resize was successful, False otherwise.

Parameters:	instance_id – the unique id of the instance to resize. flavor – the name or ID of the flavor to resize to.

set_host_offline(hostname)[source]¶

stop_instance(instance_id)[source]¶

This method stops a given instance.

Parameters:	instance_id – the unique id of the instance to stop.

swap_volume(old_volume, new_volume, retry=120, retry_interval=10)[source]¶

Swap old_volume for new_volume

wait_for_instance_state(server, state, retry, sleep)[source]¶

Waits for server to be in a specific state

The state can be one of the following : active, stopped

Parameters:	server – server object. state – for which state we are waiting for retry – how many times to retry sleep – seconds to sleep between the retries

wait_for_instance_status(instance, status_list, retry, sleep)[source]¶

Waits for instance to be in a specific status

The status can be one of the following : BUILD, ACTIVE, ERROR, VERIFY_RESIZE, SHUTOFF

Parameters:	instance – instance object. status_list – tuple containing the list of status we are waiting for retry – how many times to retry sleep – seconds to sleep between the retries

wait_for_volume_status(volume, status, timeout=60, poll_interval=1)[source]¶

Wait until volume reaches given status.

Parameters:	volume – volume resource status – expected status of volume timeout – timeout in seconds poll_interval – poll interval in seconds

watcher_non_live_migrate_instance(instance_id, dest_hostname, retry=120)[source]¶

This method migrates a given instance

This method uses the Nova built-in migrate() action to do a migration of a given instance. For migrating a given dest_hostname, Nova API version must be 2.56 or higher.

It returns True if the migration was successful, False otherwise.

Parameters:	instance_id – the unique id of the instance to migrate. dest_hostname – the name of the destination compute node, if destination_node is None, nova scheduler choose the destination host