Benchmark engine for blockchains
Project description
MixBytes Tank
Requirements
- Python3
- Terraform 0.11.13
- Terraform-Inventory v0.8
Installation
Terraform & Terraform-Inventory
Can be done with tank/install-terraform.sh.
Optional: create virtualenv
Optionally, create and activate virtualenv
sudo apt-get install -y python3-virtualenv
python3 -m virtualenv -p python3 venv
After virtualenv creation and each time after opening a terminal, activate virtualenv to work with the tank:
. venv/bin/activate
Tank
pip3 install mixbytes-tank
Usage
1. Configure the user config
Configure ~/.tank.yml
. The example can be found at docs/config.yml.example.
Please configure at least one cloud provider. The essential steps are:
- providing (and possibly creating) a key pair;
- registering the public key with your cloud provider if needed;
- specifying a cloud provider access token or credentials.
2. Create or get a tank testcase
The example can be found at docs/testcase_example.yml.
3. Start a tank run
tank cluster deploy <testcase file>
4. Login into the monitoring
Locate the newly created instance which name ends with -monitoring
in your cloud, find the instance ip.
Open in browser http://{monitoring ip}:3000/dashboards
, username and password are tank
.
The dashboards can always be found at http://{monitoring ip}:3000/dashboards
5. List current active runs
There can be multiple tank runs at the same time. List and brief information can be seen via:
tank cluster list
6. Create synthetic load
tank cluster bench <run id> [--tps N] [--total-tx N]
<run id>
- id of the run
--tps
- global transactions per second generation rate,
--total-tx
- how many transactions to send (total).
7. Shutdown and remove the cluster
tank cluster destroy <run id>
Hacking
Alternative binding version
Bindings can be configured at ~/.tank/bindings.yml
(by default the predefined binding config is copied and used).
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for mixbytes_tank-0.2.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | a7d87cb6fd397e99615c73539d4cde9bab653c7336674b621406c7af84bcac7d |
|
MD5 | 738a06e34b14f10b50370bd6a59ba1db |
|
BLAKE2b-256 | 51ce68688339fe9128eafb4a8a25aa8684e95e497683ba67b3280127c4e015cf |