硬件資源有限,但又想體驗一下TiDB集羣。查閱官方文檔後得知可以用Docker Compose的方式來構建TiDB.文檔中僅需三步就可用Docker Compose構建一套TiDB集羣,心中一陣竊喜。但實際操作起來確不是很順利。
由於沒仔細閱讀tidb-docker-compose中的README.md,導致在docker和docker-compose版本的問題上走了一些彎路。最終在如下環境下成功構建TiDB集羣。雖沒什麼技術含量,爲了培養自己養成良好的閱讀說明文檔的習慣,特記錄一下。
官方文檔:https://pingcap.com/docs-cn/op-guide/docker-compose/
軟件環境
軟件名稱 | 版本 |
OS | CentOs7.4 |
git | 1.8.3.1 |
Docker | 1.7.12.1-ce |
docker-compose | 1.21.2 |
1.Linux系統內核版本大於3.10.0
cat /etc/redhat-release
CentOS Linux release 7.4.1708 (Core)
uname -r
3.10.0-693.el7.x86_64
內核版本建議在3.10.0以上,否則在/var/log/docker 中會有這樣的提示。Please upgrade your kernel to 3.10.0
本想在CentOs6.5上通過upgrade的方式升級到CentOS7.2。但升級過程中遇到了一些問題,導致升級後系統無法啓動。
最後通過重做系統的方式升級到了CentOS7.4. 除非你能承受系統跨大版本升級失敗的後果,否則還是不建議直接升級系統。
2.安裝git工具yum -y install git
git --version
git version 1.8.3.1
3.安裝docker
由於yum源的問題,加上對docker不熟,在解決docker版本的問題上折騰了很長時間。
最後通過RPM 包的形式更新到了docker-ce-17
https://download.docker.com/linux/centos/7/x86_64/stable/Packages/docker-ce-17.12.1.ce-1.el7.centos.x86_64.rpm
4.安裝docker-compose
#curl -L https://github.com/docker/compose/releases/download/1.21.2/docker-compose-`uname -s`-`uname -m` -o /usr/local/bin/docker-compose
#chmod +x /usr/local/bin/docker-compose
#docker-compose version
docker-compose version 1.21.2, build a133471
docker-py version: 3.3.0
CPython version: 3.6.5
OpenSSL version: OpenSSL 1.0.1t 3 May 2016
準備工作做好後,就可以按照官方文檔的說明來安裝TiDB了。
1.下載 tidb-docker-compose
git clone https://github.com/pingcap/tidb-docker-compose.git
Cloning into 'tidb-docker-compose'...
remote: Counting objects: 249, done.
remote: Compressing objects: 100% (4/4), done.
remote: Total 249 (delta 0), reused 0 (delta 0), pack-reused 245
Receiving objects: 100% (249/249), 122.71 KiB | 61.00 KiB/s, done.
Resolving deltas: 100% (102/102), done
2.創建並啓動集羣
docker-compose up -d 這個過程會比較長,視網絡情況而定。
遇到的兩個錯誤:
1. 下載docker鏡像的過程中可能會遇到 ERROR: net/http: TLS handshake timeout。重試幾次就好了。
2. 有些服務無法啓動,報Unknown runtime specified docker-runc
ERROR: for grafana Cannot start service grafana: Unknown runtime specified docker-runc
ERROR: for pushgateway Cannot start service pushgateway: Unknown runtime specified docker-runc
ERROR: for tidb-vision Cannot start service tidb-vision: Unknown runtime specified docker-runc
解決方法:docker-compose up --force-recreate -d
3. 檢查服務是否正常啓動
#docker-compose ps|grep Up
tidb-docker- /run.sh Up 0.0.0.0:3000->3000/tcp
tidb-docker-compose_pd0_1 /pd-server --name=pd0 --cl Up 0.0.0.0:32786->2379/tcp,
tidb-docker-compose_pd1_1 /pd-server --name=pd1 --cl Up 0.0.0.0:32785->2379/tcp,
tidb-docker-compose_pd2_1 /pd-server --name=pd2 --cl Up 0.0.0.0:32784->2379/tcp,
tidb-docker- /bin/prometheus --storage. Up 0.0.0.0:9090->9090/tcp
tidb-docker- /bin/pushgateway Up 9091/tcp
tidb-docker-compose_tidb- /bin/sh -c sed -i -e "s/PD Up 2015/tcp, 443/tcp, 80/tcp,
tidb-docker-compose_tidb_1 /tidb-server --store=tikv Up 0.0.0.0:10080->10080/tcp,
tidb-docker-compose_tikv0_1 /tikv-server --addr=0.0.0. Up 20160/tcp
tidb-docker-compose_tikv1_1 /tikv-server --addr=0.0.0. Up 20160/tcp
tidb-docker-compose_tikv2_1 /tikv-server --addr=0.0.0. Up 20160/tcp
tidb-docker- /opt/spark/sbin/start-mast Up 0.0.0.0:7077->7077/tcp,
tidb-docker- /opt/spark/sbin/start-slav Up 0.0.0.0:38081->38081/tcp
如果檢查到服務都是Up的,則說明基本沒沒什麼大問題了。
mysql -uroot -p -h 127.0.0.1 -P 4000 -e "select @@version;"
Enter password:
+--------------------------------------+
| @@version |
+--------------------------------------+
| 5.7.10-TiDB-v2.0.0-rc.4-269-g46da21b |
+--------------------------------------+
訪問TiDB集羣 Grafana 監控頁面:http://IP:3000 默認用戶名和密碼均爲 admin, 稍等幾分鐘便可以看到監控數據。