# didin2003/kolla-ansible architecture

> Architecture diagram of the GitHub repository didin2003/kolla-ansible, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/didin2003/kolla-ansible
- Repository: https://github.com/didin2003/kolla-ansible

## Overview

Kolla Ansible deploys and operates OpenStack clouds and supporting infrastructure in containers. The main workflow is an operator invoking a CLI action, which selects and runs Ansible playbooks; Ansible modules then manage containers through Docker or Podman and systemd support. The README documents a broad service catalog, but playbooks and role implementations are not present in this tree, so those deployment details are represented at a high level. The graph also includes configuration filters and password utilities; links among unsampled subsystems are omitted where evidence is unavailable.

Main entry points: [`ansible/module_utils/kolla_container_worker.py`](https://github.com/didin2003/kolla-ansible/blob/master/ansible/module_utils/kolla_container_worker.py) (Container worker), [`ansible/library/kolla_container.py`](https://github.com/didin2003/kolla-ansible/blob/master/ansible/library/kolla_container.py) (Container module), [`ansible/filter_plugins/address.py`](https://github.com/didin2003/kolla-ansible/blob/master/ansible/filter_plugins/address.py) (Address filter plugin), [`ansible/module_utils/kolla_docker_worker.py`](https://github.com/didin2003/kolla-ansible/blob/master/ansible/module_utils/kolla_docker_worker.py) (Docker worker)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_operator["CLI orchestration"]
  node_cli["Command actions<br/>[commands.py]"]
  node_ansible_args["Playbook runner<br/>[ansible.py]"]
end

subgraph group_runtime["Container runtime"]
  node_container_module["Container module<br/>[kolla_container.py]"]
  node_container_facts["Container facts"]
  node_toolbox["Toolbox module<br/>[kolla_toolbox.py]"]
  node_container_worker["Container worker"]
  node_docker_worker["Docker worker"]
  node_podman_worker["Podman worker"]
  node_systemd_worker["Systemd worker"]
end

subgraph group_filters["Ansible extensions"]
  node_service_filters["Service filters<br/>[filters.py]"]
  node_service_filter_plugin["Service filter plugin<br/>[services.py]"]
  node_address_filters["Address filters<br/>[kolla_address.py]"]
  node_url_filters["URL filters<br/>[kolla_url.py]"]
  node_address_context["Address formatting"]
  node_address_plugin["Address filter plugin<br/>[address.py]"]
  node_database_shards["Database shard filter<br/>[database_shards.py]"]
  node_database_plugin["Database filter plugin<br/>[database.py]"]
  node_nova_filters["Nova filters<br/>[nova_filters.py]"]
  node_nova_plugin["Nova filter plugin"]
  node_fluentd_filters["Fluentd filters<br/>[fluentd_filters.py]"]
  node_fluentd_plugin["Fluentd filter plugin"]
  node_merge_configs["Config merge action<br/>[merge_configs.py]"]
  node_merge_yaml["YAML merge action<br/>[merge_yaml.py]"]
end

subgraph group_secrets["Password utilities"]
  node_password_commands["Password commands<br/>[genpwd.py]"]
  node_vault["Vault helpers<br/>[hashi_vault.py]"]
  node_password_read["Read passwords<br/>[readpwd.py]"]
  node_password_write["Write passwords<br/>[writepwd.py]"]
  node_password_merge["Merge passwords<br/>[mergepwd.py]"]
end

subgraph group_capabilities["Deployment scope"]
  node_deployment["Ansible deployment"]
  node_service_catalog["OpenStack services"]
end

node_operator(("Cloud operator"))
node_ansible_engine["Ansible"]
node_container_engines["Container engines"]
node_systemd["systemd"]

node_operator -->|"invokes"| node_cli
node_cli -->|"runs playbooks"| node_ansible_args
node_ansible_args -->|"executes"| node_ansible_engine
node_container_module -->|"delegates"| node_container_worker
node_container_module -->|"dispatches"| node_docker_worker
node_container_module -->|"dispatches"| node_podman_worker
node_container_worker -->|"uses"| node_systemd_worker
node_docker_worker -->|"extends"| node_container_worker
node_podman_worker -->|"extends"| node_container_worker
node_docker_worker -.->|"manages"| node_container_engines
node_podman_worker -.->|"manages"| node_container_engines
node_systemd_worker -->|"controls"| node_systemd
node_service_filter_plugin -->|"registers"| node_service_filters
node_address_plugin -->|"registers"| node_address_filters
node_address_plugin -->|"registers"| node_url_filters
node_address_plugin -->|"registers"| node_address_context
node_database_plugin -->|"registers"| node_database_shards
node_nova_plugin -->|"registers"| node_nova_filters
node_fluentd_plugin -->|"registers"| node_fluentd_filters
node_password_read -->|"uses"| node_vault
node_password_write -->|"uses"| node_vault
node_ansible_engine -.->|"applies playbooks"| node_deployment
node_deployment -->|"deploys"| node_service_catalog

click node_cli "https://github.com/didin2003/kolla-ansible/blob/master/kolla_ansible/cli/commands.py"
click node_ansible_args "https://github.com/didin2003/kolla-ansible/blob/master/kolla_ansible/ansible.py"
click node_container_module "https://github.com/didin2003/kolla-ansible/blob/master/ansible/library/kolla_container.py"
click node_container_facts "https://github.com/didin2003/kolla-ansible/blob/master/ansible/library/kolla_container_facts.py"
click node_toolbox "https://github.com/didin2003/kolla-ansible/blob/master/ansible/library/kolla_toolbox.py"
click node_container_worker "https://github.com/didin2003/kolla-ansible/blob/master/ansible/module_utils/kolla_container_worker.py"
click node_docker_worker "https://github.com/didin2003/kolla-ansible/blob/master/ansible/module_utils/kolla_docker_worker.py"
click node_podman_worker "https://github.com/didin2003/kolla-ansible/blob/master/ansible/module_utils/kolla_podman_worker.py"
click node_systemd_worker "https://github.com/didin2003/kolla-ansible/blob/master/ansible/module_utils/kolla_systemd_worker.py"
click node_service_filters "https://github.com/didin2003/kolla-ansible/blob/master/kolla_ansible/filters.py"
click node_service_filter_plugin "https://github.com/didin2003/kolla-ansible/blob/master/ansible/filter_plugins/services.py"
click node_address_filters "https://github.com/didin2003/kolla-ansible/blob/master/kolla_ansible/kolla_address.py"
click node_url_filters "https://github.com/didin2003/kolla-ansible/blob/master/kolla_ansible/kolla_url.py"
click node_address_context "https://github.com/didin2003/kolla-ansible/blob/master/kolla_ansible/put_address_in_context.py"
click node_address_plugin "https://github.com/didin2003/kolla-ansible/blob/master/ansible/filter_plugins/address.py"
click node_database_shards "https://github.com/didin2003/kolla-ansible/blob/master/kolla_ansible/database_shards.py"
click node_database_plugin "https://github.com/didin2003/kolla-ansible/blob/master/ansible/filter_plugins/database.py"
click node_nova_filters "https://github.com/didin2003/kolla-ansible/blob/master/kolla_ansible/nova_filters.py"
click node_nova_plugin "https://github.com/didin2003/kolla-ansible/blob/master/ansible/roles/nova-cell/filter_plugins/kolla_nova_cell_filters.py"
click node_fluentd_filters "https://github.com/didin2003/kolla-ansible/blob/master/kolla_ansible/fluentd_filters.py"
click node_fluentd_plugin "https://github.com/didin2003/kolla-ansible/blob/master/ansible/roles/fluentd/filter_plugins/kolla_common_filters.py"
click node_merge_configs "https://github.com/didin2003/kolla-ansible/blob/master/ansible/action_plugins/merge_configs.py"
click node_merge_yaml "https://github.com/didin2003/kolla-ansible/blob/master/ansible/action_plugins/merge_yaml.py"
click node_password_commands "https://github.com/didin2003/kolla-ansible/blob/master/kolla_ansible/cmd/genpwd.py"
click node_vault "https://github.com/didin2003/kolla-ansible/blob/master/kolla_ansible/hashi_vault.py"
click node_password_read "https://github.com/didin2003/kolla-ansible/blob/master/kolla_ansible/cmd/readpwd.py"
click node_password_write "https://github.com/didin2003/kolla-ansible/blob/master/kolla_ansible/cmd/writepwd.py"
click node_password_merge "https://github.com/didin2003/kolla-ansible/blob/master/kolla_ansible/cmd/mergepwd.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_cli,node_ansible_args toneBlue
class node_container_module,node_container_facts,node_toolbox,node_container_worker,node_docker_worker,node_podman_worker,node_systemd_worker toneAmber
class node_service_filters,node_service_filter_plugin,node_address_filters,node_url_filters,node_address_context,node_address_plugin,node_database_shards,node_database_plugin,node_nova_filters,node_nova_plugin,node_fluentd_filters,node_fluentd_plugin,node_merge_configs,node_merge_yaml toneMint
class node_password_commands,node_vault,node_password_read,node_password_write,node_password_merge toneRose
class node_deployment,node_service_catalog,node_operator,node_ansible_engine,node_container_engines,node_systemd toneIndigo
```

## Components

### CLI orchestration

- [Command actions](https://github.com/didin2003/kolla-ansible/blob/master/kolla_ansible/cli/commands.py): `kolla_ansible/cli/commands.py`
- [Playbook runner](https://github.com/didin2003/kolla-ansible/blob/master/kolla_ansible/ansible.py): `kolla_ansible/ansible.py`

### Container runtime

- [Container module](https://github.com/didin2003/kolla-ansible/blob/master/ansible/library/kolla_container.py): `ansible/library/kolla_container.py`
- [Container facts](https://github.com/didin2003/kolla-ansible/blob/master/ansible/library/kolla_container_facts.py): `ansible/library/kolla_container_facts.py`
- [Toolbox module](https://github.com/didin2003/kolla-ansible/blob/master/ansible/library/kolla_toolbox.py): `ansible/library/kolla_toolbox.py`
- [Container worker](https://github.com/didin2003/kolla-ansible/blob/master/ansible/module_utils/kolla_container_worker.py): `ansible/module_utils/kolla_container_worker.py`
- [Docker worker](https://github.com/didin2003/kolla-ansible/blob/master/ansible/module_utils/kolla_docker_worker.py): `ansible/module_utils/kolla_docker_worker.py`
- [Podman worker](https://github.com/didin2003/kolla-ansible/blob/master/ansible/module_utils/kolla_podman_worker.py): `ansible/module_utils/kolla_podman_worker.py`
- [Systemd worker](https://github.com/didin2003/kolla-ansible/blob/master/ansible/module_utils/kolla_systemd_worker.py): `ansible/module_utils/kolla_systemd_worker.py`

### Ansible extensions

- [Service filters](https://github.com/didin2003/kolla-ansible/blob/master/kolla_ansible/filters.py): `kolla_ansible/filters.py`
- [Service filter plugin](https://github.com/didin2003/kolla-ansible/blob/master/ansible/filter_plugins/services.py): `ansible/filter_plugins/services.py`
- [Address filters](https://github.com/didin2003/kolla-ansible/blob/master/kolla_ansible/kolla_address.py): `kolla_ansible/kolla_address.py`
- [URL filters](https://github.com/didin2003/kolla-ansible/blob/master/kolla_ansible/kolla_url.py): `kolla_ansible/kolla_url.py`
- [Address formatting](https://github.com/didin2003/kolla-ansible/blob/master/kolla_ansible/put_address_in_context.py): `kolla_ansible/put_address_in_context.py`
- [Address filter plugin](https://github.com/didin2003/kolla-ansible/blob/master/ansible/filter_plugins/address.py): `ansible/filter_plugins/address.py`
- [Database shard filter](https://github.com/didin2003/kolla-ansible/blob/master/kolla_ansible/database_shards.py): `kolla_ansible/database_shards.py`
- [Database filter plugin](https://github.com/didin2003/kolla-ansible/blob/master/ansible/filter_plugins/database.py): `ansible/filter_plugins/database.py`
- [Nova filters](https://github.com/didin2003/kolla-ansible/blob/master/kolla_ansible/nova_filters.py): `kolla_ansible/nova_filters.py`
- [Nova filter plugin](https://github.com/didin2003/kolla-ansible/blob/master/ansible/roles/nova-cell/filter_plugins/kolla_nova_cell_filters.py): `ansible/roles/nova-cell/filter_plugins/kolla_nova_cell_filters.py`
- [Fluentd filters](https://github.com/didin2003/kolla-ansible/blob/master/kolla_ansible/fluentd_filters.py): `kolla_ansible/fluentd_filters.py`
- [Fluentd filter plugin](https://github.com/didin2003/kolla-ansible/blob/master/ansible/roles/fluentd/filter_plugins/kolla_common_filters.py): `ansible/roles/fluentd/filter_plugins/kolla_common_filters.py`
- [Config merge action](https://github.com/didin2003/kolla-ansible/blob/master/ansible/action_plugins/merge_configs.py): `ansible/action_plugins/merge_configs.py`
- [YAML merge action](https://github.com/didin2003/kolla-ansible/blob/master/ansible/action_plugins/merge_yaml.py): `ansible/action_plugins/merge_yaml.py`

### Password utilities

- [Password commands](https://github.com/didin2003/kolla-ansible/blob/master/kolla_ansible/cmd/genpwd.py): `kolla_ansible/cmd/genpwd.py`
- [Vault helpers](https://github.com/didin2003/kolla-ansible/blob/master/kolla_ansible/hashi_vault.py): `kolla_ansible/hashi_vault.py`
- [Read passwords](https://github.com/didin2003/kolla-ansible/blob/master/kolla_ansible/cmd/readpwd.py): `kolla_ansible/cmd/readpwd.py`
- [Write passwords](https://github.com/didin2003/kolla-ansible/blob/master/kolla_ansible/cmd/writepwd.py): `kolla_ansible/cmd/writepwd.py`
- [Merge passwords](https://github.com/didin2003/kolla-ansible/blob/master/kolla_ansible/cmd/mergepwd.py): `kolla_ansible/cmd/mergepwd.py`

### Deployment scope

- **Ansible deployment**
- **OpenStack services**

### Other components

- **Cloud operator**
- **Ansible**
- **Container engines**
- **systemd**

## Connections

- Cloud operator → Command actions: invokes (evidence: `kolla_ansible/cli/commands.py`)
- Command actions → Playbook runner: runs playbooks (evidence: `kolla_ansible/cli/commands.py`)
- Playbook runner → Ansible: executes (evidence: `kolla_ansible/ansible.py`)
- Container module → Container worker: delegates (evidence: `ansible/library/kolla_container.py`)
- Container module → Docker worker: dispatches (evidence: `ansible/library/kolla_container.py`)
- Container module → Podman worker: dispatches (evidence: `ansible/library/kolla_container.py`)
- Container worker → Systemd worker: uses (evidence: `ansible/module_utils/kolla_container_worker.py`)
- Docker worker → Container worker: extends (evidence: `ansible/module_utils/kolla_docker_worker.py`)
- Podman worker → Container worker: extends (evidence: `ansible/module_utils/kolla_podman_worker.py`)
- Docker worker → Container engines: manages
- Podman worker → Container engines: manages
- Systemd worker → systemd: controls (evidence: `ansible/module_utils/kolla_systemd_worker.py`)
- Service filter plugin → Service filters: registers (evidence: `ansible/filter_plugins/services.py`)
- Address filter plugin → Address filters: registers (evidence: `ansible/filter_plugins/address.py`)
- Address filter plugin → URL filters: registers (evidence: `ansible/filter_plugins/address.py`)
- Address filter plugin → Address formatting: registers (evidence: `ansible/filter_plugins/address.py`)
- Database filter plugin → Database shard filter: registers (evidence: `ansible/filter_plugins/database.py`)
- Nova filter plugin → Nova filters: registers (evidence: `ansible/roles/nova-cell/filter_plugins/kolla_nova_cell_filters.py`)
- Fluentd filter plugin → Fluentd filters: registers (evidence: `ansible/roles/fluentd/filter_plugins/kolla_common_filters.py`)
- Read passwords → Vault helpers: uses (evidence: `kolla_ansible/cmd/readpwd.py`)
- Write passwords → Vault helpers: uses (evidence: `kolla_ansible/cmd/writepwd.py`)
- Ansible → Ansible deployment: applies playbooks
- Ansible deployment → OpenStack services: deploys (evidence: `README.rst`)
