ironic.drivers.modules.network.neutron module

class ironic.drivers.modules.network.neutron.NeutronNetwork(*args, **kwargs)

Bases: NeutronVIFPortIDMixin, NeutronNetworkInterfaceMixin, NetworkInterface

Neutron v2 network interface

add_cleaning_network(task)

Create neutron ports for each port on task.node to boot the ramdisk.

Parameters:

task – a TaskManager instance.

Raises:

NetworkError

Returns:

a dictionary in the form {port.uuid: neutron_port[‘id’]}

add_inspection_network(task)

Add the inspection network to the node.

Parameters:

task – A TaskManager instance.

Returns:

a dictionary in the form {port.uuid: neutron_port[‘id’]}

Raises:

NetworkError

Raises:

InvalidParameterValue, if the network interface configuration is invalid.

add_provisioning_network(task)

Add the provisioning network to a node.

Parameters:

task – A TaskManager instance.

Raises:

NetworkError

add_rescuing_network(task)

Create neutron ports for each port to boot the rescue ramdisk.

Parameters:

task – a TaskManager instance.

Returns:

a dictionary in the form {port.uuid: neutron_port[‘id’]}

add_servicing_network(task)

Create neutron ports for each port to boot the servicing ramdisk.

Parameters:

task – a TaskManager instance.

Returns:

a dictionary in the form {port.uuid: neutron_port[‘id’]}

capabilities = ['metadata']

configure_tenant_networks(task)

Configure tenant networks for a node.

Parameters:

task – A TaskManager instance.

Raises:

NetworkError

need_power_on(task)

Check if the node has any Smart NIC ports

Parameters:

task – A TaskManager instance.

Returns:

A boolean to indicate Smart NIC port presence

reattach_networking(task)

Reattach tenant networking without rebooting the node.

This service step unbinds and rebinds the tenant network ports attached to the node without requiring a reboot or IPA deployment. This is useful for advanced networking scenarios such as:

• Reconfiguring VXLAN network topology

• Updating network binding after infrastructure changes

• Recovering from network binding failures

• Migrating network segments or physical networks

The VIF attachments are preserved (not removed), only the Neutron port bindings are cleared and re-established. This allows network switches to reconfigure the ports without instance downtime.

Parameters:

task – A TaskManager instance.

Raises:

NetworkError if reattaching fails

remove_cleaning_network(task)

Deletes the neutron port created for booting the ramdisk.

Parameters:

task – a TaskManager instance.

Raises:

NetworkError

remove_inspection_network(task)

Removes the inspection network from a node.

Parameters:

task – A TaskManager instance.

Raises:

InvalidParameterValue, if the network interface configuration is invalid.

Raises:

MissingParameterValue, if some parameters are missing.

remove_provisioning_network(task)

Remove the provisioning network from a node.

Parameters:

task – A TaskManager instance.

Raises:

NetworkError

remove_rescuing_network(task)

Deletes neutron port created for booting the rescue ramdisk.

Parameters:

task – a TaskManager instance.

Raises:

NetworkError

remove_servicing_network(task)

Deletes neutron port created for booting the servicing ramdisk.

Parameters:

task – a TaskManager instance.

Raises:

NetworkError

unconfigure_tenant_networks(task)

Unconfigure tenant networks for a node.

Nova takes care of port removal from tenant network, we unbind it here/now to avoid the possibility of the ironic port being bound to the tenant and cleaning networks at the same time.

Parameters:

task – A TaskManager instance.

Raises:

NetworkError

validate(task)

Validates the network interface.

Parameters:

task – a TaskManager instance.

Raises:

InvalidParameterValue, if the network interface configuration is invalid.

Raises:

MissingParameterValue, if some parameters are missing.

validate_rescue(task)

Validates the network interface for rescue operation.

Parameters:

task – a TaskManager instance.

Raises:

InvalidParameterValue, if the network interface configuration is invalid.

Raises:

MissingParameterValue, if some parameters are missing.

validate_servicing(task)

Validates the network interface for servicing operation.

Parameters:

task – a TaskManager instance.

Raises:

InvalidParameterValue, if the network interface configuration is invalid.

Raises:

MissingParameterValue, if some parameters are missing.