Why this project exists
The Kolla-Ansible documentation tells you which command to run. Operating a platform also requires knowing what that command executes: which plays and tasks run, which containers can restart, and what can go wrong. That knowledge is spread across playbooks, roles, handlers and container images, and it is hard to learn from them directly.
The purpose of this project is to make that learning easier. Each release is studied from its source code and explained in operator terms, page by page, from the concepts to the procedures. The goal is not only to give answers, but to help you build your own understanding of how Kolla-Ansible works.
Meet Lumo, your guide
Lumo walks beside you through the Academy: where you are in the journey, what to read next, and what to be careful about. Patient and honest, Lumo says so clearly when the source code does not establish something.
Why "Lumo"? The name comes from lumen, Latin for light. Like the lantern Lumo carries, the Academy sheds light on what Kolla-Ansible really does, one step at a time.
How it helps you learn
-
A statement labelled [CODE] cites the
path:lineof the source it comes from. Open the file next to the page and you learn to read the playbooks yourself. -
What the sources do not establish is labelled [NOT AVAILABLE] instead of being guessed. You know exactly what is proven and what remains to be checked.
-
The concept pages explain the repository, the execution flow of a run and the kolla images, so that the operation pages make sense rather than being recipes to copy.
-
Each OpenStack release is a separate study with its own pages. Reading two of them shows how the behaviour of Kolla-Ansible changed from one release to the next.
A learning journey in five stages
In 2024.1 Caracal · Kolla-Ansible 18.x, the learning journey takes you from the first page to the detailed evidence. Each page tells you where you are and what to read next, and you can mark the pages you have read: your progress stays in your browser.
- Discover: Get your bearings: how the pages are written, the essentials, and the words used everywhere.
- Understand: See how Kolla-Ansible is built and what happens, step by step, when a command runs.
- Practise: Prepare a command before running it: check, predict, then apply one service or one batch at a time.
- Judge the risks: Learn what a tag really touches, why small changes can grow, and which risks and bugs are known.
- Master: Go deeper: how the components depend on each other, the detailed findings, and the limits of what is known.
The study is a reading of the source code: nothing in it was run against a host. Try a procedure on a test platform before you use it on production.
Releases
Each release is a separate study, with its own pages, navigation and search.
Available
-
Ussuri · Kolla-Ansible 10.x
tag
ussuri-eol -
2023.1 Antelope · Kolla-Ansible 16.x
tag
2023.1-eol -
2024.1 Caracal · Kolla-Ansible 18.x
tag
2024.1-eom
Coming soon
The study of these releases is not available yet.