How yandex/mysync works
MySync coordinates high availability for homogeneous MySQL clusters, using ZooKeeper for shared state and locks. The main workflow is to run the agent, monitor cluster health and replication, then coordinate failover or an operator-requested switchover; operators can also inspect hosts and control maintenance. The graph includes replication repair and replica optimization as distinct operational stages. Relationships are limited to README statements and source references shown in the supplied excerpts and index; some subsystem details are unsampled.
Main entry points: app.go Agent and workflow · optimization.go Optimization DCS adapter · cluster.go MySQL cluster · app_dcs_impl.go DCS integration
Components 20
Operator interface
- MySync agent
cmd/mysync/main.go - Host commands
internal/app/cli_host.go - Switch commands
internal/app/cli_switch.go - Maintenance commands
cmd/mysync/maintenance.go - Info commands
internal/app/cli_info.go
Cluster coordination
- Agent and workflow
internal/app/app.go - Cluster state exchange
internal/app/app_dcs.go - DCS integration
internal/app/app_dcs_impl.go - Node state model
internal/app/node_state/node_state.go - Configuration
internal/config/config.go
Replication management
- Repair and switchover
internal/app/replication.go - Replica optimization
internal/app/optimization/controller.go - Optimization DCS adapter
internal/app/dcs/optimization.go
Cluster infrastructure
- MySQL cluster
internal/mysql/cluster.go - MySQL node operations
internal/mysql/node.go - Replication operations
internal/mysql/replication.go - ZooKeeper DCS
internal/dcs/zk.go
Other components
- Operator
- ZooKeeper
- MySQL cluster nodes
Connections 27
- Operator → MySync agent: starts
cmd/mysync/main.go - MySync agent → Agent and workflow: creates and runs
cmd/mysync/main.go - Operator → Host commands: manages hosts
- Operator → Switch commands: requests switch
- Operator → Maintenance commands: sets maintenance
cmd/mysync/maintenance.go - Operator → Info commands: requests status
- Host commands → MySQL cluster: manages hosts
internal/app/cli_host.go - Agent and workflow → Configuration: uses settings
internal/app/app.go - Agent and workflow → MySQL cluster: coordinates cluster
internal/app/app.go - Agent and workflow → Node state model: evaluates state
internal/app/app.go - Agent and workflow → Cluster state exchange: exchanges state
internal/app/app.go - Agent and workflow → DCS integration: uses DCS integration
internal/app/app.go - Agent and workflow → Repair and switchover: coordinates repair
internal/app/app.go - Agent and workflow → Replica optimization: controls optimization
internal/app/app.go - Cluster state exchange → Node state model: uses state model
internal/app/app_dcs.go - DCS integration → ZooKeeper DCS: uses DCS
internal/app/app_dcs_impl.go - DCS integration → Configuration: uses settings
internal/app/app_dcs_impl.go - Replica optimization → Optimization DCS adapter: reads optimization state
internal/app/optimization/controller.go - Optimization DCS adapter → MySQL cluster: gets cluster nodes
internal/app/dcs/optimization.go - Optimization DCS adapter → Node state model: reads node state
internal/app/dcs/optimization.go - Optimization DCS adapter → ZooKeeper DCS: reads and writes DCS
internal/app/dcs/optimization.go - Repair and switchover → MySQL node operations: repairs replication
internal/app/replication.go - Repair and switchover → Replica optimization: enables optimization
internal/app/replication.go - MySQL cluster → MySQL node operations: manages nodes
internal/mysql/cluster.go - MySQL node operations → MySQL cluster nodes: queries and controls
- Replication operations → MySQL cluster nodes: controls replication
- ZooKeeper DCS → ZooKeeper: stores cluster state