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.
Zane Bitter 37c39b1b38 Fix missing data in log messages 5 months ago
doc Document ramdisk TLS and update existing TLS docs 1 year ago
examples Examples: add deploy_steps examples 1 year ago
imagebuild Remove imagebuild/common, it's not longer used by IPA-builder 2 years ago
ironic_python_agent Fix missing data in log messages 5 months ago
releasenotes Add a call to "udevadm settle" in write_image.sh 5 months ago
tools Adds bandit template and exclude some of tests 2 years ago
zuul.d Prepare to use tinycore 12 6 months ago
.gitignore Remove the configuration sample file 2 years ago
.gitreview Update .gitreview for stable/victoria 12 months ago
.stestr.conf Migrate to stestr as unit tests runner 4 years ago
CONTRIBUTING.rst Change launchpad to StoryBoard 4 years ago
LICENSE add license file 8 years ago
README.rst Replace git.openstack.org URLs with opendev.org URLs 2 years ago
bindep.txt Add ffi development lib to bindep 1 year ago
lower-constraints.txt Merge "Generate a TLS certificate and send it to ironic" 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 Merge "Generate a TLS certificate and send it to ironic" 1 year ago
setup.cfg Adds poll mode deployment support 1 year ago
setup.py Cleanup py27 support 1 year ago
test-requirements.txt Update version of hacking 1 year ago
tox.ini Update TOX_CONSTRAINTS_FILE for stable/victoria 12 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.