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
Julia Kreger 2fe6a4588c Fix UTF-16 result handling for efibootmgr
The tl;dr is that UEFI NVRAM is in encoded
in UTF-16, and when we run the efibootmgr command,
we can get unicode characters back.

Except we previously were forcing everything to be
treated as UTF-8 due to the way oslo.concurrency's
processutils module works.

This could be observed with UTF character 0x00FF
which raises up a nice exception when we try to
decode it.

Anyhow! while fixing handling of this, we discovered
we could get basically the cruft out of the NVRAM,
by getting what was most likey a truncated string
out of our own test VMs. As such, we need to also
permit decoding to be tollerant of failures.
This could be binary data or as simple as flipped
bits which get interpretted invalid characters.
As such, we have introduced such data into one of our
tests involving UEFI record de-duplication.

Closes-Bug: 2015602
Change-Id: I006535bf124379ed65443c7b283bc99ecc95568b
(cherry picked from commit 76accfb880)
1 month ago
doc modify error word node 5 months 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 Fix UTF-16 result handling for efibootmgr 1 month ago
releasenotes Fix UTF-16 result handling for efibootmgr 1 month ago
tools Adds bandit template and exclude some of tests 4 years ago
zuul.d Fix for tox4 and setuptools 5 months ago
.gitignore Remove the configuration sample file 4 years ago
.gitreview Update .gitreview for stable/2023.1 3 months 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 Drop python2 from bindep.txt 11 months ago
plugin-requirements.txt Update hardware to 0.24,0 3 years ago
requirements.txt Merge "Remove oslo.serialization dependency" 11 months ago
setup.cfg Drop support for Python 3.6 and 3.7 1 year ago
setup.py Fix for tox4 and setuptools 5 months ago
test-requirements.txt Upgrade version of doc8 3 years ago
tox.ini Update TOX_CONSTRAINTS_FILE for stable/2023.1 3 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.