A Python agent for provisioning and deprovisioning Bare Metal servers.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Zuul 312e1527ab Merge "Warn when smartctl not found" 24 hours ago
doc Burn-in: Add network step 12 months ago
examples Increase version of hacking and pycodestyle 11 months ago
imagebuild Remove imagebuild/common, it's not longer used by IPA-builder 3 years ago
ironic_python_agent Merge "Warn when smartctl not found" 24 hours ago
releasenotes Fix discovering WWN/serial for devicemapper devices 2 weeks ago
tools Adds bandit template and exclude some of tests 3 years ago
zuul.d Add ipa-tox-examples job to gate 4 weeks ago
.gitignore Remove the configuration sample file 3 years ago
.gitreview OpenDev Migration Patch 3 years ago
.stestr.conf Migrate to stestr as unit tests runner 5 years ago
CONTRIBUTING.rst Change launchpad to StoryBoard 4 years ago
LICENSE add license file 9 years ago
README.rst Replace git.openstack.org URLs with opendev.org URLs 3 years ago
bindep.txt Migrate functional tests for work_on_disk from ironic-lib 1 year ago
plugin-requirements.txt Update hardware to 0.24,0 2 years ago
proxy.sh Add support for proxy servers during image build 6 years ago
requirements.txt Remove importlib-metadata from requirements 7 days ago
setup.cfg Drop support for Python 3.6 and 3.7 4 weeks ago
setup.py Cleanup py27 support 2 years ago
test-requirements.txt Upgrade version of doc8 2 years ago
tox.ini Drop lower-constraints.txt and its testing 2 months ago


Ironic Python Agent

Team and repository tags



An agent for controlling and deploying Ironic controlled baremetal nodes.

The ironic-python-agent works with the agent driver in Ironic to provision the node. Starting with ironic-python-agent running on a ramdisk on the unprovisioned node, Ironic makes API calls to ironic-python-agent to provision the machine. This allows for greater control and flexibility of the entire deployment process.

The ironic-python-agent may also be used with the original Ironic pxe drivers as of the Kilo OpenStack release.

Building the IPA deployment ramdisk

For more information see the Image Builder section of the Ironic Python Agent developer guide.

Using IPA with devstack

This is covered in the Deploying Ironic with DevStack section of the Ironic dev-quickstart guide.

Project Resources

Project status, features, and bugs are tracked on StoryBoard:


Developer documentation can be found here:


Release notes for the project are available at:


Source code repository for the project is located at:


IRC channel:


To contribute, start here: Openstack: How to contribute.