test-infra

README

Testing & Infrastructure 🔬 🌐

Testing scenarios and network infrastructure for the Celestia Network

Pre-Requisites

Please install docker and testground to execute network tests.

Go requirements

Requirement	Notes
Go version	1.19 or higher

System Requirements

We have compositions that are separated into 2 environments:

1. local:docker
2. cluster:k8s

Environment	CPU (cores)	RAM (Gib)
local:docker	8~16	16~32
cluster:k8s	3000~4000	4000~5000

At the moment, we are only using docker:generic as a builder. Please, check our Dockerfile for more information.

Repo Navigation

The repository is divided into 4 main directories:

1. docs
2. compositions
3. tests
4. testkit

The order of directories above ☝ is how the repo should be read if you want to get acquinted with test plans/cases design and their further implementations. Each of the directories contains its own README.md.

Test Execution

cd test-infra
testground plan import --from . --name celestia

# This command should be executed in the 1st terminal
testground daemon

# This command should be executed in the 2nd terminal
testground run composition -f compositions/local-docker/big-blocks/001-val-large-txs-4.toml --wait

Code of Conduct

See our Code of Conduct here.