How openstack/kolla-ansible works
Kolla Ansible is an Ansible-based deployment and operations tool for containerized OpenStack services and infrastructure. Operators invoke CLI commands such as deploy, upgrade, and reconfigure; the command layer selects playbooks, and the Ansible runner assembles configuration and launches Ansible. Ansible’s container module manages container lifecycle through Docker or Podman workers, with systemd integration. The README documents broad OpenStack and infrastructure coverage, but their playbooks are not in this tree. The graph includes indexed runtime modules and password utilities; unsampled deployment wiring is omitted.
Main entry points: commands.py Operations commands · kolla_container.py Container module · kolla_container_worker.py Container worker · ansible.py Ansible runner
Components 28
CLI and orchestration
- Operations commands
kolla_ansible/cli/commands.py - Ansible runner
kolla_ansible/ansible.py
Container runtime
- Container module
ansible/library/kolla_container.py - Container worker
ansible/module_utils/kolla_container_worker.py - Docker worker
ansible/module_utils/kolla_docker_worker.py - Podman worker
ansible/module_utils/kolla_podman_worker.py - Systemd worker
ansible/module_utils/kolla_systemd_worker.py - Container facts
ansible/library/kolla_container_facts.py - Kolla toolbox
ansible/library/kolla_toolbox.py
Ansible filters
- Service filters
kolla_ansible/filters.py - Service filter plugin
ansible/filter_plugins/services.py - Address filters
kolla_ansible/kolla_address.py - Address filter plugin
ansible/filter_plugins/address.py - URL formatting
kolla_ansible/kolla_url.py - Address context
kolla_ansible/put_address_in_context.py - Database shards
kolla_ansible/database_shards.py - Database filter plugin
ansible/filter_plugins/database.py - Nova filters
kolla_ansible/nova_filters.py - Fluentd filters
kolla_ansible/fluentd_filters.py
Password utilities
- Password commands
kolla_ansible/cmd/genpwd.py - Vault utilities
kolla_ansible/hashi_vault.py - Read passwords
kolla_ansible/cmd/readpwd.py - Write passwords
kolla_ansible/cmd/writepwd.py - Merge passwords
kolla_ansible/cmd/mergepwd.py
Deployed cloud
- Cloud services
ansible - Infrastructure services
ansible
Other components
- Operator
- Ansible
Connections 23
- Operator → Operations commands: invokes
- Operations commands → Ansible runner: runs playbooks
kolla_ansible/cli/commands.py - Ansible runner → Ansible: launches
kolla_ansible/ansible.py - Ansible → Container module: dispatches module
- Container module → Container worker: uses worker
ansible/library/kolla_container.py - Container module → Docker worker: uses backend
ansible/library/kolla_container.py - Container module → Podman worker: uses backend
ansible/library/kolla_container.py - Container worker → Systemd worker: uses systemd
ansible/module_utils/kolla_container_worker.py - Docker worker → Container worker: extends worker
ansible/module_utils/kolla_docker_worker.py - Podman worker → Container worker: extends worker
ansible/module_utils/kolla_podman_worker.py - Operations commands → Cloud services: deploys
README.rst - Operations commands → Infrastructure services: deploys
README.rst - Service filter plugin → Service filters: exposes
ansible/filter_plugins/services.py - Address filter plugin → Address filters: exposes
ansible/filter_plugins/address.py - Address filters → URL formatting: formats URLs
kolla_ansible/kolla_url.py - URL formatting → Address context: formats context
kolla_ansible/kolla_url.py - Database filter plugin → Database shards: exposes
ansible/filter_plugins/database.py - Read passwords → Vault utilities: reads vault
kolla_ansible/cmd/readpwd.py - Write passwords → Vault utilities: writes vault
kolla_ansible/cmd/writepwd.py - Operator → Password commands: generates secrets
- Operator → Read passwords: reads secrets
- Operator → Write passwords: writes secrets
- Operator → Merge passwords: merges secrets