The ironic.drivers.modules.iscsi_deploy Module

class ironic.drivers.modules.iscsi_deploy.AgentDeployMixin[source]

Bases: ironic.drivers.modules.agent_base_vendor.AgentDeployMixin

continue_deploy(*args, **kwargs)[source]

Method invoked when deployed using iSCSI.

This method is invoked during a heartbeat from an agent when the node is in wait-call-back state. This deploys the image on the node and then configures the node to boot according to the desired boot option (netboot or localboot).

Parameters:
  • task – a TaskManager object containing the node.
  • kwargs – the kwargs passed from the heartbeat method.
Raises:

InstanceDeployFailure, if it encounters some error during the deploy.

class ironic.drivers.modules.iscsi_deploy.ISCSIDeploy[source]

Bases: ironic.drivers.modules.iscsi_deploy.AgentDeployMixin, ironic.drivers.base.DeployInterface

iSCSI Deploy Interface for deploy-related actions.

clean_up(*args, **kwargs)[source]

Clean up the deployment environment for the task’s node.

Unlinks TFTP and instance images and triggers image cache cleanup. Removes the TFTP configuration files for this node.

Parameters:task – a TaskManager instance containing the node to act on.
deploy(*args, **kwargs)[source]

Start deployment of the task’s node.

Fetches instance image, updates the DHCP port options for next boot, and issues a reboot request to the power driver. This causes the node to boot into the deployment ramdisk and triggers the next phase of PXE-based deployment via agent heartbeats.

Parameters:task – a TaskManager instance containing the node to act on.
Returns:deploy state DEPLOYWAIT.
execute_clean_step(*args, **kwargs)[source]

Execute a clean step asynchronously on the agent.

Parameters:
  • task – a TaskManager object containing the node
  • step – a clean step dictionary to execute
Raises:

NodeCleaningFailure if the agent does not return a command status

Returns:

states.CLEANWAIT to signify the step will be completed asynchronously.

get_clean_steps(*args, **kwargs)[source]

Get the list of clean steps from the agent.

Parameters:task – a TaskManager object containing the node
Raises:NodeCleaningFailure – if the clean steps are not yet available (cached), for example, when a node has just been enrolled and has not been cleaned yet.
Returns:A list of clean step dictionaries.
get_properties()[source]
prepare(*args, **kwargs)[source]

Prepare the deployment environment for this task’s node.

Generates the TFTP configuration for PXE-booting both the deployment and user images, fetches the TFTP image from Glance and add it to the local cache.

Parameters:task – a TaskManager instance containing the node to act on.
Raises:NetworkError: if the previous cleaning ports cannot be removed or if new cleaning ports cannot be created.
Raises:InvalidParameterValue when the wrong power state is specified or the wrong driver info is specified for power management.
Raises:StorageError If the storage driver is unable to attach the configured volumes.
Raises:other exceptions by the node’s power driver if something wrong occurred during the power action.
Raises:any boot interface’s prepare_ramdisk exceptions.
prepare_cleaning(*args, **kwargs)[source]

Boot into the agent to prepare for cleaning.

Parameters:task – a TaskManager object containing the node
Raises:NodeCleaningFailure – if the previous cleaning ports cannot be removed or if new cleaning ports cannot be created
Returns:states.CLEANWAIT to signify an asynchronous prepare.
take_over(task)[source]
tear_down(*args, **kwargs)[source]

Tear down a previous deployment on the task’s node.

Power off the node. All actual clean-up is done in the clean_up() method which should be called separately.

Parameters:task – a TaskManager instance containing the node to act on.
Returns:deploy state DELETED.
Raises:NetworkError if the cleaning ports cannot be removed.
Raises:InvalidParameterValue when the wrong state is specified or the wrong driver info is specified.
Raises:StorageError when volume detachment fails.
Raises:other exceptions by the node’s power driver if something wrong occurred during the power action.
tear_down_cleaning(*args, **kwargs)[source]

Clean up the PXE and DHCP files after cleaning.

Parameters:task – a TaskManager object containing the node
Raises:NodeCleaningFailure – if the cleaning ports cannot be removed
validate(*args, **kwargs)[source]

Validate the deployment information for the task’s node.

Parameters:task – a TaskManager instance containing the node to act on.
Raises:InvalidParameterValue.
Raises:MissingParameterValue
class ironic.drivers.modules.iscsi_deploy.InstanceImageCache[source]

Bases: ironic.drivers.modules.image_cache.ImageCache