Skip to content

Architecture and concepts

A white stone library and observatory with an open book, brass orrery and telescope.

How Kolla-Ansible 2023.1 is built, how it decides what runs when, how its work grows with the number of compute nodes, and what the kolla images do when a container starts. Repository architecture defines the vocabulary that the other pages build on.

Pages

  • Repository architecture — How the machine is built: which entry points exist, how a CLI command becomes an ansible-playbook run, how site.yml is laid out, what every service role has in common, which custom modules actually touch the hosts, and what ansible-collection-kolla (pulled by requirements.yml) contributes.
  • Deployment execution flow — How Kolla-Ansible 2023.1 decides what runs when: play order, the steps inside each role, handler flush points, batching, and how deploy, reconfigure, upgrade, deploy-containers, genconfig, pull and stop differ.
  • Compute scaling and performance — Which Kolla-Ansible 2023.1 operations grow with the number of compute nodes, why, and how to bound them. No timings are given: work is counted as operations read from the source.
  • Kolla images: start path and one-shot containers — What the kolla images do when a container starts, and what the one-shot containers that Kolla-Ansible starts with KOLLA_BOOTSTRAP, KOLLA_UPGRADE, KOLLA_OSM and similar variables actually run. The images were read, not built or run.