Create a Fleet

Objective

This guide provides instructions on how to create a Fleet using the guided wizards in VoltConsole. See Fleet for more information.

Fleet is used to configure infrastructure components (like nodes) in one or more Volterra Customer Edge (CE) sites homogeneously. Fleet configuration has the following information:

  • Software image release to be deployed on the fleet
  • Virtual Networks
  • List of interface and devices to be configured on every node
  • Connections between the virtual networks
  • Security policies applied in the site

Fleet object must be created in the System namespace for the tenant.

Note: Volterra does not recommend that you create a Fleet for clouds sites, such as AWS VPC, AWS TGW, Azure VNET, GCP Credentials, or VoltStack Sites.

Associating Fleet with Site

Fleet has a field called fleet_label. When a fleet object is created, the system automatically creates a known_label ves.io/fleet=. The known_label is created in the Shared namespace for the tenant. A Site is made a "member of fleet" when this known_label is added to the Site. A Site can have at most one known_label of type ves.io/fleet and hence belongs to exactly one Fleet at any given time.

When a Site becomes a member of a Fleet, all nodes in the Site also become "members of that fleet". The Fleet configuration is applied on all nodes that are members of the Fleet.

Fleet and Virtual Site

Both Fleet and Virtual Site select a list of sites based on labels. But, there is a major difference between Virtual Site and Fleet. Virtual sites are intersecting subsets of available sites. Fleet is a non-intersecting subset of available sites compared to other Fleets. As a result, at most one Fleet configuration is applied on a Site. Also, while a Virtual Site selects sites based on their labels (via the Virtual Site configured label selectors), the Fleet has to be applied in the sites that you want to be part of that Fleet (it does not select them).

However, to enable other features like monitoring, deploying applications or jobs on sites represented by Fleet, the system will automatically create a Virtual Site in the Shared namespace representing all sites in a Fleet.

Using the instructions provided in this guide, you will be able to create a Fleet, with all its elements, and apply to your Site, making it part of this Fleet.


Prerequisites

Note: In case you do not have an account, see Create a Volterra Account.

  • Volterra Gateway.

Configuration

The following video shows you how to create a Fleet with the required network configuration and application for your gateways:

Create a Fleet

You can create and configure a Fleet label to apply to your sites, to perform software and operating system upgrades as well as other administrative tasks.

Step 1: Start creating a Fleet in VoltConsole.
  • In the System namespace, click Manage -> Site Management -> Fleets.

site manage fleet
Navigate to Fleets

  • Click Add fleet.

add fleet button
Figure: Add Fleet

Note: At any point throughout the Fleet configuration process, you can cancel the process by clicking Cancel and Exit. You will lose all the information you previously entered, and you will have to begin the Fleet configuration process from the beginning.

Step 2: Add your Fleet name and metadata.
  • In the Metadata section, enter a mandatory Fleet name in the Name field. You have the option to select a label and to enter a short description for your Fleet.
Step 3: Configure your Fleet label, virtual networks, and software versions.
  • In the Fleet Configuration section, enter a mandatory value for the Fleet label in the Fleet Label Value field.
  • Configure the following optional fields:

    • Select an outside virtual network from the Outside (Site Local) Virtual Network menu. To create a new network, click Create new virtual network. In the page that appears, configure the fields. After you finish, click Continue.
    • Select an inside virtual network from the Site Local Inside Virtual Network menu. To create a new network, click Create new virtual network. In the page that appears, configure the fields. After you finish, click Continue.
    • In the Software Version field, enter a software version.
    • In the Operating System Version field, enter an operating system version.

metadata fleet config complete
Figure: Fleet Configuration

Step 4: Select or create network interfaces for the sites in your Fleet.

Create a network interface object, which represents the configuration of a network device in a Fleet of Volterra sites.

  • To add and configure a new bond device:

    • From the Select Bond Configuration menu, select if you want to configure a new bond interface with Configure Bond Interfaces. The option for No Bond Devices is set by default.
    • Click Configure.
    • In the Bond Devices List section, in the Bond Device Name field, click See Common Values. Select a value from the list displayed. To expand the menu options, select Show Advanced Fields.
    • From the Member Ethernet Devices menu, click See Common Values. Select a value from the list displayed. You can add more member devices using the Add item option.
    • From the Select Bond Mode menu, select how the bonding occurs. If you select LACP (802.3ad), enter a packet interval value in the LACP Packet Interval field.
    • In the Link Polling Interval field, enter a value.
    • In the Link Up Delay field, enter a value.
    • After you finish, click Apply and then click Back.

new bond device created
Figure: Create New Bond Device

  • Perform the following to configure non-bond interfaces:

    • From the Select Interface Configuration menu, select your interface configuration from the options available. The Default Interface Config option does not require more configuration.
    • If you select List of Interfaces, select as many interfaces as needed. To add more, click Add item.
    • If you select Legacy Device List, enter the required information for Device Name, Device Owner, Device Instance and Use. To add more, click Add item.

network interfaces select
Figure: Creating network interface objects

Step 5: Configure network connectors.
  • To select an existing network connector:

    • Click Select Network Connector.
    • From the list that appears, find and select the network connector, and then click Select Network Connector.
    • Click Back to return to the previous page.

select network connector
Figure: Select Network Connector

  • To create a new connector, click Add new Network Connector. Complete the configuration using the instructions provided at Network Connectors.
Step 6: Select or create a network firewall for your Fleet.

The Network Firewall object is used to configure network policies, forward and reverse proxies, and Volterra Fast Access Control Lists (ACLs). After this object is configured, it is applied to all sites within a Fleet and any associated virtual networks.

  • To select an existing network firewall, use the Network Firewall drop-down menu to search for the network firewall.

existing net firewall
Figure: Select Existing Network Firewall

  • To create a new network firewall, Click Create new network firewall. Complete the configuration using the instructions provided at Network Firewall.

create new net firewall button
Figure: Create a New Network Firewall

Step 7: Configure Fleet storage.

Configure storage for your Fleet of sites using the instructions provided at Configure Storage in Fleet.

Step 8: Configure static routes and other advanced settings.

The advanced settings enable you to configure more options for your Fleet.

  • To configure a new static route:

    • From the Select Storage Storage Static Routes menu, click List of Storage Static Routes.
    • Click Configure to display the form.
    • On the static route creation form, configure the options available.
    • After you finish, click Apply and then click Back.
  • To configure more options, click Show Advanced Fields and perform the following:

  • Optionally, to enable the default Fleet configuration download, select the option for Enable Default Fleet Config Download.

Note: You must enable the default Fleet configuration download if you configured the GPU and storage settings.

enable config file
Figure: Enable Download of Configuration File

  • Click Save and Exit.

Apply the Fleet label to a Site

After your Fleet is configured, you will need to apply its label on your sites so that the sites are configured with the Fleet settings.

Step 1: Navigate to your Site.
  • In the System namespace, click Sites, and then click Site List.
  • Find your Site, click ... and then click Edit to edit your Site properties.
Step 2: Apply the Fleet label.
  • In the Labels box form, start by typing “fleet” and you will see the key-value pair ves.io/fleet. Select this key-value pair.

select key value pair
Figure: Select the Key-Value Pair

  • Type the name of your Fleet label, and then select it.

select fleet label
Figure: Select the Fleet Label

Step 3: Save the configuration.
  • Click Save changes.

Your Site is now part of the Fleet that you previously configured.


Concepts


API References