openstack
/
ironic-python-agent
Code Issues Proposed changes
A Python agent for provisioning and deprovisioning Bare Metal servers.
2,474 Commits 19 Branches 62 Tags 33 MiB
Python 99.9%
Shell 0.1%
Go to file
Dmitry Tantsur 2ab8364649
Add a jitter to heartbeat retries 
Currently, if heartbeat fails, we reschedule it after 5 seconds.
This is fine for the first retry, but it can cause a thundering herd
problem when a lot of nodes fail to heartbeat at once.

This change adds jitter to the minimum wait of 5 seconds. The jitter is
not applied for forced heartbeats: they still have a minimum wait of
exactly 5 seconds from the last heartbeat.

The code is re-ordered to move the interval calculation to one place.
Bonus: correctly logging the next interval.

The unit tests have been rewritten to test the heartbeat process step by
step and not rely on the exact sequence of the calls.

Closes-Bug: #2038438
Change-Id: I4c4207b15fb3d48b55e340b7b3b54af833f92cb5
 		2023-12-13 17:34:24 +01: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 Add a jitter to heartbeat retries 2023-12-13 17:34:24 +01:00
releasenotes Add a jitter to heartbeat retries 2023-12-13 17:34:24 +01: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 OpenDev Migration Patch 2019-04-19 19:48:56 +00:00
.stestr.conf Migrate to stestr as unit tests runner 2017-09-26 09:23:53 -07: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
README.rst Ironic (and IPA) use launchpad now 2023-05-17 15:38:57 -07:00
bindep.txt Drop python2 from bindep.txt 2022-06-30 23:33:05 +00:00
plugin-requirements.txt Update hardware to 0.24,0 2020-01-15 12:44:31 +01: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 tox: Remove basepython 2023-08-02 16:59:59 +08:00

README.rst

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.