nomos-node/testnet
gusto ea1862864b
Docker compose static testnet configuration (#499)
* Add static node network configuration in a new compose file

* Update ports and fix testnet config

* Remove replicas

* Update testnet bootstrap config

* Remove replicas env var in static conf

* Bootstrap node depends on mixnodes

* Scheme version for compose.static.yml

Co-authored-by: Jakub <i+github@always.fail>

* Remove unnecessary context defintion

* Add container names in compose.static.yml

* Simplify compose services build context

---------

Co-authored-by: Jakub <i+github@always.fail>
2023-11-02 15:23:35 +02:00
..
scripts Docker compose consensus layer config (#482) 2023-10-30 16:51:40 +02:00
Dockerfile Static mixnet nodes in docker compose 2023-10-17 14:46:41 +03:00
README.md Add Readme for docker testnet 2023-10-17 15:55:01 +03:00
bootstrap_config.yaml Docker compose static testnet configuration (#499) 2023-11-02 15:23:35 +02:00
libp2p_config.yaml Docker compose static testnet configuration (#499) 2023-11-02 15:23:35 +02:00
mixnode_config.yaml Use predefined public key for mixnodes 2023-10-17 14:47:40 +03:00

README.md

Docker Compose Testnet for Nomos

The Nomos Docker Compose Testnet contains four distinct service types:

  • Bootstrap Node Service: A singular Nomos node with its own service and a deterministic DNS address. Other nodes utilize this as their initial peer.
  • Libp2p Node Services: Multiple dynamically spawned Nomos nodes that announce their existence through etcd.
  • Etcd Service: A container running an etcd instance.
  • Mix-Node-{0,1,2}: These are statically configured mixnet nodes. Every Libp2p node includes these in its topology configuration.

Building

Upon making modifications to the codebase or the Dockerfile, the Nomos images must be rebuilt:

docker compose build

Configuring

Configuration of the Docker testnet is accomplished using the .env file. An example configuration can be found in .env.example.

To adjust the count of Nomos nodes, modify the variable:

DOCKER_COMPOSE_LIBP2P_REPLICAS=100

Running

Initiate the testnet by executing the following command:

docker compose up

This command will merge all output logs and display them in Stdout. For a more refined output, it's recommended to first run:

docker compose up -d

Followed by:

docker compose logs -f {bootstrap,libp2p-node,mixnode,etcd}

Using testnet

Bootstrap node is accessible from the host via 3000 and 8080 ports. To expose other nomos nodes, please update libp2p-node service in the compose.yml file with this configuration:

  libp2p-node:
    ports:
    - "3001-3010:3000" # Use range depending on the number of nomos node replicas.
    - "8081-8190:8080"

After running docker compose up, the randomlly assigned ports can be viewed with ps command:

docker compose ps