Hello, WebApp!

This “Hello, WebApp!” is the first quickstart in Volterra’s “Hello, World!” series. This is a basic use-case to get you started, additional use-cases can be enabled by reading appropriate how-to guides. It will start by securing your existing WebApp (running in any cloud location) from the clients on the Internet. All you need to bring is your service endpoint and Volterra will securely proxy the connection across Volterra’s global network using the VoltMesh offering. You’ll be able to visualize web application connectivity and security metrics using Volterra Console.

VoltMesh
Figure: Secure Deployment of Webapp Using VoltMesh

In summary, you will:


Prerequsites

Minimum


Steps

The following steps are designed for those who’d like to cut & paste into their terminal.

Deploy

P12 file can be created and downloaded from API credentials section of your Volterra tenant. P12 file can only be downloaded (auto-downloaded) while creation

  1. Download and save your PCKS file (.p12) with your API credentials from your Volterra tenant. Remeber the password which you have entered, it will be used in later steps

    Login to Volterra Console and create API credentials [navigate to "system" namspace --> IAM --> API Credentials]

  2. Create a terraform variable file. Below is a sample file.

    # DEFINITIONS
    # 
    # api_p12_file: $PATH/to_your_api_creds.p12
    # api_url: your tenant's apu url (e.g. https://volt-demos.console.ves.volterra.io/api)
    # webapp: Resolvable DNS name to webapp (e.g. apache.org)
    # name: name for this example your are creating
    # this will create URL - name.tenant_name.helloclouds.app
    
    {
        "api_p12_file": "/home/user1/Api_Credentials.p12",
      "api_url": "<your tenant's api url>"
        "webapp": "apache.org",
        "name": "example1"
    }
    
  3. Download volt-terraform deployment script to the local machine. This will download the Volterra Quickstart Script.

    docker run --rm -v $(pwd):/opt/bin:rw docker.io/volterraio/volt-terraform:latest cp /deploy-terraform.sh /opt/bin
  4. Run the deploy-terraform.sh to connect and secure your webapp through VoltMesh.

    #Set the VES_P12_PASSWORD env variable. 
    #This should be the same password which you entered while creating API Credentials in step 1
    
    export VES_P12_PASSWORD=<password>
    ./deploy-terraform.sh apply -p volterra -i <absolute_path_to_variable_file> -tn quickstart-webapp --force
    
  5. Open Volterra Console for your WebApp statistics.

    Note: It will take a few minutes for statistics to show up.

    open $(./deploy-terraform.sh output -n <name you have provide in variable file> virtual_host_dashboard_url)
    

Destroy

  1. To destroy all Volterra service objects created then run the following:

    ./deploy-terraform.sh destroy -p volterra -i <absolute_path_to_variable_file> -tn quickstart-webapp --force
    

Concepts