A Python agent for provisioning and deprovisioning Bare Metal servers.
Go to file
Jay Faulkner a1b9170520 Warn about CVE-2024-44082
Unmaintained Ironic-Python-Agent branches will not be patched against
CVE-2024-44082. This patch updates the release notes and readme
instructing deployers how to mitigate their risk using the provided
Ironic conductor patches.

Related-Bug: 2071740
Change-Id: Ie4aeef4af01ead5c18b359a22ab488de0c35248a
2024-09-06 21:36:27 +00:00
doc SoftwareRAID: Enable skipping RAIDS 2022-09-05 20:43:51 +00:00
examples Increase version of hacking and pycodestyle 2021-07-30 14:34:33 +02:00
imagebuild Remove imagebuild/common, it's not longer used by IPA-builder 2019-10-16 14:14:13 +02:00
ironic_python_agent Merge "preserve/handle config drives on 4k block devices" into stable/zed 2023-12-13 20:43:56 +00:00
releasenotes Warn about CVE-2024-44082 2024-09-06 21:36:27 +00:00
tools Adds bandit template and exclude some of tests 2019-06-20 14:39:36 +08:00
zuul.d add openstack-python3-zed-jobs-arm64 job 2022-08-29 11:42:01 +08:00
.gitignore Remove the configuration sample file 2019-12-02 12:11:58 +01:00
.gitreview Update .gitreview for unmaintained/zed 2024-05-06 06:22:57 +00:00
.stestr.conf Migrate to stestr as unit tests runner 2017-09-26 09:23:53 -07:00
bindep.txt Drop python2 from bindep.txt 2022-06-30 23:33:05 +00:00
CONTRIBUTING.rst Change launchpad to StoryBoard 2018-03-28 14:15:29 +00:00
LICENSE add license file 2013-09-17 13:41:59 -07:00
plugin-requirements.txt Update hardware to 0.24,0 2020-01-15 12:44:31 +01:00
proxy.sh Add support for proxy servers during image build 2016-02-04 14:27:49 -08:00
README.rst Warn about CVE-2024-44082 2024-09-06 21:36:27 +00:00
requirements.txt Merge "Remove oslo.serialization dependency" 2022-07-02 02:56:44 +00:00
setup.cfg Drop support for Python 3.6 and 3.7 2022-05-31 09:46:49 +02:00
setup.py Cleanup py27 support 2020-04-05 10:46:10 +02:00
test-requirements.txt Upgrade version of doc8 2020-12-14 14:47:57 +01:00
tox.ini Fixes for tox 4.0 2022-12-15 19:38:07 +00:00

Ironic Python Agent

Team and repository tags

image

Overview

WARNING: The Ironic-Python-Agent version in this branch is vulnerable to CVE-2024-44082. Do not run this in production unless using a patched conductor with [conductor]/conductor_always_validate_images set to True.

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:

https://storyboard.openstack.org/#!/project/947

Developer documentation can be found here:

https://docs.openstack.org/ironic-python-agent/latest/

Release notes for the project are available at:

https://docs.openstack.org/releasenotes/ironic-python-agent/

Source code repository for the project is located at:

https://opendev.org/openstack/ironic-python-agent/

IRC channel:

#openstack-ironic

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