ironic_python_agent.extensions.standby module

class ironic_python_agent.extensions.standby.ImageDownload(image_info, time_obj=None)

Bases: object

Helper class that opens a HTTP connection to download an image.

This class opens a HTTP connection to download an image from a URL and create an iterator so the image can be downloaded in chunks. The MD5 hash of the image being downloaded is calculated on-the-fly.

property bytes_transferred

Property value to return the number of bytes transferred.

property content_length

Property value to return the server indicated length.

verify_image(image_location)

Verifies the checksum of the local images matches expectations.

If this function does not raise ImageChecksumError then it is very likely that the local copy of the image was transmitted and stored correctly.

Parameters:

image_location – The location of the local image.

Raises:

ImageChecksumError if the checksum of the local image does not match the checksum as reported by glance in image_info.

class ironic_python_agent.extensions.standby.StandbyExtension(agent=None)

Bases: BaseAgentExtension

Extension which adds stand-by related functionality to agent.

get_partition_uuids()

Return partition UUIDs.

power_off()

Powers off the agent’s system.

prepare_image(image_info, configdrive=None)

Asynchronously prepares specified image on local OS install device.

In this case, ‘prepare’ means make local machine completely ready to reboot to the image specified by image_info.

Downloads and writes an image to disk if necessary. Also writes a configdrive to disk if the configdrive parameter is specified.

Parameters:

• image_info – Image information dictionary.

• configdrive – A string containing the location of the config drive as a URL OR the contents (as gzip/base64) of the configdrive. Optional, defaults to None.

Raises:

ImageDownloadError if the image download encounters an error.

Raises:

ImageChecksumError if the checksum of the local image does not match the checksum as reported by glance in image_info.

Raises:

ImageWriteError if writing the image fails.

Raises:

InstanceDeployFailure if failed to create config drive. large to store on the given device.

run_image()

Runs image on agent’s system via reboot.

sync()

Flush file system buffers forcing changed blocks to disk.

Raises:

CommandExecutionError if flushing file system buffers fails.

ironic_python_agent.extensions.standby.check_md5_enabled()

Checks if md5 is permitted, otherwise raises ValueError.