Create a Virtual Site


This guide provides instructions on how to create a Virtual site by assigning labels. Virtual site provides mechanism to perform operations on a group of sites reducing the need to repeat the same set of operations for each site. To know more about virtual site and labels, see Virtual Site and Labels respectively.

You can use virtual sites to deploy applications, discover service endpoints, and advertise services across a number of sites selected as per the site selection criteria of the virtual site.

Using the instructions provided in this guide, you can assign labels to your sites and group them by creating a virtual site.


The following prerequisites apply:


The following shows a label assignment and creation of a virtual site workflow:

Figure: Creating a Virtual Site using Labels

Configuration Sequence

Creating virtual site includes performing the following sequence of actions:

Phase Description
Create and Assign a Custom Label Create a new label or use an existing label to assign it to a site.
Create a Virtual Site Create a virtual site using the label expression. The label created in the previous phase is used to match the site and group it under the virtual site.

Note: The keys and labels can be system-provided or user-defined. For more details on labels, click here.

Create and Assign a Custom Label

Log in to VoltConsole portal and perform the following:

Step 1: Select the system namespace and the required site from site list. Click ... on the right end of your site and click Edit to load the site edit form. Navigate to Labels’ and provide a Key. You can select a pre-defined key or create your own key. This example associates the site-select key with the site volterra-demo-site-1.

Figure: Creating a Key associated with a site

Step 2: Enter a value for the corresponding key created in Step 1. This example associates a value demo with a key site-select.

Figure: Creating a Label associated with a Key

Step 3: Select the system namespace and the required site from the site list. Using the dropdown option, select metadata and expand labels.

Figure: Listing Labels from Metadata

Note: The metadata section contains all labels associated with the site. As sites are registered, Volterra automatically populates some labels such as hw-vendor, provider, hw-model, etc. The label site-select:demo created in this example is associated with the site volterra-demo-site-1.

You can determine the existing labels assigned to a site by checking the site schema from the VoltConsole or using APIs.

Create a Virtual Site

Step 1: Navigate to a specific namespace or shared namespace. Select Manage -> Virtual Sites in shared namespace or Manage -> Virtual Hosts -> Virtual Sites in the application namespace.

Step 2: Click Add virtual site to load virtual site creation form.

Step 3: Enter required fields as per the following guidelines:

  • Enter a name in the metadata section.
  • Select a type for the Site Type field. This example selects site type as CE.

Figure: Creating a Virtual Site

Step 4: Frame the label expressions to group Volterra edge cloud sites. This example shows selecting sites that have the site-select:demo label assigned.

Figure: Configuring Expressions

This creates a Virtual site which maps to all the sites with the site-select:demo label.

Note: In this example, entering site-select:demo (key:value pair) in the expressions field creates a virtual site that maps to the volterra-demo-site-1 site.

Step 5: Click Continue button in the form to complete creation of the virtual site.

Figure: Creating a Virtual Site


API References