A Python agent for provisioning and deprovisioning Bare Metal servers.
Go to file
Julia Kreger 0b31c4cb75 Retry on checksum failures
HTTP is a fun protocol.

Size is basically optional. And clients implicitly trust the server
and socket has transferred all the bytes. Which *really* means you
should always checksum.

But... previously we didn't checksum as part of retrying.

So if anything happened with python-requests, or lower level
library code or the system itself causing bytes to be lost off the
buffer, creating an incomplete transfer situation, then we wouldn't
know until the checksum.

So now, we checksum and re-trigger the download if there is a
failure of the checksum.

This involved a minor shift in the download logic, and resulted in
a needful minor fix to an image checksum test as it would loop for
90 seconds as well.

Closes-Bug: 2038934
Change-Id: I543a60555a2621b49dd7b6564bd0654a46db2e9a
(cherry picked from commit cb61a8d6c0)
2023-10-11 13:33:56 +00:00
doc Add get_service_steps logic to the agent 2023-08-31 06:22:22 -07: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 Retry on checksum failures 2023-10-11 13:33:56 +00:00
releasenotes Retry on checksum failures 2023-10-11 13:33:56 +00:00
tools Adds bandit template and exclude some of tests 2019-06-20 14:39:36 +08:00
zuul.d Use sparkingly new metalsmith cs9 job 2023-08-24 16:29:50 +02:00
.gitignore Remove the configuration sample file 2019-12-02 12:11:58 +01:00
.gitreview Update .gitreview for stable/2023.2 2023-09-21 11:18:11 +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 Ironic (and IPA) use launchpad now 2023-05-17 15:38:57 -07: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
README.rst Ironic (and IPA) use launchpad now 2023-05-17 15:38:57 -07:00
requirements.txt Merge "Remove oslo.serialization dependency" 2022-07-02 02:56:44 +00:00
setup.cfg Add get_service_steps logic to the agent 2023-08-31 06:22:22 -07:00
setup.py Fix for tox4 and setuptools 2023-01-02 14:40:35 +01:00
test-requirements.txt Upgrade version of doc8 2020-12-14 14:47:57 +01:00
tox.ini Update TOX_CONSTRAINTS_FILE for stable/2023.2 2023-09-21 11:18:15 +00:00

Ironic Python Agent

Team and repository tags

image

Overview

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 bugs are tracked on Launchpad:

https://bugs.launchpad.net/ironic-python-agent/+bugs

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 on irc.oftc.net

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