77 releases

new 0.1.76 Nov 23, 2024
0.1.75 Nov 22, 2024
0.1.52 Oct 31, 2024
0.1.23 Sep 30, 2024
0.1.10 Aug 31, 2024

#843 in Network programming

Download history 222/week @ 2024-08-10 417/week @ 2024-08-17 472/week @ 2024-08-24 467/week @ 2024-08-31 453/week @ 2024-09-07 187/week @ 2024-09-14 423/week @ 2024-09-21 971/week @ 2024-09-28 957/week @ 2024-10-05 800/week @ 2024-10-12 1057/week @ 2024-10-19 1341/week @ 2024-10-26 1315/week @ 2024-11-02 886/week @ 2024-11-09 374/week @ 2024-11-16

4,049 downloads per month

BSD-3-Clause and GPL-3.0 licenses

525KB
12K SLoC

Safe Network Testnet Deploy

This tool can be used to automate the deployment of testnets on AWS or Digital Ocean.

It uses Terraform to create the infrastructure and Ansible to provision it, and a Rust binary to coordinate the two.

If you are interested in deploying your own testnets, or using the tool to deploy your own nodes for participating in one of Maidsafe's testnets, you can fork the repository and change a few details.

Since we use Ansible, if you want to use the tool on Windows, you'll need to use WSL.

Setup

The tool makes use of Terraform to create either droplets on Digital Ocean or EC2 instances on AWS, so you need an installation of that on your platform. It is very likely available in your platform's package manager.

We make use of Ansible for provisioning the VMs. Since Ansible is a Python application, it is advisable to install it in a virtualenv. If this sounds unfamiliar, I would recommend asking ChatGPT something along the lines of, "How can I install Ansible in a virtualenv created and managed by virtualenvwrapper?" The virtualenv must be activated any time you use the tool.

August 2023 update: please pin to Ansible version 8.2.0, using pip install ansible==8.2.0. There is an issue with the newer version not correctly reading the Digital Ocean environment variables for the dynamic inventory.

After you've installed these tools, run our setup command:

cargo run -- setup

This will gather a bunch of values that are written to a .env file, which is read when the tool starts.

You only need to run this command once.

Deploying a Testnet

After completing the setup, you can deploy a testnet like so:

cargo run -- deploy --name beta

This will deploy a testnet named 'beta' to Digital Ocean, with 10 VMs and 20 node processes on each VM, and the latest version of the safenode binary.

If you want more VMs or nodes, use the --vm-count and --node-count arguments to vary those values to suit your needs:

cargo run -- deploy --name beta --vm-count 100 --node-count 30

You may want to deploy a custom version of the safenode binary. To do so, use the --branch and --repo-owner arguments:

cargo run -- deploy --name beta --vm-count 100 --node-count 30 --repo-owner jacderida --branch custom_branch 

To get a list of the machines and other information about the testnet:

cargo run -- inventory --name beta --provider digital-ocean

Test Data

There is a set of standard test data, which is about 100MB of image files. It can be uploaded to a testnet using the following command:

cargo run -- upload-test-data --name beta

The archive will be downloaded from S3, then each file will be uploaded using the files upload command of the safe client. The client itself is also fetched from S3. It was built using the same source as the branch used for the node binary.

Clean Up

To remove the testnet, use the following command:

cargo run -- clean --name beta --provider digital-ocean

This will use Terraform to tear down all the droplets it created.

Building VM Images

This repository also contains Packer templates for building VM images. With the tools preinstalled, the time to deploy the testnet is significantly reduced.

Regenerating the image should be something that's infrequent, so as of yet there's no command in the deploy binary for generating it. However, it's a simple process. First, install Packer on your system; like Terraform, it's widely available in package managers. Then after that:

export DIGITALOCEAN_TOKEN=<your PAT>
cd resources/packer
packer init .
packer build build.pkr.hcl

This will produce a VM image that can now be launched as a droplet. There is also another template, node.pkr.hcl.

Logging Infrastructure

We forward the logs for our testnets to an S3 bucket, which requires some infrastructure.

The VMs hosting our nodes are small machines with about 2GB of RAM. They use Filebeat to forward the logs to a dedicated Logstash stack, which then forwards them on to S3. For Logstash, right now, we only have one stack and a single machine in the stack, but we've designed to accommodate having many.

This Logstash stack will serve all testnets. To bring the stack up, use this command:

cargo run -- logstash deploy --name main --provider digital-ocean

To tear it down:

cargo run -- logstash clean --name main --provider digital-ocean

By default, all deployed testnets will point to this main stack. However, it's possible to create another one with a different name, and supply the name of that stack on the main deploy command, using the --logstash-stack-name argument.

License

This repository is licensed under the BSD-3-Clause license.

See the LICENSE file for more details.

Dependencies

~85–125MB
~2M SLoC