Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .github/workflows/ci.yml
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ jobs:
runs-on: ubuntu-latest
strategy:
matrix:
python-version: ["3.12", "3.13"]
python-version: ["3.12", "3.13", "3.14"]
steps:
- uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4
- uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065 # v5
Expand Down
2 changes: 1 addition & 1 deletion .github/workflows/container.yml
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ on:
tags: ["v*"]

env:
BASE_TAG: 2025.1-ubuntu-noble
BASE_TAG: 2026.1-ubuntu-noble

jobs:
image:
Expand Down
10 changes: 10 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -238,6 +238,10 @@ username = guest
password = guest
virtual_host = /

[oslo_messaging_rabbit]
rabbit_quorum_queue = true
rabbit_transient_quorum_queue = true

[executor]
max_concurrent_migrations = 2
migration_timeout = 600
Expand Down Expand Up @@ -411,6 +415,12 @@ serviced by an independent unit on its own threads):

The unassigned-hosts pool uses the reserved name `_unassigned_` in its topics.

Use quorum queues (`[oslo_messaging_rabbit] rabbit_quorum_queue` and
`rabbit_transient_quorum_queue`), as Kolla-Ansible does for the OpenStack
services. Without them oslo.messaging declares non-durable classic queues,
a deprecated feature in RabbitMQ 4 (`transient_nonexcl_queues`). See the
configuration reference for switching an existing deployment.

## Project Layout

```
Expand Down
8 changes: 4 additions & 4 deletions docker/Dockerfile
Original file line number Diff line number Diff line change
Expand Up @@ -20,8 +20,8 @@
#
# python -m build
# docker build -f docker/Dockerfile \
# --build-arg BASE_TAG=2025.1-ubuntu-noble \
# -t kronos:2025.1-ubuntu-noble .
# --build-arg BASE_TAG=2026.1-ubuntu-noble \
# -t kronos:2026.1-ubuntu-noble .
#
# Run (standalone, without kolla-ansible):
#
Expand All @@ -30,10 +30,10 @@
# -v /etc/kronos/kronos-engine.json:/var/lib/kolla/config_files/config.json:ro \
# -v /etc/kronos/kronos.conf:/var/lib/kolla/config_files/kronos.conf:ro \
# -v /etc/kronos/policies.yaml:/var/lib/kolla/config_files/policies.yaml:ro \
# kronos:2025.1-ubuntu-noble
# kronos:2026.1-ubuntu-noble

ARG BASE_IMAGE=quay.io/openstack.kolla/openstack-base
ARG BASE_TAG=2025.1-ubuntu-noble
ARG BASE_TAG=2026.1-ubuntu-noble
FROM ${BASE_IMAGE}:${BASE_TAG}

LABEL maintainer="Kronos maintainers" name="kronos"
Expand Down
31 changes: 29 additions & 2 deletions docs/configuration/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -31,6 +31,33 @@ and regenerated with:
.. literalinclude:: kronos.conf.sample
:language: ini

Messaging
---------

Kronos shares the OpenStack RabbitMQ broker. Kolla-Ansible configures the
OpenStack services with quorum queues, set the same for Kronos:

.. code-block:: ini

[oslo_messaging_rabbit]
rabbit_quorum_queue = true
rabbit_transient_quorum_queue = true

Without these options oslo.messaging declares non-durable classic queues
(the RPC topic, server and fanout queues) and a non-durable ``openstack``
exchange. RabbitMQ 4 deprecates non-durable non-exclusive queues
(deprecated feature ``transient_nonexcl_queues``). RabbitMQ 4.2 still
permits them. ``rabbit_stream_fanout`` is not needed: Kronos only casts to
topics, and the option also requires ``rabbit_qos_prefetch_count`` greater
than 0.

Switching an existing deployment: RabbitMQ refuses to redeclare an
existing queue or exchange with a different durability
(``PRECONDITION_FAILED``). Stop the engines and executors, delete the
``kronos.*`` queues, delete the ``openstack`` exchange if nothing else is
bound to it (``rabbitmqctl list_bindings source_name destination_name``),
then start Kronos with the new options.

Policies file
-------------

Expand Down Expand Up @@ -82,9 +109,9 @@ flags or guests retaining an older CPU model after reconfiguration.
Nova's migration pre-check remains authoritative.

Producer source:
`Nova libvirt CPU trait reporting <https://github.com/openstack/nova/blob/stable/2025.2/nova/virt/libvirt/driver.py>`_.
`Nova libvirt CPU trait reporting <https://github.com/openstack/nova/blob/stable/2026.1/nova/virt/libvirt/driver.py>`_.
API source:
`Placement provider traits <https://github.com/openstack/placement/blob/stable/2025.2/placement/handlers/trait.py>`_.
`Placement provider traits <https://github.com/openstack/placement/blob/stable/2026.1/placement/handlers/trait.py>`_.

When the option is enabled, both ``kronos-record`` and engine SIGUSR1
snapshots write ``placement/cpu_traits.json``, a mapping from host names
Expand Down
4 changes: 2 additions & 2 deletions docs/configuration/kronos.conf.sample
Original file line number Diff line number Diff line change
Expand Up @@ -459,13 +459,13 @@
#status_code_retry_delay = <None>

# List of retriable HTTP status codes that should be retried. If not set
# default to [503] (list value)
# default to `[503]` (list value)
#retriable_status_codes = <None>

# DEPRECATED: The default interface for endpoint URL discovery. (string value)
# This option is deprecated for removal.
# Its value may be silently ignored in the future.
# Reason: Using valid-interfaces is preferrable because it is capable of
# Reason: Using valid-interfaces is preferable because it is capable of
# accepting a list of possible interfaces.
#interface = <None>

Expand Down
6 changes: 3 additions & 3 deletions docs/deployment/container.rst
Original file line number Diff line number Diff line change
Expand Up @@ -19,8 +19,8 @@ daemons: the ``command`` in ``config.json`` selects which one starts.

python -m build
docker build -f docker/Dockerfile \
--build-arg BASE_TAG=2025.1-ubuntu-noble \
-t kronos:2025.1-ubuntu-noble .
--build-arg BASE_TAG=2026.1-ubuntu-noble \
-t kronos:2026.1-ubuntu-noble .

``BASE_TAG`` selects the OpenStack release and distro of the base
image; use the same release your cloud runs.
Expand Down Expand Up @@ -50,7 +50,7 @@ Standalone run
-v /etc/kronos/kronos-engine.json:/var/lib/kolla/config_files/config.json:ro \
-v /etc/kronos/kronos.conf:/var/lib/kolla/config_files/kronos.conf:ro \
-v /etc/kronos/policies.yaml:/var/lib/kolla/config_files/policies.yaml:ro \
kronos:2025.1-ubuntu-noble
kronos:2026.1-ubuntu-noble

The executor is the same image with the executor ``config.json``
(its ``command`` carries the ``--aggregate`` flags).
Expand Down
9 changes: 4 additions & 5 deletions kronos/engine/affinity_enforcer.py
Original file line number Diff line number Diff line change
Expand Up @@ -307,12 +307,11 @@ def _detect_violations(
out.append(
_Violation(group=group, offending_uuids=frozenset(offenders)),
)
elif group.policy in AFFINITY_POLICIES:
elif group.policy in AFFINITY_POLICIES and len(hosts_used) > 1:
# Violation when members span more than one host.
if len(hosts_used) > 1:
out.append(
_Violation(group=group, offending_uuids=frozenset(visible)),
)
out.append(
_Violation(group=group, offending_uuids=frozenset(visible)),
)
return out


Expand Down
Loading