diff --git a/README.md b/README.md index dfb040708fbd..9411fac82b43 100755 --- a/README.md +++ b/README.md @@ -20,8 +20,7 @@ TiDB 的文档结构如下： ├── get-started ├── deploy ├── orchestrated - ├── ansible.md - ├── offline-ansible.md + ├── tiup.md ├── docker.md ├── configure ├── maintain diff --git a/benchmark/how-to-run-sysbench.md b/benchmark/how-to-run-sysbench.md index d6b7bab5934b..6d162549f54c 100644 --- a/benchmark/how-to-run-sysbench.md +++ b/benchmark/how-to-run-sysbench.md @@ -11,7 +11,7 @@ category: benchmark - [硬件要求](/how-to/deploy/hardware-recommendations.md) -- 参考 [TiDB 部署文档](/how-to/deploy/orchestrated/ansible.md)部署 TiDB 集群。在 3 台服务器的条件下，建议每台机器部署 1 个 TiDB，1 个 PD，和 1 个 TiKV 实例。关于磁盘，以 32 张表、每张表 10M 行数据为例，建议 TiKV 的数据目录所在的磁盘空间大于 512 GB。 +- 参考 [TiDB 部署文档](https://pingcap.com/docs-cn/v3.0/how-to/deploy/orchestrated/ansible/)部署 TiDB 集群。在 3 台服务器的条件下，建议每台机器部署 1 个 TiDB，1 个 PD，和 1 个 TiKV 实例。关于磁盘，以 32 张表、每张表 10M 行数据为例，建议 TiKV 的数据目录所在的磁盘空间大于 512 GB。 对于单个 TiDB 的并发连接数，建议控制在 500 以内，如需增加整个系统的并发压力，可以增加 TiDB 实例，具体增加的 TiDB 个数视测试压力而定。 IDC 机器： diff --git a/faq/tidb.md b/faq/tidb.md index 4f97b08e0004..30c76be29dba 100755 --- a/faq/tidb.md +++ b/faq/tidb.md @@ -210,8 +210,7 @@ TiDB 支持部署和运行在 Intel x86-64 架构的 64 位通用硬件服务器 #### 2.2.1 推荐部署方式 -- [使用 TiUP 部署](/how-to/deploy/orchestrated/tiup.md)：如果用于生产环境，推荐使用 TiUP 部署 TiDB 集群。 -- [使用 TiDB Ansible 部署](/how-to/deploy/orchestrated/ansible.md)：如果用于生产环境，也可以使用 TiDB Ansible 部署 TiDB 集群。 +[使用 TiUP 部署](/how-to/deploy/orchestrated/tiup.md)：如果用于生产环境，推荐使用 TiUP 部署 TiDB 集群。 ##### 2.2.1.1 为什么修改了 TiKV/PD 的 toml 配置文件，却没有生效？ @@ -251,7 +250,7 @@ TiDB 支持部署和运行在 Intel x86-64 架构的 64 位通用硬件服务器 | enable_slow_query_log | TiDB 慢查询日志记录到单独文件({{ deploy_dir }}/log/tidb_slow_query.log)，默认为 False，记录到 tidb 日志 | | deploy_without_tidb | KV 模式，不部署 TiDB 服务，仅部署 PD、TiKV 及监控服务，请将 inventory.ini 文件中 tidb_servers 主机组 IP 设置为空。 | -#### 2.2.2 TiDB 离线 Ansible 部署方案 +#### 2.2.2 TiDB 离线 Ansible 部署方案（4.0 版本后不推荐使用） 首先这不是我们建议的方式，如果中控机没有外网，也可以通过离线 Ansible 部署方式，详情可参考[离线 TiDB Ansible 部署方案](/how-to/deploy/orchestrated/offline-ansible.md)。 @@ -402,7 +401,7 @@ TiDB 版本目前逐步标准化，每次 Release 都包含详细的 Change log #### 3.1.11 分不清 TiDB master 版本之间的区别，经常用错 TiDB Ansible 版本? -TiDB 目前社区非常活跃，在 1.0 GA 版本发布后，还在不断的优化和修改 BUG，因此 TiDB 的版本更新周期比较快，会不定期有新版本发布，请关注我们的[新版本发布官方网站](https://pingcap.com/weekly/)。此外 TiDB 安装推荐使用 TiDB Ansible 进行安装，TiDB Ansible 的版本也会随着 TiDB 的版本发布进行更新，因此建议用户在安装升级新版本的时候使用最新的 TiDB Ansible 安装包版本进行安装。此外，在 TiDB 1.0 GA 版本后，对 TiDB 的版本号进行了统一管理，TiDB 的版本可以通过以下两种方式进行查看： +TiDB 目前社区非常活跃，在 1.0 GA 版本发布后，还在不断的优化和修改 BUG，因此 TiDB 的版本更新周期比较快，会不定期有新版本发布，请关注我们的[新版本发布官方网站](https://pingcap.com/weekly/)。此外 TiDB 安装推荐[使用 TiUP 进行安装](/how-to/deploy/orchestrated/tiup.md)。此外，在 TiDB 1.0 GA 版本后，对 TiDB 的版本号进行了统一管理，TiDB 的版本可以通过以下两种方式进行查看： - 通过 `select tidb_version()` 进行查看 - 通过执行 `tidb-server -V` 进行查看 diff --git a/how-to/deploy/orchestrated/ansible.md b/how-to/deploy/orchestrated/ansible.md index 917c92b865bf..21046529c8a1 100644 --- a/how-to/deploy/orchestrated/ansible.md +++ b/how-to/deploy/orchestrated/ansible.md @@ -5,8 +5,6 @@ category: how-to # 使用 TiDB Ansible 部署 TiDB 集群 -## 概述 - Ansible 是一款自动化运维工具，[TiDB Ansible](https://github.com/pingcap/tidb-ansible) 是 PingCAP 基于 Ansible playbook 功能编写的集群部署工具。本文档介绍如何使用 TiDB Ansible 部署一个完整的 TiDB 集群。 本部署工具可以通过配置文件设置集群拓扑，完成以下各项运维工作： @@ -22,9 +20,11 @@ Ansible 是一款自动化运维工具，[TiDB Ansible](https://github.com/pingc - [清除集群数据](/how-to/maintain/ansible-operations.md#清除集群数据) - [销毁集群](/how-to/maintain/ansible-operations.md#销毁集群) -> **注意：** +> **警告：** > -> 对于生产环境，推荐使用 [使用 TiUP 部署](/how-to/deploy/orchestrated/tiup.md) 部署 TiDB 集群。也可以使用 TiDB Ansible 部署 TiDB 集群。如果只是用于测试 TiDB 或体验 TiDB 的特性，建议[使用 Docker Compose 在单机上快速部署 TiDB 集群](/how-to/get-started/deploy-tidb-from-docker-compose.md)。 +> 对于生产环境，推荐[使用 TiUP 部署 TiDB 集群](/how-to/deploy/orchestrated/tiup.md)。从 TiDB 4.0 版本开始，不再推荐使用 TiDB Ansible 部署 TiDB 集群，但可以使用 TiUP 直接支持之前的 Ansible 集群。 +> +> 如果只是希望测试 TiDB 或体验 TiDB 特性，可参考[如何快速体验 TiDB 集群](/how-to/get-started/quick-start-with-tidb.md)或者[使用 Docker Compose 在单机上快速部署 TiDB 集群](/how-to/get-started/deploy-tidb-from-docker-compose.md)。 ## 准备机器