ClickHouse 概览

clickhouse_ansible 是 dbbot 仓中的 ClickHouse 自动化子目录，面向 MySQL 下游 OLAP 场景，提供集群部署、备份、恢复和日常运维所需的基础剧本与文档。

1. 适用范围

适用于以下场景：

  • 使用 ClickHouse 承接 MySQL 下游分析、报表或明细查询场景。
  • 需要通过 Ansible 统一交付 ClickHouse 集群。
  • 需要为 ClickHouse 建立标准化备份与恢复流程。

默认文档示例使用 3 分片 2 副本拓扑，但 Playbook 的设计并不局限于该拓扑。

2. 仓内位置

典型路径：

/usr/local/dbbot/clickhouse_ansible

与 ClickHouse 相关的核心目录包括：

  • inventory/：部署、备份、恢复等场景的主机清单。
  • playbooks/：入口 Playbook 与变量文件。
  • roles/：系统初始化、ZooKeeper / Keeper、ClickHouse 部署角色。
  • downloads/：ClickHouse 与 ZooKeeper 安装包。
  • artifacts/manifests/：备份与恢复运行产物。

3. 建议阅读顺序

  1. 集群部署
  2. 备份
  3. 恢复
  4. 变量与参数说明
  5. 运维与排障
  6. 目录结构与配置
  7. 部署、备份与恢复规范

4. 推荐前置条件

  • 控制节点已安装 dbbot 完整发版包。
  • 绿色版 Ansible 已完成注册。
  • 目标节点满足 x86_64 与 SSE4.2 要求。
  • ClickHouse 节点、ZooKeeper / Keeper 节点网络互通。

5. 与主站其他能力的关系

  • mysql_ansible 用于 MySQL 核心 OLTP 交付。
  • clickhouse_ansible 用于 MySQL 下游 OLAP 场景。
  • monitoring_prometheus_ansible 用于为上述组件提供监控能力。

三者属于同一个 dbbot 仓与同一发版节奏。