Skip to content
Interplanetary Testground -- testing distributed software at scale
Go JavaScript Shell HCL Other
Branch: master
Clone or download
FabioMartins91 and daviddias Create 2020-02-11 (#531)
* Create 2020-02-11

Added 2020-02-11 Weekly Sync Notes

* Update 2020-02-11

Update meeting notes with discussion about the issue : Testplans to emit their ip routes after network is initialised

* update: if people

Co-authored-by: David Dias <>
Latest commit 8f1162d Feb 17, 2020
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github/ISSUE_TEMPLATE docs: Spelling fix + grammar (#234) Dec 11, 2019
_meeting-notes Create 2020-02-11 (#531) Feb 17, 2020
cmd expose pprof port on sidecar (#558) Feb 14, 2020
compositions Refactor and unify test outputs (#467) Feb 5, 2020
docs Update (#527) Feb 11, 2020
infra expose pprof port on sidecar (#558) Feb 14, 2020
manifests Add bitswap test suite (#345) Feb 13, 2020
pkg aws ecr repo must be unique across regions (#536) Feb 17, 2020
plans Add bitswap test suite (#345) Feb 13, 2020
sdk test(sync): test redis address resolution Feb 14, 2020
tools implement the exec:go builder, and the local:exec runner (#86) Nov 4, 2019
.dockerignore Refactor and unify test outputs (#467) Feb 5, 2020
.gitignore feat: run plans on AWS Docker Swarm + harden the logic to guess sourc… Nov 7, 2019
.pre-commit-config.yaml Add precommit hooks (#136) Nov 7, 2019
.travis.yml chore: remove codecov Feb 13, 2020 docs: coalesce contributing guildelines Dec 4, 2019
Dockerfile sidecar on Kubernetes (#336) Jan 16, 2020
LICENSE-APACHE add licenses. Jul 16, 2019
LICENSE-MIT add licenses. Jul 16, 2019
Makefile fix(make): fail on non-zero status Feb 7, 2020 remove codecov Feb 12, 2020
env-example.toml configurable pod resource requirements (#513) Feb 10, 2020
go.mod feat: use contexts for the sync service (#456) Feb 7, 2020
go.sum feat: sdk runtime metrics (#545) Feb 13, 2020
main.go refactor cmd integration tests to use ephemeral daemon. Dec 17, 2019


What is Testground

Testground's goal is to provide a set of tools for testing next generation P2P applications (i.e. Filecoin, IPFS, libp2p & others).

Table of Contents


You may have noticed a few test efforts with similar names underway! Testing at scale is a hard problem. We are indeed exploring and experimenting a lot, until we land on an end-to-end solution that works for us.

Testground aims to leverage the learnings and tooling resulting from those efforts to provide a scalable runtime environment for the execution of various types of tests and benchmarks, written in different languages, by different teams, targeting a specific commit of IPFS and/or libp2p, and quantifying its characteristics in terms of performance, resource and network utilisation, stability, interoperability, etc., when compared to other commits.

Testground aims to be tightly integrated with the software engineering practices and tooling IPFS and libp2p teams rely on.

How to use Testground

  • Consult the USAGE to learn how to get it running
  • Refer to the SPEC document to understand how it all works.
  • Consult the repo structure below to know where to find the multiple subsystems and test plans of Testground
├──                       # This file
├── docs                            # Documentation of the project
│   ├──
│   ├── ...
├── main.go                         # Testground entrypoint file
├── cmd                             # Testground CLI commands
│   ├── all.go
│   ├── ...
├── sdk                             # SDK available to each test plan
│   ├── runtime
│   └── ...
├── pkg                             # Internals to Testground
│   ├── api
│   ├── ...
├── manifests                       # Manifests for each test Plan. These exist independent from plans to enable plans to live elsewhere
│   ├── dht.toml
│   └── smlbench.toml
├── plans                           # The Test Plan. Includes Image to be run, Assertions and more
│   ├── dht
│   └── smlbench
└── tools                           # ??
    └── src_generate.go


The current Testground Team is composed of:

  • @raulk - Architect, Lead Software Engineer
  • @nonsense - Software Engineer, Testground as a Service / Infrastructure Lead
  • @fabiomartins91 - Technical Project Manager (TPM)
  • @hacdias - Software Engineer
  • @daviddias - Software Engineer
  • you! Yes, you can contribute as well, however, do understand that this is a brand new and fast moving project and so contributing might require extra time to onboard

To learn how this team works together read HOW_WE_WORK


Please read our CONTRIBUTING Guidelines before making a contribution.


Dual-licensed: MIT, Apache Software License v2, by way of the Permissive License Stack.

You can’t perform that action at this time.