https://github.com/celestiaorg/test-infra

Testing infrastructure for the Celestia Network
https://github.com/celestiaorg/test-infra

celestia testground testing

Last synced: about 2 months ago
JSON representation

Testing infrastructure for the Celestia Network

• Host: GitHub
• URL: https://github.com/celestiaorg/test-infra
• Owner: celestiaorg
• License: apache-2.0
• Created: 2021-09-20T13:48:00.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2024-06-25T20:17:24.000Z (8 months ago)
• Last Synced: 2024-12-15T13:47:21.251Z (about 2 months ago)
• Topics: celestia, testground, testing
• Language: Go
• Homepage:
• Size: 2.16 MB
• Stars: 25
• Watchers: 14
• Forks: 10
• Open Issues: 60
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Testing & Infrastructure :microscope: :globe_with_meridians:

Testing scenarios and network infrastructure for the Celestia Network

## Pre-Requisites

Please install `docker` and [testground](https://github.com/testground/testground#getting-started) 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 :point_up: 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

```bash

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](https://docs.celestia.org/community/coc).