Skip to content

Latest commit

 

History

History
179 lines (128 loc) · 5.97 KB

binary-deployment.md

File metadata and controls

179 lines (128 loc) · 5.97 KB
Raw

TiDB Binary 部署方案

概述

一个完整的 TiDB 集群包括 PD，TiKV 以及 TiDB。启动顺序依次是 PD，TiKV 以及 TiDB。

了解 TiDB 整体架构，请参考 TiDB 总览。

快速了解和试用 TiDB，推荐使用单节点方式快速部署。

生产环境使用 TiDB，推荐使用多节点集群模式部署。

下载官方 Binary

Linux

# 下载压缩包
wget http://download.pingcap.org/tidb-latest-linux-amd64.tar.gz
wget http://download.pingcap.org/tidb-latest-linux-amd64.sha256

# 检查文件完整性，返回 ok 则正确
sha256sum -c tidb-latest-linux-amd64.sha256

# 解开压缩包
tar -xzf tidb-latest-linux-amd64.tar.gz
cd tidb-latest-linux-amd64

CentOS6

# 下载 CentOS6 压缩包
wget http://download.pingcap.org/tidb-latest-linux-amd64-centos6.tar.gz
wget http://download.pingcap.org/tidb-latest-linux-amd64-centos6.sha256

# 检查文件完整性，返回 ok 则正确
sha256sum -c tidb-latest-linux-amd64-centos6.sha256

# 解开压缩包
tar -xzf tidb-latest-linux-amd64-centos6.tar.gz
cd tidb-latest-linux-amd64-centos6

单节点方式快速部署

我们可以在单机上面，运行和测试 TiDB 集群，请按如下步骤依次启动 PD，TiKV，TiDB：

  1. 启动 PD.

    ./bin/pd-server --cluster-id=1 \
                --data-dir=pd

  2. 启动 TiKV.

    ./bin/tikv-server --cluster-id=1 \
                  --pd="127.0.0.1:2379" \
                  --store=tikv

  3. 启动 TiDB.

    ./bin/tidb-server --store=tikv \
                  --path="127.0.0.1:2379?cluster=1"

  4. 使用官方的 mysql 客户端连接 TiDB.

    mysql -h 127.0.0.1 -P 4000 -u root -D test

多节点集群模式部署

在生产环境中，我们推荐多节点部署 TiDB 集群，首先请参考部署建议。

这里我们使用三个节点，部署三个 PD，三个 TiKV，以及一个 TiDB，各个节点以及所运行服务信息如下：

Name Host IP Services
node1 192.168.199.113 PD1, TiKV1, TiDB
node2 192.168.199.114 PD2, TiKV2
node3 192.168.199.115 PD3, TiKV3

请按如下步骤依次启动 PD 集群，TiKV 集群以及 TiDB：

  1. 在每个节点启动 PD.

    ./bin/pd-server --cluster-id=1 \
                --name=pd1 \
                --data-dir=pd1 \
                --client-urls="http://192.168.199.113:2379" \
                --peer-urls="http://192.168.199.113:2380" \
                --initial-cluster="pd1=http://192.168.199.113:2380,pd2=http://192.168.199.114:2380,pd3=http://192.168.199.115:2380"
          
./bin/pd-server --cluster-id=1 \
                --name=pd2 \
                --data-dir=pd2 \
                --client-urls="http://192.168.199.114:2379" \
                --peer-urls="http://192.168.199.114:2380" \
                --initial-cluster="pd1=http://192.168.199.113:2380,pd2=http://192.168.199.114:2380,pd3=http://192.168.199.115:2380"
          
./bin/pd-server --cluster-id=1 \
                --name=pd3 \
                --data-dir=pd3 \
                --client-urls="http://192.168.199.115:2379" \
                --peer-urls="http://192.168.199.115:2380" \
                --initial-cluster="pd1=http://192.168.199.113:2380,pd2=http://192.168.199.114:2380,pd3=http://192.168.199.115:2380"

  2. 在每个节点启动 TiKV.

    ./bin/tikv-server --cluster-id=1 \
                  --pd="192.168.199.113:2379,192.168.199.114:2379,192.168.199.115:2379" \
                  --addr="192.168.199.113:20160" \
                  --store=tikv1

./bin/tikv-server --cluster-id=1 \
                  --pd="192.168.199.113:2379,192.168.199.114:2379,192.168.199.115:2379" \
                  --addr="192.168.199.114:20160" \
                  --store=tikv2
            
./bin/tikv-server --cluster-id=1 \
                  --pd="192.168.199.113:2379,192.168.199.114:2379,192.168.199.115:2379" \
                  --addr="192.168.199.115:20160" \
                  --store=tikv3

  3. 在 node1 启动 TiDB.

    ./bin/tidb-server --store=tikv \
                  --path="192.168.199.113:2379,192.168.199.114:2379,192.168.199.115:2379?cluster=1"

  4. 使用官方 mysql 客户端连接 TiDB.

    mysql -h 192.168.199.113 -P 4000 -u root -D test

动态添加节点

PD

我们可以使用 join 参数，方便的将一个 PD 服务加入到现有的 PD 集群里面。假设现在我们有三个 PD 服务，详细信息如下：

Name ClientUrls PeerUrls
pd1 http://host1:2379 http://host1:2380
pd2 http://host2:2379 http://host2:2380
pd3 http://host3:2379 http://host3:2380

如果我们需要添加 pd4，只需要在 join 参数里面填入当前 PD 集群某一个 PD 服务的 ClientUrls 就可以了，如下：

./bin/pd-server --cluster-id=1 \
                --name=pd4 \
                --client-urls="http://host4:2379"
                --peer-urls="http://host4:2380"
                --join="http://host1:2379"

TiKV

动态新加入一个新的 TiKV 服务是非常容易的，我们可以直接启动一个 TiKV 服务，PD 会自动检测到， 并开始做整个集群的 balance，将其他 TiKV 的数据移动到新加入的 TiKV 里面。

我们也能够显示的告诉 PD 去删除某个 TiKV。PD 会认为这个 TiKV 已经是 dead 了，如果某一个 region 原先有数据属于这个 TiKV，PD 就会选择一个新的 TIKV 给这个 region，重新做 balance。

TiDB

TiDB 是一个无状态的服务，这也就意味着我们能直接添加和删除 TiDB。需要注意的是如果我们在 TiDB 的服务的前面搭建了一个 proxy（譬如 HAProxy），我们需要更新 proxy 的配置并重新载入。