How amonkm/mercator-sync works
mercator-sync has two product workflows: a modular virtualization-to-Mercator orchestrator and a separate Grist processing-register sync. The first selects enabled sources, collects clusters and VMs, enriches and maps them, then upserts Mercator objects; the second refreshes application mappings and transforms processed Grist sheets into Mercator records. Edges follow shown calls/imports or README descriptions. Some orchestration details and configuration wiring are unsampled, so uncertain links are omitted.
Main entry points: sync.py Sync orchestrator · __init__.py Connector registry · registre_sync.py Registry orchestrator · vcenter.py vCenter connector
Components 19
Virtualization sync
- Sync orchestrator
sync.py - Source configuration
config/sources.yaml
Source connectors
- Connector registry
connectors/__init__.py - Connector interface
connectors/base.py - Config types
connectors/config_types.py - vCenter connector
connectors/vcenter.py - XOA connector
connectors/xoa.py - Proxmox connector
connectors/proxmox.py
Grist registry sync
- Registry orchestrator
Registre-sync/registre_sync.py - Grist client
Registre-sync/grist_client.py - Payload transform
Registre-sync/transform.py - Registry template
Registre-sync/Registres-Protection-des-Donnees-template.grist
Mercator integration
- Mercator client
sync.py
Other components
- Operator
- vCenter
- XOA
- Proxmox
- Grist
- Mercator
Connections 26
- Operator → Sync orchestrator: runs
README.md - Operator → Registry orchestrator: runs
README.md - Sync orchestrator → Source configuration: loads
README.md - Sync orchestrator → Connector registry: selects connector
sync.py - Connector registry → vCenter connector: registers
connectors/__init__.py - Connector registry → XOA connector: registers
connectors/__init__.py - Connector registry → Proxmox connector: registers
connectors/__init__.py - vCenter connector → Connector interface: inherits
connectors/vcenter.py - XOA connector → Connector interface: inherits
connectors/xoa.py - Proxmox connector → Connector interface: inherits
connectors/proxmox.py - Connector interface → Config types: uses types
connectors/base.py - Sync orchestrator → vCenter connector: fetches and maps
sync.py - Sync orchestrator → XOA connector: fetches and maps
sync.py - Sync orchestrator → Proxmox connector: fetches and maps
sync.py - vCenter connector → vCenter: calls API
connectors/vcenter.py - XOA connector → XOA: calls API
connectors/xoa.py - Proxmox connector → Proxmox: calls API
connectors/proxmox.py - Sync orchestrator → Mercator client: upserts objects
sync.py - Mercator client → Mercator: calls API
sync.py - Registry orchestrator → Grist client: reads and maps
Registre-sync/registre_sync.py - Registry orchestrator → Payload transform: builds payloads
Registre-sync/registre_sync.py - Registry orchestrator → Mercator client: indexes and upserts
Registre-sync/registre_sync.py - Grist client → Grist: reads and writes
Registre-sync/grist_client.py - Grist client → Mercator client: reads applications
Registre-sync/grist_client.py - Payload transform → Config types: uses types
Registre-sync/transform.py - Grist → Registry template: imports template
README.md