Spawning
-One of the goal of ZombieNet is easily spawn ephemeral networks, providing a simple but poweful cli that allow you to declare the desired network in toml
or json
format. You can check the definition spec to view the available options.
One of the goal of ZombieNet is easily spawn ephemeral networks, providing a simple but powerful cli that allow you to declare the desired network in toml
or json
format. You can check the definition spec to view the available options.
A minimal configuration example with two validators and one parachain:
[settings]
timeout = 1000
@@ -166,7 +166,7 @@ Spawning
image = "paritypr/colander:4131-ccd09bbf"
command = "adder-collator"
-Then you can spwan the network by running the following command:
+Then you can spawn the network by running the following command:
./zombienet-macos spawn examples/0001-small-network.toml
You can follow the output of the steps
to spawn the network and once the network is launched a message with the node
s information like this one is show
🧟🧟🧟 ZombieNet 🧟🧟🧟
Testing
The other goal of ZombieNet is provide a way to perform test/assertions agins the spawned network, using a set of natural language expressions
that allow to make assertions based on metrics, logs and some built-in
function that query the network using polkadot.js
.
Those assertions should be defined in a feature test, and the dsl
and format is documented in here.
The following is an small example to spawn a network (using the previos simple network definition
) and assert that:
The following is an small example to spawn a network (using the previous simple network definition
) and assert that:
- Both
nodes
are running - The definded
parachain
is registered
diff --git a/docs/book/install.html b/docs/book/install.html
index 00b4cebbc..d4a338ed5 100644
--- a/docs/book/install.html
+++ b/docs/book/install.html
@@ -143,7 +143,7 @@
🧟🧟🧟 ZombieNet 🧟🧟🧟
Installation
-ZombieNet releases are available in github
. Each one provide an executable for both linux
and macos
crated with pkg and allow to run zombienet
cli without having Node.js
installed but each provider
define it's own requirements (e.g. k8s, podman).
ZombieNet releases are available in github
. Each one provide an executable for both linux
and macos
created with pkg and allow to run zombienet
cli without having Node.js
installed but each provider
define it's own requirements (e.g. k8s, podman).
What is Z
ZombieNet aims to be a testing framework for Substrate based blockchains, providing a simple CLI tool that allowS users to spawn and test ephemeral networks. The assertions used in the tests can include on-chain storage, metrics, logs and custom JS scripts that interact with the chain. To make these easy to define, Zombienet uses a built-in natural language tool to write tests as smoothly as possible.
Internally, it's a JS library designed to run on NodeJS and support different backend providers to run the various blockchain nodes. Currently, Kubernetes, Podman and native are the supported providers.
Installation
-ZombieNet releases are available in github
. Each one provide an executable for both linux
and macos
crated with pkg and allow to run zombienet
cli without having Node.js
installed but each provider
define it's own requirements (e.g. k8s, podman).
+ZombieNet releases are available in github
. Each one provide an executable for both linux
and macos
created with pkg and allow to run zombienet
cli without having Node.js
installed but each provider
define it's own requirements (e.g. k8s, podman).
Kubernetes requirements
Zombienet should work with any k8s cluster (e.g GKE, docker-desktop, kind) but you need to have kubectl
installed to interact with your cluster.
Also, you need permission to create resources (e.g namespaces
, pods
and cronJobs
) in the target cluster.
@@ -238,7 +238,7 @@
github
. Each one provide an executable for both linux
and macos
crated with pkg and allow to run zombienet
cli without having Node.js
installed but each provider
define it's own requirements (e.g. k8s, podman).github
. Each one provide an executable for both linux
and macos
created with pkg and allow to run zombienet
cli without having Node.js
installed but each provider
define it's own requirements (e.g. k8s, podman).kubectl
installed to interact with your cluster.namespaces
, pods
and cronJobs
) in the target cluster.Spawning
-One of the goal of ZombieNet is easily spawn ephemeral networks, providing a simple but poweful cli that allow you to declare the desired network in toml
or json
format. You can check the definition spec to view the available options.
One of the goal of ZombieNet is easily spawn ephemeral networks, providing a simple but powerful cli that allow you to declare the desired network in toml
or json
format. You can check the definition spec to view the available options.
A minimal configuration example with two validators and one parachain:
[settings]
timeout = 1000
@@ -261,7 +261,7 @@ ./zombienet-macos spawn examples/0001-small-network.toml
You can follow the output of the steps
to spawn the network and once the network is launched a message with the node
s information like this one is show