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 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

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 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 Sites 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, whilst 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 doesn’t 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 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 the Network Firewall creation and applying to your fleet of gateways:

Create a Fleet

Step 1: Log into the VoltConsole and start fleet configuration.

Select Manage from the configuration menu in the system namespace. Select Site Management -> Fleet from the options. Click Add fleet.

image4
Figure: Fleet Configuration

Step 2: Configure Fleet label. After configuring a name in your Fleet object, configure the `fleet label value`. This value can be the same as the name.

image3
Figure: Fleet Label Value

Step 3: Fleet configuration. All options in the `Fleet Configuration` section are optional.

image10
Figure: Fleet Configuration section

Go to Fleet Configuration section and perform the following:

Step 3.1: Select or create Outside or Inside Virtual Networks.
  • Click on Select Outside virtual network object or Select Inside virtual network object to select or create virtual networks for this fleet.

image8
Figure: Selecting Virtual Networks to add to a fleet

Step 3.2: Software and Operating system version.
  • Insert the Software version and/or Operating system version to dictate the versions to be pushed to all your sites members of this fleet.

image9
Figure: Software and OS version form

  • For the Fleet software and OS versions to be installed in your site, you will need to configure the site with Site Version software Override in Sites -> Site List, then find your site object and click ... -> Edit to edit your site properties. Locate the Site Software Version Override drop down menu and select Fleet Version Overrides.

image9
Figure: Site Software Version Override menu

Step 4: Select or create Network Interfaces for your sites in this fleet.

Network Interface object represents the configuration of a network device in a fleet of Volterra Customer Edge sites.

image1
Figure: Network Interfaces

Go to Network Interfaces section and perform the following:

Step 4.1: Select or create Network Interfaces.
  • Select a Network interface in the drop-down menu.

    • Add items to add or create more interfaces.
Step 5: Select or create Network Connectors for your fleet.

Network Connectors object is used to create connections.

image13
Figure: Network Connectors

Go to Network Connectors section and perform the following:

Step 5.1: Select or create Network Connectors.
  • Click on Select network connector object to select or create Network Connectors for this fleet.

image11
Figure: Selecting Network Connectors to add to a fleet

Step 6: Select or create Network Firewall for your fleet.

Network Firewall object is used to configure Network Policies, Forward Proxy Policies and Fast ACLs on one object to be applied to a fleet of sites.

image5
Figure: Network Firewall section

Go to Network Firewall section and perform the following:

Step 6.1:Select or create Network Firewall.
  • Click on Select network firewall object to select or create a Network Firewall for this fleet.

image12
Figure: Selecting Network Firewall to add to a fleet

Step 7: Complete creating fleet.

Click Save and Exit.


Apply Fleet on a site

When your Fleet is configured, you will need to apply it on your sites so that the sites on that fleet are configured with the settings you just created.

Perform the following to apply the Fleet label to a site:

  • Navigate to Sites -> Site List, find your site object and click ... -> Edit to edit your site properties.
  • Locate the Labels box form and insert the key-value pair that represents your fleet. Start by typing fleet and you will see the key value ves.io/fleet, when you click on this key you will see your fleets available for selection as the values.

image2
Figure: Fleet Label Key

  • Select your fleet and save

image6
Figure: Fleet Label Key and Value

  • Click Save and Exit to save Changes.

Your site is now part of the fleet that you configured.


Concepts


API References