local:exec

Background
Using the local:exec runner  enables you to test distributed/p2p software as quickly as possible. When using this runner, plans are compiled and executed as a standard process.
This runner is the only one which does not use a sidecar to modify the networking. Processes run un-contained. Any files created or network calls performed during the test will be visible on the host system.
Dependencies
Although the plan binaries are compiled for the host system, all the auxiliary infrastructure is provided by Docker. This configuration enables easy installation of the sync service and monitoring infrastructure while maintaining quick build-execute iteration cycle which is the advantage of this runner.
A laptop or desktop with reasonable hardware specs. If your computer is newer than 5 or 6 years old, it will probably be just fine. To be able run simulations of a reasonable size, we recommend at least the following:
8GB memory
50GB available storage
The following software setup is required
docker daemon
a non-root account with write access to the docker socket.
Testground-supplied containers
When Testground runs its first plan, several additional containers will be started. Here is an overview of everything Testground adds to your system
Docker containers:
redis
This is the backend database of the Testground sync service.
grafana
Visualisation software that Testground uses for its dashboards.
influxdb
Time-series database that Testground uses for various diagnostics and events.
Troubleshooting
Many of the infrastructure pieces provided by Testground are common with the local:docker runner, therefore the troubleshooting steps of the local:docker runner are applicable here as well.

Debugging test plans

Next - Runner library

local:docker

Last modified 1yr ago

Copy link

Contents

Background

Dependencies

Testground-supplied containers

Troubleshooting