# kizaru1294989/ansible-multivendor-automatisation architecture

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

- Interactive diagram: https://gitdiagram.com/kizaru1294989/ansible-multivendor-automatisation
- Repository: https://github.com/kizaru1294989/ansible-multivendor-automatisation

## Overview

This repository is a CLI-driven Arista fabric discovery and Ansible configuration-generation toolkit, with separate LLDP topology mapping and backup/restore playbooks. The main workflow discovers a fabric, collects operator input for fabric settings, and generates Ansible inventory variables. Ansible then provides the deployment and restore surface. The README mainly contains unrelated Next.js/Go discussion, so product capabilities and relationships here are grounded in the tree and sampled source; links to unsampled playbook wiring are left unverified.

Main entry points: [`main.py`](https://github.com/kizaru1294989/ansible-multivendor-automatisation/blob/main/main.py) (Workflow CLI), [`playbooks/deploy.yml`](https://github.com/kizaru1294989/ansible-multivendor-automatisation/blob/main/playbooks/deploy.yml) (Fabric deployment), [`lldp_mapper.py`](https://github.com/kizaru1294989/ansible-multivendor-automatisation/blob/main/lldp_mapper.py) (LLDP mapper), [`inventories`](https://github.com/kizaru1294989/ansible-multivendor-automatisation/tree/main/inventories) (Ansible inventories)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Fabric workflow"]
  node_main["Workflow CLI<br/>[main.py]"]
  node_fabric_vars["Fabric variables"]
  node_generator["Variable generator"]
  node_legacy_generator["Static variable generator<br/>[generate_vars.py]"]
end

subgraph group_topology["Topology discovery"]
  node_discovery["Fabric discovery<br/>[discover_fabric.py]"]
end

subgraph group_ansible["Ansible operations"]
  node_inventories["Ansible inventories"]
  node_deploy_playbook["Fabric deployment<br/>[deploy.yml]"]
  node_isn_playbook["ISN deployment<br/>[isn_deploy.yml]"]
  node_cli_playbook["CLI operations<br/>[cli.yml]"]
  node_backup_playbook["Backup operations"]
  node_restore_playbook["Configuration restore<br/>[restore.yml]"]
  node_bgp_role["BGP configuration"]
  node_mlag_role["MLAG configuration"]
  node_evpn_role["VXLAN EVPN"]
  node_restore_role["Reset configuration"]
end

subgraph group_support["Topology mapping"]
  node_mapper["LLDP mapper<br/>[lldp_mapper.py]"]
  node_topology_graph["Topology graph<br/>[lldp_mapper.py]"]
  node_html_map["HTML topology map<br/>[network_map.html]"]
end

node_operator(("Network operator"))
node_device_api{{"Arista switches"}}

node_operator -->|"runs workflow"| node_main
node_main -->|"starts discovery"| node_discovery
node_discovery -->|"queries eAPI"| node_device_api
node_main -->|"collects settings"| node_operator
node_main -->|"writes discovery data"| node_fabric_vars
node_main -->|"invokes generation"| node_generator
node_generator -->|"writes variables"| node_inventories
node_operator -.->|"runs deployment"| node_deploy_playbook
node_inventories -.->|"provides inputs"| node_deploy_playbook
node_deploy_playbook -.->|"uses role"| node_bgp_role
node_deploy_playbook -.->|"uses role"| node_mlag_role
node_deploy_playbook -.->|"uses role"| node_evpn_role
node_operator -.->|"runs deployment"| node_isn_playbook
node_operator -.->|"runs commands"| node_cli_playbook
node_operator -.->|"runs backups"| node_backup_playbook
node_operator -.->|"runs restore"| node_restore_playbook
node_restore_playbook -.->|"uses role"| node_restore_role
node_operator -->|"runs mapper"| node_mapper
node_mapper -->|"collects LLDP"| node_device_api
node_mapper -->|"builds graph"| node_topology_graph
node_topology_graph -->|"renders map"| node_html_map
node_operator -.->|"runs generation"| node_legacy_generator
node_legacy_generator -->|"writes variables"| node_inventories

click node_main "https://github.com/kizaru1294989/ansible-multivendor-automatisation/blob/main/main.py"
click node_discovery "https://github.com/kizaru1294989/ansible-multivendor-automatisation/blob/main/discover_fabric.py"
click node_generator "https://github.com/kizaru1294989/ansible-multivendor-automatisation/blob/main/generate_vars_auto.py"
click node_inventories "https://github.com/kizaru1294989/ansible-multivendor-automatisation/tree/main/inventories"
click node_deploy_playbook "https://github.com/kizaru1294989/ansible-multivendor-automatisation/blob/main/playbooks/deploy.yml"
click node_isn_playbook "https://github.com/kizaru1294989/ansible-multivendor-automatisation/blob/main/playbooks/isn_deploy.yml"
click node_cli_playbook "https://github.com/kizaru1294989/ansible-multivendor-automatisation/blob/main/playbooks/cli.yml"
click node_backup_playbook "https://github.com/kizaru1294989/ansible-multivendor-automatisation/tree/main/playbooks/backups"
click node_restore_playbook "https://github.com/kizaru1294989/ansible-multivendor-automatisation/blob/main/playbooks/restore.yml"
click node_bgp_role "https://github.com/kizaru1294989/ansible-multivendor-automatisation/tree/main/roles/arista/arista_bgp"
click node_mlag_role "https://github.com/kizaru1294989/ansible-multivendor-automatisation/tree/main/roles/arista/arista_mlag"
click node_evpn_role "https://github.com/kizaru1294989/ansible-multivendor-automatisation/tree/main/roles/arista/arista_vxlan-evpn_l3"
click node_restore_role "https://github.com/kizaru1294989/ansible-multivendor-automatisation/tree/main/roles/arista/arista_restore"
click node_mapper "https://github.com/kizaru1294989/ansible-multivendor-automatisation/blob/main/lldp_mapper.py"
click node_topology_graph "https://github.com/kizaru1294989/ansible-multivendor-automatisation/blob/main/lldp_mapper.py"
click node_html_map "https://github.com/kizaru1294989/ansible-multivendor-automatisation/blob/main/network_map.html"
click node_legacy_generator "https://github.com/kizaru1294989/ansible-multivendor-automatisation/blob/main/generate_vars.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_main,node_fabric_vars,node_generator,node_legacy_generator toneBlue
class node_discovery toneAmber
class node_inventories,node_deploy_playbook,node_isn_playbook,node_cli_playbook,node_backup_playbook,node_restore_playbook,node_bgp_role,node_mlag_role,node_evpn_role,node_restore_role toneMint
class node_mapper,node_topology_graph,node_html_map toneRose
class node_operator,node_device_api toneIndigo
```

## Components

### Fabric workflow

- [Workflow CLI](https://github.com/kizaru1294989/ansible-multivendor-automatisation/blob/main/main.py): `main.py`
- **Fabric variables**
- [Variable generator](https://github.com/kizaru1294989/ansible-multivendor-automatisation/blob/main/generate_vars_auto.py): `generate_vars_auto.py`
- [Static variable generator](https://github.com/kizaru1294989/ansible-multivendor-automatisation/blob/main/generate_vars.py): `generate_vars.py`

### Topology discovery

- [Fabric discovery](https://github.com/kizaru1294989/ansible-multivendor-automatisation/blob/main/discover_fabric.py): `discover_fabric.py`

### Ansible operations

- [Ansible inventories](https://github.com/kizaru1294989/ansible-multivendor-automatisation/tree/main/inventories): `inventories`
- [Fabric deployment](https://github.com/kizaru1294989/ansible-multivendor-automatisation/blob/main/playbooks/deploy.yml): `playbooks/deploy.yml`
- [ISN deployment](https://github.com/kizaru1294989/ansible-multivendor-automatisation/blob/main/playbooks/isn_deploy.yml): `playbooks/isn_deploy.yml`
- [CLI operations](https://github.com/kizaru1294989/ansible-multivendor-automatisation/blob/main/playbooks/cli.yml): `playbooks/cli.yml`
- [Backup operations](https://github.com/kizaru1294989/ansible-multivendor-automatisation/tree/main/playbooks/backups): `playbooks/backups`
- [Configuration restore](https://github.com/kizaru1294989/ansible-multivendor-automatisation/blob/main/playbooks/restore.yml): `playbooks/restore.yml`
- [BGP configuration](https://github.com/kizaru1294989/ansible-multivendor-automatisation/tree/main/roles/arista/arista_bgp): `roles/arista/arista_bgp`
- [MLAG configuration](https://github.com/kizaru1294989/ansible-multivendor-automatisation/tree/main/roles/arista/arista_mlag): `roles/arista/arista_mlag`
- [VXLAN EVPN](https://github.com/kizaru1294989/ansible-multivendor-automatisation/tree/main/roles/arista/arista_vxlan-evpn_l3): `roles/arista/arista_vxlan-evpn_l3`
- [Reset configuration](https://github.com/kizaru1294989/ansible-multivendor-automatisation/tree/main/roles/arista/arista_restore): `roles/arista/arista_restore`

### Topology mapping

- [LLDP mapper](https://github.com/kizaru1294989/ansible-multivendor-automatisation/blob/main/lldp_mapper.py): `lldp_mapper.py`
- [Topology graph](https://github.com/kizaru1294989/ansible-multivendor-automatisation/blob/main/lldp_mapper.py): `lldp_mapper.py`
- [HTML topology map](https://github.com/kizaru1294989/ansible-multivendor-automatisation/blob/main/network_map.html): `network_map.html`

### Other components

- **Network operator**
- **Arista switches**

## Connections

- Network operator → Workflow CLI: runs workflow (evidence: `main.py`)
- Workflow CLI → Fabric discovery: starts discovery (evidence: `main.py`)
- Fabric discovery → Arista switches: queries eAPI (evidence: `discover_fabric.py`)
- Workflow CLI → Network operator: collects settings (evidence: `main.py`)
- Workflow CLI → Fabric variables: writes discovery data
- Workflow CLI → Variable generator: invokes generation (evidence: `main.py`)
- Variable generator → Ansible inventories: writes variables (evidence: `generate_vars_auto.py`)
- Network operator → Fabric deployment: runs deployment
- Ansible inventories → Fabric deployment: provides inputs
- Fabric deployment → BGP configuration: uses role
- Fabric deployment → MLAG configuration: uses role
- Fabric deployment → VXLAN EVPN: uses role
- Network operator → ISN deployment: runs deployment
- Network operator → CLI operations: runs commands
- Network operator → Backup operations: runs backups
- Network operator → Configuration restore: runs restore
- Configuration restore → Reset configuration: uses role
- Network operator → LLDP mapper: runs mapper (evidence: `lldp_mapper.py`)
- LLDP mapper → Arista switches: collects LLDP (evidence: `lldp_mapper.py`)
- LLDP mapper → Topology graph: builds graph (evidence: `lldp_mapper.py`)
- Topology graph → HTML topology map: renders map (evidence: `lldp_mapper.py`)
- Network operator → Static variable generator: runs generation
- Static variable generator → Ansible inventories: writes variables (evidence: `generate_vars.py`)
