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