TiDB-Ansible 安装与使用指南

项目目录结构及介绍

TiDB-Ansible 是一个基于 Ansible 的工具，用于自动化部署和管理 TiDB 集群。以下是其基本目录结构及其功能：

• hosts.ini / inventory.ini：这些是Ansible的主机配置文件，用于定义集群的节点及角色。
• conf/：包含了各个服务（如 PD, TiDB, TiKV）的配置模板。
• scripts/：存储了辅助脚本，例如 Grafana dashboard 导入文件和系统检查脚本。
• group_vars/：存放各角色组的变量设置。
• roles/：Ansible 角色的集合，每个角色代表一种特定的部署任务。
• *.yml 文件：Ansible playbooks，比如 deploy.yml, start.yml, stop.yml 等，它们定义了部署或运维流程。

项目启动文件介绍

• deploy.yml：主要的部署剧本，用于从头开始搭建一个新的 TiDB 集群。
• start.yml / stop.yml：分别用于启动和停止集群的所有组件。
• rolling_update.yml：滚动更新剧本，允许在不影响业务的情况下逐步升级集群。
• rolling_update_monitor.yml：类似地，它用于更新监控组件，但不会影响数据服务。
• unsafe_cleanup.yml 和 unsafe_cleanup_data.yml：危险操作，用于彻底清除集群数据和服务，务必小心使用。

项目的配置文件介绍

• conf/*: 这里的文件通常以服务名命名（如 pd.conf.j2, tikv.toml.j2），是配置服务的基础模板。可以通过变量替换来自定义配置。
• group_vars/*: 比如 all.yml, tidb_servers.yml 等，其中定义了不同节点组的变量，用于在部署过程中动态调整服务行为。
• inventory.ini: 重要配置文件，描述了集群的架构，包括节点的IP地址、角色分配、变量设定等。使用 -l 参数可指定只对部分节点进行操作。

为了运行以上脚本，首先确保已经安装了 Ansible 并设置了正确的主机清单。然后，你可以使用 ansible-playbook 命令结合不同的 playbook 和参数来进行相应的操作，例如：

# 部署 TiDB 集群
ansible-playbook deploy.yml -i inventory.ini

# 启动集群
ansible-playbook start.yml -i inventory.ini

# 更新指定标签的集群
ansible-playbook rolling_update.yml -i inventory.ini --tags "tidb"

# 清理数据（慎用）
ansible-playbook unsafe_cleanup_data.yml -i inventory.ini

请确保在执行任何操作前，理解每个步骤的可能影响并备份重要数据。