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.
OpenStack Release Bot 8d901ff0dc Add Python3 yoga unit tests 3 days ago
doc Burn-in: Add network step 2 months ago
examples Increase version of hacking and pycodestyle 2 months ago
imagebuild Remove imagebuild/common, it's not longer used by IPA-builder 2 years ago
ironic_python_agent Merge "Trivial: minor fixes in error messages" 2 weeks ago
releasenotes Update master for stable/xena 3 days ago
tools Adds bandit template and exclude some of tests 2 years ago
zuul.d Add Python3 yoga unit tests 3 days ago
.gitignore Remove the configuration sample file 2 years ago
.gitreview OpenDev Migration Patch 2 years 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 Migrate functional tests for work_on_disk from ironic-lib 5 months ago
lower-constraints.txt Add lower-constraints job to current development branch 2 months 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 Refactor: use convert_image from ironic_lib 4 months ago
setup.cfg Remove the iscsi extension 5 months ago
setup.py Cleanup py27 support 1 year ago
test-requirements.txt Upgrade version of doc8 10 months ago
tox.ini Merge "Increase version of hacking and pycodestyle" 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.