GitHub - pingcap/pd: Placement driver for TiKV
source link: https://github.com/pingcap/pd
Go to the source link to view the article. You can view the picture content, updated content and better typesetting reading experience. If the link is broken, please click the button below to view the snapshot at that time.
README.md
PD
PD is the abbreviation for Placement Driver. It is used to manage and schedule the TiKV cluster.
PD supports distribution and fault-tolerance by embedding etcd.
Build
- Make sure Go (version 1.12) is installed.
- Use
make
to install PD. PD is installed in thebin
directory.
Usage
Command flags
Single Node with default ports
You can run pd-server
directly on your local machine, if you want to connect to PD from outside,
you can let PD listen on the host IP.
# Set correct HostIP here. export HostIP="192.168.199.105" pd-server --name="pd" \ --data-dir="pd" \ --client-urls="http://${HostIP}:2379" \ --peer-urls="http://${HostIP}:2380" \ --log-file=pd.log
Using curl
to see PD member:
curl http://${HostIP}:2379/v2/members {"members":[{"id":"f62e88a6e81c149","name":"pd","peerURLs":["http://192.168.199.105:2380"],"clientURLs":["http://192.168.199.105:2379"]}]}
A better tool httpie is recommended:
http http://${HostIP}:2379/v2/members HTTP/1.1 200 OK Content-Length: 144 Content-Type: application/json Date: Thu, 21 Jul 2016 09:37:12 GMT X-Etcd-Cluster-Id: 33dc747581249309 { "members": [ { "clientURLs": [ "http://192.168.199.105:2379" ], "id": "f62e88a6e81c149", "name": "pd", "peerURLs": [ "http://192.168.199.105:2380" ] } ] }
Docker
You can use the following command to build a PD image directly:
docker build -t pingcap/pd .
Or you can also use following command to get PD from Docker hub:
docker pull pingcap/pd
Run a single node with Docker:
# Set correct HostIP here. export HostIP="192.168.199.105" docker run -d -p 2379:2379 -p 2380:2380 --name pd pingcap/pd \ --name="pd" \ --data-dir="pd" \ --client-urls="http://0.0.0.0:2379" \ --advertise-client-urls="http://${HostIP}:2379" \ --peer-urls="http://0.0.0.0:2380" \ --advertise-peer-urls="http://${HostIP}:2380" \ --log-file=pd.log
Cluster
PD is a component in TiDB project, you must run it with TiDB and TiKV together, see TiDB-Ansible to learn how to set up the cluster and run them.
You can also use Docker to run the cluster.
Recommend
About Joyk
Aggregate valuable and interesting links.
Joyk means Joy of geeK