You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 
Marko 42e4e8b58e
lint: add markdown linter (#5254)
4 years ago
..
atomic_broadcast Add IPv6 support for P2P integration tests (#4340) 5 years ago
basic Add IPv6 support for P2P integration tests (#4340) 5 years ago
fast_sync Add IPv6 support for P2P integration tests (#4340) 5 years ago
kill_all Add IPv6 support for P2P integration tests (#4340) 5 years ago
pex Add IPv6 support for P2P integration tests (#4340) 5 years ago
README.md lint: add markdown linter (#5254) 4 years ago
address.sh Add IPv6 support for P2P integration tests (#4340) 5 years ago
circleci.sh circleci: run P2P IPv4 and IPv6 tests in parallel (#4459) 5 years ago
client.sh Add IPv6 support for P2P integration tests (#4340) 5 years ago
local_testnet_start.sh Add IPv6 support for P2P integration tests (#4340) 5 years ago
local_testnet_stop.sh test/p2p: shellcheck 8 years ago
peer.sh Add IPv6 support for P2P integration tests (#4340) 5 years ago
persistent_peers.sh Add IPv6 support for P2P integration tests (#4340) 5 years ago
test.sh Add IPv6 support for P2P integration tests (#4340) 5 years ago

README.md

Tendermint P2P Tests

These scripts facilitate setting up and testing a local testnet using docker containers.

Setup your own local testnet as follows.

For consistency, we assume all commands are run from the Tendermint repository root.

First, build the docker image:

docker build -t tendermint_tester -f ./test/docker/Dockerfile .

Now create the docker network:

docker network create --driver bridge --subnet 172.57.0.0/16 my_testnet

This gives us a new network with IP addresses in the rage 172.57.0.0 - 172.57.255.255. Peers on the network can have any IP address in this range. For our four node network, let's pick 172.57.0.101 - 172.57.0.104. Since we use Tendermint's default listening port of 26656, our list of seed nodes will look like:

172.57.0.101:26656,172.57.0.102:26656,172.57.0.103:26656,172.57.0.104:26656

Now we can start up the peers. We already have config files setup in test/p2p/data/. Let's use a for-loop to start our peers:

for i in $(seq 1 4); do
	docker run -d \
	  --net=my_testnet\
	  --ip="172.57.0.$((100 + $i))" \
	  --name local_testnet_$i \
	  --entrypoint tendermint \
	  -e TMHOME=/go/src/github.com/tendermint/tendermint/test/p2p/data/mach$((i-1)) \
	  tendermint_tester node --p2p.persistent_peers 172.57.0.101:26656,172.57.0.102:26656,172.57.0.103:26656,172.57.0.104:26656 --proxy_app=kvstore
done

If you now run docker ps, you'll see your containers!

We can confirm they are making blocks by checking the /status message using curl and jq to pretty print the output json:

curl 172.57.0.101:26657/status | jq .

IPv6 tests

IPv6 tests require a Docker daemon with IPv6 enabled, by setting the following in daemon.json:

{
  "ipv6": true,
  "fixed-cidr-v6": "2001:db8:1::/64"
}

In Docker for Mac, this is done via Preferences → Docker Engine.

Once set, run IPv6 tests via make test_p2p_ipv6.