openstack/ironic
Code Issues Proposed changes
c4721da2d8
ironic/doc/source/admin/agent-power.rst
Dmitry Tantsur 4911477525 Document fast-track and the agent power interface 
To prevent the administrator guide from growing too long, split
away advanced topics (i.e. stuff we don't expect most of admins
to read, use or understand).

Story: #2007771
Task: #40382
Change-Id: Ia3e3178692c96aaebdd4479e865a56fbe63c820a
2020-07-20 09:42:14 +02:00

2.3 KiB
Raw Blame History

Deploying without BMC Credentials

The Bare Metal service usually requires BMC credentials for all provisioning operations. Starting with the Victoria release series there is limited support for inspection, cleaning and deployments without the credentials.

Warning

This feature is experimental and only works in a limited scenario. When using it, you have to be prepared to provide BMC credentials in case of a failure or any non-supported actions.

How it works

The expected workflow is as follows:

  1. The node is discovered by manually powering it on and gets the manual-management hardware type and agent power interface.

    If discovery is not used, a node can be enrolled through the API and then powered on manually.

  2. The operator moves the node to manageable. It works because the agent power only requires to be able to connect to the agent.

  3. The operator moves the node to available. Cleaning happens normally via the already running agent. If reboot is needed, it is done by telling the agent to reboot the node in-band.

  4. A user deploys the node. Deployment happens normally via the already running agent.

  5. In the end of the deployment, the node is rebooted via the reboot command instead of power off+on.

Enabling

fast-track is a requirement for this feature to work. After enabling it, adds the agent power interface and the manual-management hardware type to the enabled list:

[DEFAULT]
enabled_hardware_types = manual-management
enabled_management_interfaces = noop
enabled_power_interfaces = agent

[deploy]
fast_track = true

As usual with the noop management, enable the networking boot fallback:

[pxe]
enable_netboot_fallback = true

If using discovery, configure discovery in ironic-inspector <user/usage.html#discovery> with the default driver set to manual-management.

Limitations

  • Only the noop network interface is supported.
  • Undeploy and rescue are not supported, you need to add BMC credentials first.
  • If any errors happens in the process, recovery will likely require BMC credentials.
  • Only rebooting is possible through the API, power on/off commands will fail.