lotus/testplans
2021-07-07 16:04:01 +02:00
..
composer bump docker golang version to 1.15:buster 2020-11-23 20:00:20 +01:00
dashboards merge filecoin-project/oni subtree in testplans/ 2020-11-06 21:02:06 +01:00
docker-images testplans: lotus-soup: new images with filecoin-ffi ; use default WPoStChallengeWindow 2021-06-07 11:28:24 +02:00
graphsync add .sec scale to measurements; humanize for metric tags 2020-11-24 17:52:37 +01:00
lotus-soup fix cast on role_miner in testground lotus-soup plan 2021-07-07 16:04:01 +02:00
notes merge filecoin-project/oni subtree in testplans/ 2020-11-06 21:02:06 +01:00
DELVING.md merge filecoin-project/oni subtree in testplans/ 2020-11-06 21:02:06 +01:00
Makefile testplans: lotus-soup: new images with filecoin-ffi ; use default WPoStChallengeWindow 2021-06-07 11:28:24 +02:00
README-old-from-oni.md update Dockerfiles; integrate lotus-soup and graphsync in Lotus CI; update go.mod and references 2020-11-06 21:04:11 +01:00
README.md update Dockerfiles; integrate lotus-soup and graphsync in Lotus CI; update go.mod and references 2020-11-06 21:04:11 +01:00

Testground testplans for Lotus

This directory consists of testplans built to be run on Testground that exercise Lotus on TaaS.

Table of Contents

Testing topics

  • storage and retrieval deals:
    • end-to-end flows where clients store and retrieve pieces from miners, including stress testing the system.
  • payment channels:
    • stress testing payment channels via excessive lane creation, excessive payment voucher atomisation, and redemption.

Running the test cases

If you are unfamiliar with Testground, we strongly suggest you read the Testground Getting Started guide in order to learn how to install Testground and how to use it.

You can find various composition files describing various test scenarios built as part of Project Oni at lotus-soup/_compositions directory.

We've designed the test cases so that you can run them via the local:exec, local:docker and the cluster:k8s runners. Note that Lotus miners are quite resource intensive, requiring gigabytes of memory. Hence you would have to run these test cases on a beafy machine (when using local:docker and local:exec), or on a Kubernetes cluster (when using cluster:k8s).

Here are the basics of how to run the baseline deals end-to-end test case:

Running the baseline deals end-to-end test case

  1. Compile and Install Testground from source code.

  2. Run a Testground daemon

testground daemon
  1. Download required Docker images for the lotus-soup test plan
make pull-images

Alternatively you can build them locally with

make build-images
  1. Import the lotus-soup test plan into your Testground home directory
testground plan import --from ./lotus-soup
  1. Run a composition for the baseline deals end-to-end test case
testground run composition -f ./lotus-soup/_compositions/baseline-docker-5-1.toml