TiDB提供了docker compose的部署方式，可以很方便的在单机上搭建一个TiDB集群作为开发测试环境。如果修改了TiDB源码，可以使用这样方式，先在本机部署集群做一些验证。

• 首先本机要安装docker和docker compose，建议参考官方文档Install Docker 和 Install Docker Compose

• 下载tidb-docker-compose项目

1

git clone https://github.com/pingcap/tidb-docker-compose.git

• 使用docker compose启动TiDB集群

1

cd tidb-docker-compose && sudo docker-compose up -d

就这么简单，集群启动成功了。使用docker ps查看：

可以看到，已经启动了三个tikv实例，一个tidb实例，三个pd实例，还有监控和tidb-vision。

监控的访问地址是 http://localhost:3000，用户名/密码：admin/admin。

tidb-vision 的访问地址是 http://localhost:8010

• 使用MySQL客户端访问TiDB

如果本机有MySQL客户端，可以直接连接：

1

mysql -h 127.0.0.1 -P 4000 -u root

如果本机没有MySQL客户端，可以使用docker启动一个MySQL容器，然后登录到容器内，再使用MySQL客户端连接TiDB集群。这种方式比较环保，只要有docker环境就行。先查看TiDB集群的docker网络：

然后启动MySQL容器，注意要加入TiDB集群的docker网络：

1

sudo docker run --network=tidbdockercompose_default --rm -it mysql /bin/bash

因为和TiDB集群在同一个docker网络，在MySQL容器内，可以使用tidb名称访问到TiDB：

1

mysql -h tidb -P 4000 -u root

• 停止集群

1

sudo docker-compose down

如果自己build了TiDB版本想在本机run集群，文档写的很清楚，告诉你镜像应该放在什么位置。

Have fun!