Deploy a Customer Site

Install the Volterra Node or Cluster

Quickstart

Using Volterra’s Quickstart you can install Volterra Node on AWS or Azure. For more information on the tool please go to the Volterra Quickstart tool.


Install the Volterra Node on AWS

Create

Step 1: Create a terraform vars file

{
    "access_key": "<aws access key>",
    "secret_key": "<aws secret key>",

    "cluster_token": "<volterra token>",

    "machine_public_key": "<ssh-public-key>",
    "machine_image": "<AMI-ID>",

    "deployment": "<ce_cluster_name>",
    "region": "<aws region>"
}

Step 2: Run below commands to deploy

docker run --rm -v $(pwd):/opt/bin:rw docker.io/volterraio/volt-terraform:latest cp /deploy-terraform.sh /opt/bin
./deploy-terraform.sh apply -p aws -i <absolute_path_to_vars_file> -tn ce-single-aws --force

Example command to bring up a single Volterra Node CE

./deploy-terraform.sh apply -p aws -i /var/tmp/aws.tfvars -tn ce-single-aws --force

Delete

Step 1: Run below command to delete your deployment

./deploy-terraform.sh destroy -p aws -i <absolute_path_to_vars_file> -tn ce-single-aws --force

Example command to delete a single Volterra Node CE

./deploy-terraform.sh destroy -p aws -i /var/tmp/aws.tfvars -tn ce-single-aws --force

Install the Volterra Cluster on AWS

Create

Step 1: Create a terraform vars file

To install a cluster with three master nodes, enter the following:

{
"access_key": "<aws access key>",
"secret_key": "<aws secret key>",

"cluster_token": "<volterra token>",

"machine_public_key": "<ssh-public-key>",
"machine_image": "<AMI-ID>",

"deployment": "<ce_cluster_name>",
"region": "<aws region>"

}

To install a cluster with three master nodes and worker nodes, enter the following:

{
"access_key": "<aws access key>",
"secret_key": "<aws secret key>",

"cluster_token": "<volterra token>",

"machine_public_key": "<ssh-public-key>",
"machine_image": "<AMI-ID>",

"deployment": "<ce_cluster_name>",
"region": "<aws region>",
"machine_count": "<number of worker nodes>"
}

Step 2: Download the terraform deploy script.

docker run --rm -v $(pwd):/opt/bin:rw docker.io/volterraio/volt-terraform:latest cp /deploy-terraform.sh /opt/bin

Step 3: Run the deployment script:

./deploy-terraform.sh apply -p aws -i <absolute_path_to_vars_file> -tn ce-multi-aws --force

Example command to bring up a single Volterra Node CE

./deploy-terraform.sh apply -p aws -i /var/tmp/aws.tfvars -tn ce-multi-aws --force

Delete

Step 1: Run below command to delete your deployment

./deploy-terraform.sh destroy -p aws -i <absolute_path_to_vars_file> --force

Example command to delete a single node CE

./deploy-terraform.sh destroy -p aws -i /var/tmp/azure.tfvars -tn ce-single-aws --force

Install the Volterra Node on Azure

Create

Step 1: Create a terraform vars file

{
"subscription_id": "<az subscription id>",
"tenant_id": "<az sp tenant id>",
"cluster_token": "<volterra token>",
"client_secret": "<az sp secret>",
"client_id": "az sp client id",
"deployment": "<ce_cluster_name>",
"machine_public_key": "<ssh-public-key>"
}

Step 2: Run below commands to deploy

docker run --rm -v $(pwd):/opt/bin:rw docker.io/volterraio/volt-terraform:latest cp /deploy-terraform.sh /opt/bin
./deploy-terraform.sh apply -p azure -i <absolute_path_to_vars_file> -tn ce-single-azure --force

Example command to bring up a single Volterra Node CE

./deploy-terraform.sh apply -p azure -i /var/tmp/azure.tfvars -tn ce-single-azure --force

Delete

Step 1: Run below command to delete your deployment

./deploy-terraform.sh destroy -p azure -i <absolute_path_to_vars_file> --force

Example command to delete a single node CE

./deploy-terraform.sh destroy -p azure -i /var/tmp/azure.tfvars -tn ce-single-azure --force

Install the Volterra Cluster on Azure

Create

Step 1: Create a terraform vars file To install a cluster with three master nodes, enter the following:

{
"subscription_id": "<az subscription id>",
"tenant_id": "<az sp tenant id>",
"cluster_token": "<volterra token>",
"client_secret": "<az sp secret>",
"client_id": "az sp client id",
"deployment": "<ce_cluster_name>",
"machine_public_key": "<ssh-public-key>"
}

To install a cluster with three master nodes and worker nodes, enter the following:

{
"subscription_id": "<az subscription id>",
"tenant_id": "<az sp tenant id>",
"cluster_token": "<volterra token>",
"client_secret": "<az sp secret>",
"client_id": "az sp client id",
"deployment": "<ce_cluster_name>",
"machine_public_key": "<ssh-public-key>",
"machine_count": "<number of worker nodes>"
}

Step 2: Download the terraform deploy script.

docker run --rm -v $(pwd):/opt/bin:rw docker.io/volterraio/volt-terraform:latest cp /deploy-terraform.sh /opt/bin

Step 3: Run the deployment script:

./deploy-terraform.sh apply -p azure -i <absolute_path_to_vars_file> -tn ce-multi-azure --force

Example command to bring up a single Volterra Node CE

./deploy-terraform.sh apply -p azure -i /var/tmp/azure.tfvars -tn ce-multi-azure --force

Delete

Step 1: Run below command to delete your deployment

./deploy-terraform.sh destroy -p azure -i <absolute_path_to_vars_file> -tn ce-multi-azure --force

Example command to delete a single node CE

./deploy-terraform.sh destroy -p azure -i /var/tmp/azure.tfvars -tn ce-multi-azure --force

Additional Install Options

For additional Volterra Node deployment options please go to our Install section.


Accept the Node Registration

You can accept node registration via

  • Volterra Console Dashboard
  • vesctl

Volterra Console

Manually accept the registration via Volterra Console. Login to the Volterra Console and navigate Volterra -> System -> Site Management -> Registration.

Step 1: Look for site registration

SiteReg
FIgure: Site registration

Step 2: Accept registration (adjust fields as needed)

SiteReg
FIgure: Accept Registration


vesctl

vesctl option (if available)

Verify Node Registration

You can verify node registration via

  • vesctl
  • Volterra terraform
  • Volterra Console Dashboard

Volterra Console

Login to the Volterra Console and navigate Volterra > System.

Step 1: Confirm the site is up in either System Map or Site List

SiteReg
FIgure: Sites -> System Map

SiteReg
FIgure: Sites -> Site List

SiteReg
FIgure: Sites ->Connectivity -> Status


Next Steps

Now that you have a Volterra Site up and running, use the Volterra Console or Public APIs via terraform or vesctl to start configuring VoltMesh or VoltStack services.

  1. With a Volterra Site up and running try some of our Quickstarts

  2. Introduction to Volterra concepts and services

    1. Services
    2. Concepts