order |
---|
2 |
With Docker Compose, you can spin up local testnets with a single command.
Build the cometbft
binary and, optionally, the cometbft/localnode
docker image.
Note the binary will be mounted into the container so it can be updated without rebuilding the image.
# Build the linux binary in ./build
make build-linux
# (optionally) Build cometbft/localnode image
make build-docker-localnode
To start a 4 node testnet run:
make localnet-start
The nodes bind their RPC servers to ports 26657, 26660, 26662, and 26664 on the host.
This file creates a 4-node network using the localnode image.
The nodes of the network expose their P2P and RPC endpoints to the host machine on ports 26656-26657, 26659-26660, 26661-26662, and 26663-26664 respectively.
To update the binary, just rebuild it and restart the nodes:
make build-linux
make localnet-start
The make localnet-start
creates files for a 4-node testnet in ./build
by
calling the cometbft testnet
command.
The ./build
directory is mounted to the /cometbft
mount point to attach
the binary and config files to the container.
To change the number of validators / non-validators change the localnet-start
Makefile target here:
localnet-start: localnet-stop
@if ! [ -f build/node0/config/genesis.json ]; then docker run --rm -v $(CURDIR)/build:/cometbft:Z cometbft/localnode testnet --v 5 --n 3 --o . --populate-persistent-peers --starting-ip-address 192.167.10.2 ; fi
docker compose up -d
The command now will generate config files for 5 validators and 3 non-validators. Along with generating new config files the docker-compose file needs to be edited. Adding 4 more nodes is required in order to fully utilize the config files that were generated.
node3: # bump by 1 for every node
container_name: node3 # bump by 1 for every node
image: "cometbft/localnode"
environment:
- ID=3
- LOG=${LOG:-cometbft.log}
ports:
- "26663-26664:26656-26657" # Bump 26663-26664 by one for every node
volumes:
- ./build:/cometbft:Z
networks:
localnet:
ipv4_address: 192.167.10.5 # bump the final digit by 1 for every node
Before running it, don't forget to cleanup the old files:
# Clear the build folder
rm -rf ./build/node*
To use your own ABCI applications with 4-node setup edit the docker-compose.yaml file and add images to your ABCI application.
abci0:
container_name: abci0
image: "abci-image"
build:
context: .
dockerfile: abci.Dockerfile
command: <insert command to run your abci application>
networks:
localnet:
ipv4_address: 192.167.10.6
abci1:
container_name: abci1
image: "abci-image"
build:
context: .
dockerfile: abci.Dockerfile
command: <insert command to run your abci application>
networks:
localnet:
ipv4_address: 192.167.10.7
abci2:
container_name: abci2
image: "abci-image"
build:
context: .
dockerfile: abci.Dockerfile
command: <insert command to run your abci application>
networks:
localnet:
ipv4_address: 192.167.10.8
abci3:
container_name: abci3
image: "abci-image"
build:
context: .
dockerfile: abci.Dockerfile
command: <insert command to run your abci application>
networks:
localnet:
ipv4_address: 192.167.10.9
Override the command in each node to connect to it's ABCI.
node0:
container_name: node0
image: "cometbft/localnode"
ports:
- "26656-26657:26656-26657"
environment:
- ID=0
- LOG=$${LOG:-cometbft.log}
volumes:
- ./build:/cometbft:Z
command: node --proxy_app=tcp://abci0:26658
networks:
localnet:
ipv4_address: 192.167.10.2
Similarly do for node1, node2 and node3 then run testnet.
Log is saved under the attached volume, in the cometbft.log
file. If the
LOG
environment variable is set to stdout
at start, the log is not saved,
but printed on the screen.
If you have multiple binaries with different names, you can specify which one
to run with the BINARY
environment variable. The path of the binary is relative
to the attached volume.