59 lines
1.5 KiB
Markdown
59 lines
1.5 KiB
Markdown
# Quick Start
|
|
|
|
#### Run TiDB with Docker (Standalone mode)
|
|
|
|
You can quickly test TiDB with Docker, the source repository contains the Dockerfile which contains local tidb-server.
|
|
|
|
To install Docker on your system, you can read the document on https://docs.docker.com/
|
|
|
|
```
|
|
docker pull pingcap/tidb:latest
|
|
docker run --name tidb-server -d -p 4000:4000 pingcap/tidb:latest
|
|
```
|
|
|
|
`docker pull` may take a while to download images ~560M.
|
|
|
|
Then you can use official mysql client to connect to TiDB.
|
|
|
|
```
|
|
mysql -h 127.0.0.1 -P 4000 -u root -D test --prompt="tidb> "
|
|
```
|
|
|
|
Notice: OS X user may use `docker-machine ip` to connect it.
|
|
|
|
#### __Or run TiDB on TiKV cluster__
|
|
|
|
Read the documents for [Ansible deployment](https://github.com/pingcap/docs/blob/master/op-guide/ansible-deployment.md) or [docker deployment](https://github.com/pingcap/docs/blob/master/op-guide/docker-deployment.md).
|
|
|
|
#### __Pre-requirement__
|
|
|
|
Go environment. Currently a 64-bit version of go >= 1.9 is required.
|
|
```
|
|
git clone https://github.com/pingcap/tidb.git $GOPATH/src/github.com/pingcap/tidb
|
|
cd $GOPATH/src/github.com/pingcap/tidb
|
|
make
|
|
```
|
|
|
|
#### __Run as MySQL protocol server__
|
|
|
|
```
|
|
make
|
|
cd bin && ./tidb-server
|
|
```
|
|
|
|
In case you want to compile a specific location:
|
|
|
|
```
|
|
make server TARGET=$GOPATH/bin/tidb-server
|
|
```
|
|
|
|
The default server port is `4000` and can be changed by flag `-P <port>`.
|
|
|
|
Run `./tidb-server -h` to see more flag options.
|
|
|
|
After you started tidb-server, you can use official `mysql` client to connect to TiDB.
|
|
|
|
```
|
|
mysql -h 127.0.0.1 -P 4000 -u root -D test --prompt="tidb> "
|
|
```
|