Jump to: navigation, search


Revision as of 20:53, 25 September 2015 by Michael Krotscheck (talk | contribs)

OpenStack Bare Metal Provisioning Program

OpenStack bare metal provisioning a.k.a Ironic is an integrated OpenStack program which aims to provision bare metal machines instead of virtual machines, forked from the Nova baremetal driver. It is best thought of as a bare metal hypervisor API and a set of plugins which interact with the bare metal hypervisors. By default, it will use PXE and IPMI in concert to provision and turn on/off machines, but Ironic also supports vendor-specific plugins which may implement additional functionality. For a general overview please see: Introduction to Ironic.



The ironic project includes the ironic-api and ironic-conductor processes.

Official name OpenStack Bare Metal Provisioning
Source code https://github.com/openstack/ironic
Developer doc http://docs.openstack.org/developer/ironic/
Bug tracker https://bugs.launchpad.net/ironic
Feature tracker https://blueprints.launchpad.net/ironic
Specifications http://specs.openstack.org/openstack/ironic-specs
Weekly meetings https://wiki.openstack.org/wiki/Meetings/Ironic
Testing https://wiki.openstack.org/wiki/Ironic/Testing
Drivers https://wiki.openstack.org/wiki/Ironic/Drivers


python-ironicclient is a package that includes the python client and CLI.

Source code https://github.com/openstack/python-ironicclient
Bug tracker https://bugs.launchpad.net/python-ironicclient
Feature tracker https://blueprints.launchpad.net/python-ironicclient
Developer doc http://docs.openstack.org/developer/python-ironicclient


ironic-python-agent is a small python application that is meant to be embedded in a deployment ramdisk.

Source code https://github.com/openstack/ironic-python-agent
Bug tracker https://bugs.launchpad.net/ironic tag: "agent"
Developer doc http://docs.openstack.org/developer/ironic-python-agent
Wiki page https://wiki.openstack.org/wiki/Ironic-python-agent


pyghmi is an alternative to IPMItool.

Source code https://github.com/stackforge/pyghmi


ironic-inspector is a hardware introspection tool.

Source code https://github.com/openstack/ironic-inspector
Bug Tracker https://bugs.launchpad.net/ironic-inspector/
Feature tracker https://blueprints.launchpad.net/ironic-inspector/


bifrost consists of Ansible play books for running Ironic standalone (without other OpenStack components).

Source code https://github.com/openstack/bifrost
Bug tracker https://bugs.launchpad.net/bifrost


ironic-lib is a common library of functions used by the other ironic projects.

Source code https://github.com/openstack/ironic-lib
Bug tracker https://bugs.launchpad.net/ironic-lib


ironic-webclient is a webclient for OpenStack Ironic.

Source code https://github.com/openstack/ironic-webclient

other vendor-specific tools

Third-party vendors are encouraged to share their tools/scripts which might help people using their hardware with ironic. These tools are as such are not maintained by the ironic core team, and vendors themselves should be contacted for features requests/bug fixes.

Developer doc https://wiki.openstack.org/wiki/Ironic/ThirdPartyVendorToolsDeveloperDoc
List of third party vendor tools https://wiki.openstack.org/wiki/Ironic/ThirdPartyVendorToolsList


PTL: Devananda van der Veen (devananda)

Core teams: https://wiki.openstack.org/wiki/Ironic/CoreTeam

Cross-project liaisons: https://wiki.openstack.org/wiki/CrossProjectLiaisons


Ironic was first available as an incubated project in the "Icehouse" release. The following "Juno" release saw improved integration with Nova, as well as many stability and feature improvements. Ironic completed the project graduation review at the end of the "Juno" cycle, and began "Kilo" development cycle as an officially integrated OpenStack project.

Information on the latest status of Ironic's test suite can be found here: https://wiki.openstack.org/wiki/Ironic/Testing

For a list of current drivers and the status of their CI testing, see the wiki page we maintain and the Stackalytics page which tracks third-party CI


Our project teams frequently share ideas and coordinate by using etherpads, some of which stick around for a while. Those are listed here.


Discussion of the project also takes place in #openstack-ironic on irc.freenode.net. This is a great place to jump in and start your ironic adventure. The channel is very welcoming to new users - no question is a wrong question!


Guidelines for developers can be found here: https://wiki.openstack.org/wiki/Ironic/Developer_guidelines Please note that for any non-trivial change that is not a fix for a particular bug, you have to go through the specs review process

Pixie Boots, the Ironic drummer bear

Pixie Boots is the mascot of the "Bear Metal" Provisioning Program for OpenStack, a.k.a Ironic. It was drawn by Lucas Alvares Gomes and two versions of it are available: One colored and one outlined. An icon shadowcut of pixie boots is also available, courtesy of Michael Krotscheck. Feel free to use the images to make t-shirts or any other paraphernalia.

High-resolution PNGs versions are available by clicking on the images below:

You can also download the Inkscape SVG vector file: Ironic_mascot.svg

All images are licensed CC BY-SA.