cosmos-sdk/networks/local
Greg Szabo 4c5e536b31 Added testnet command and localnet targets
Finished testnet command and introduced localnet targets in Makefile, together with gaiadnode Docker image

Fixed function parameter list - now starts with ctx

Separated GenTxConfig into a server/config package so both the server package and the mock package can use it

Adding server/config to app package

gaiadnode Docker image

Separated GenTxConfig into a server/config package so both the server package and the mock package can use it

Adding server/config to app package

Fixes requested by Rigel

Removed commented code

Global flag fixes
2018-06-12 11:25:03 -07:00
..
gaiadnode Added testnet command and localnet targets 2018-06-12 11:25:03 -07:00
Makefile Added testnet command and localnet targets 2018-06-12 11:25:03 -07:00
README.md Added testnet command and localnet targets 2018-06-12 11:25:03 -07:00

README.md

Local Cluster with Docker Compose

Requirements

Build

Build the gaiad binary and the tendermint/gaiadnode docker image.

Note the binary will be mounted into the container so it can be updated without rebuilding the image.

cd $GOPATH/src/github.com/cosmos/cosmos-sdk

# Build the linux binary in ./build
make build-linux

# Build tendermint/gaiadnode image
make build-docker-gaiadnode

Run a testnet

To start a 4 node testnet run:

make localnet-start

The nodes bind their RPC servers to ports 46657, 46660, 46662, and 46664 on the host. This file creates a 4-node network using the gaiadnode image. The nodes of the network expose their P2P and RPC endpoints to the host machine on ports 46656-46657, 46659-46660, 46661-46662, and 46663-46664 respectively.

To update the binary, just rebuild it and restart the nodes:

make build-linux
make localnet-stop
make localnet-start

Configuration

The make localnet-start creates files for a 4-node testnet in ./build by calling the gaiad testnet command.

The ./build directory is mounted to the /gaiad mount point to attach the binary and config files to the container.

For instance, to create a single node testnet:

cd $GOPATH/src/github.com/cosmos/cosmos-sdk

# Clear the build folder
rm -rf ./build

# Build binary
make build-linux

# Create configuration
docker run -v `pwd`/build:/gaiad tendermint/gaiadnode testnet --o . --v 1

#Run the node
docker run -v `pwd`/build:/gaiad tendermint/gaiadnode

Logging

Log is saved under the attached volume, in the gaiad.log file and written on the screen.

Special binaries

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.