Name		Name	Last commit message	Last commit date
parent directory ..
templates		templates
validator-sets		validator-sets
README.md		README.md
auth.tf		auth.tf
cluster-test.tf		cluster-test.tf
faucet.tf		faucet.tf
faucet_variables.tf		faucet_variables.tf
fullnodes.tf		fullnodes.tf
load-balancing.tf		load-balancing.tf
main.tf		main.tf
monitoring.tf		monitoring.tf
network.tf		network.tf
terraform.tfvars		terraform.tfvars
validators.tf		validators.tf
variables.tf		variables.tf

README.md

Terraform

This directory contains Terraform configuration to deploy an entire Testnet on Amazon Web Services. It deploys a set of validator nodes (four by default), a faucet server for minting Libra, and a monitoring node running Prometheus.

Running a Testnet

Download and install Terraform.
Create an AWS account and setup your access keys.
Generate an SSH key (or use an existing one).
Edit terraform.tfvars and set the following:

api_sources_ipv4: Set this to the IPs/CIDRs from which you want to access the API endpoints.
ssh_sources_ipv4/ssh_sources_ipv6: Set this to the IPS/CIDRs from which you want to SSH to instances.
ssh_pub_key: Insert the content of your SSH public key.
ssh_priv_key_file: Set this to the filename of your SSH private key.

Run terraform init
Run terraform apply to startup the system in AWS.
In the AWS console go to the EC2 service in your region, and list the Load Balancers. Note the DNS name of the "default-ac" and "default-faucet" load balancers.
Run the client as follows: cargo run -p client --bin client -- -a <default-ac LB DNS name> -p 8000 -f <faucet-ac LB DNS name> -s terraform/validator-sets/dev/consensus_peers.config.toml