Configure Storage in Fleet
Objective
This guide provides instructions on how to set storage for your applications using the F5® Distributed Cloud Services fleet of sites. Storage configuration set using fleet gets applied to all the sites that are part of the fleet and will be accessible to the workloads on those sites. For more information on Distributed Cloud fleet concept, see Fleet.
Using the instructions provided in the document, you can define the following storage configuration using fleet:
- Storage devices - configuration for a specific hardware appliance.
- Storage classes - class to which the appliance belongs to and this is dependent on the appliance provider. For example, a class can be a fast pool or slow pool of devices.
- Storage interfaces - interfaces for storage devices.
Note: This guide provides instructions on setting storage for an existing fleet by editing the fleet object configuration. However, you can also define the storage configuration in a similar manner while creating a fleet. For information on how to create a fleet, see Create Fleet guide.
Prerequisites
- F5 Distributed Cloud Account is required.
Note: In case you do not have an account, see Create an Account.
-
F5 Distributed Cloud site.
-
Storage devices (cloud or on-premise data centers).
Configuration
Use the following steps to configure storage for your applications.
Note: By default, a Distributed Cloud site deployed in AWS will support Elastic Block Store (EBC), GCP supports Google Cloud Storage, and Azure supports Azure Disk Storage.
Step 1: Navigate to the Fleets page.
- Select the
Cloud and Edge Sites
service. - Navigate to
Manage
->Site Management
->Fleets
.
Step 2: Edit fleet set interfaces for storage.
- Select
...
->Manage
for the fleet object for which you want to define storage configuration. The clickEdit Configuration
in the upper right corner. - Navigate to
Storage Configuration
section and selectList of Storage Interface
for theSelect Storage Interface Configuration
field. - Select an interface from the displayed list or click
Create new network interface
for theList of Interface
field. You can add multiple interfaces using theAdd item
option.
Note: See Interfaces for instructions on creating network interfaces. See Multi Node Site Network Setup Using Fleet for instructions on how to configure networking using fleet for multi node sites.
Step 3: Configure storage devices.
- Select
List of Storage Devices
for theSelect Storage Device Configuration
field.
- Click
Add Item
under theList of Storage Devices
field. This opens storage devices configuration.
- Enter a name for the
Storage Device
field. Ensure that this name corresponds to the class in which the storage device falls. The classes are used by vK8s for storage related actions. - Select an option for the
Select Storage Device to Configure
field and perform one of the following based on the option you chose:
NetApp Trident
-
Select an option for the
Select NetApp Trident Backend
field. TheONTAP NAS
is selected by default. -
Select an option for the
Backend Management LIF
field. TheBackend Management LIF IP Address
is selected by default. Enter an IP address for the backend management logical interface in theBackend Management LIF IP Address
field. In case you select the name option, enter the backend management interface name. -
Select an option for the
Backend Data LIF
field. TheBackend Data LIF IP Address
is selected by default. Enter an IP address for the backend data interface in theBackend Data LIF IP Address
field. In case you select the name option, enter the backend data interface name.
-
Enter a username in the
Username
field. ClickConfigure
for thePassword
field. Enter your password in theSecret
page and clickBlindfold
. Wait for the Blindfold to complete encrypting your password and clickApply
. -
Enter a certificate in the
Client Certificate
field. ClickConfigure
for theClient Certificate
field. Enter your the text for your secret in theSecret
page and clickBlindfold
. Wait for the Blindfold to complete encrypting your password and clickApply
. -
Enter a certificate in the
Trusted CA Certificate
field. ClickConfigure
for theTrusted CA Certificate
field. Enter your the text for your secret in theSecret
page and clickBlindfold
. Wait for the Blindfold to complete encrypting your password and clickApply
.
-
Enter CIDR for your K8s nodes in the
Auto Export CIDRs
field in case auto export policy is enabled for your storage device. -
If you are configuring virtual storage, then in the Virtual Storage Pools section, enter a label and region for the for the storage, and click
Add Item
one or more times to add pool labels and pool zones. -
Click
Apply
.
Pure Storage Service Orchestrator
-
Enter a cluster identifier in the
Cluster ID
field. This is used to identify the volumes used by the datastore. Alphanumeric characters and underscores are allowed.Note: Unique cluster ID is required for multiple K8s cluster using the same storage device.
-
Click
Configure
under theFlash Arrays
field.
-
Click
Add Item
to add a flash array endpoint.Figure: Pure Storage Flash Array endpoint - Enter an IP address in the
Management Endpoint IP Address
field. - Click
Configure
under theAPI Token
field. Enter the token in the secret field and clickBlindfold
. ClickApply
after the Blindfold encryption is completed. - Optionally select labels for this endpoint.
- Click
Add Item
.
- Enter an IP address in the
-
Click
Configure
under theFlash Blade
field.
- Click
Add Item
to add a flash blade endpoint.
- Enter the IP address in the
Management Endpoint IP Address
field. - Click
Configure
under theAPI Token
field. Enter the token in the secret field and clickBlindfold
. ClickApply
after the Blindfold encryption is completed. - Enter the IP address in the
NFS IP Address
field. - Optionally add labels for this endpoint.
- Click
Add Item
.
Note: You can change the management or NFS endpoints to specify management endpoint name or NFS DNS name.
- Click
Apply
.
Custom Storage
The custom storage classes option is used for storage devices or external storages, which are deployed outside of F5 Distributed Cloud Services. For instance, the option allows you to configure custom storage classes for AWS, GCP, etc.
- Select
Custom Storage
for theSelect Storage Device to Configure
field. - Click
Add Item
.
Note: You can add multiple devices using the
Add item
option.
Step 4: Configure storage classes.
You can use default storage classes supported in K8s or you can customize the classes. In case you are using default classes, ensure that the storage device names correspond to the K8s classes.
NetApp Trident
- Click
Add Item
.
Pure Storage Service Orchestrator
- Select an option for the
Backend
field. Theblock
option is selected by default. - Optionally enter IOPS and bandwidth limits in their respective fields.
- Click
Add Item
.
Custom Storage Class
-
Select
Add Custom Storage Class
for theSelect Configuration for Storage Classes
field. -
Click
Add Item
under theList of Storage Classes
field. This opens theStorage Class Parameters
page. -
Enter a name for the
Storage Class Name
field. This name will appear in K8s. -
Enter a name in the
Storage Device
field. This is the storage device that will be used by this class, as entered ini Step 3. -
Optionally enter a storage class description.
-
Optionally check the
Default Storage Class
box to make this storage class the default for the K8s cluster. -
Select
Custom Storage
for theSelect Storage Class Configuration
field. -
Enter the storage class YAML. It must have the configuration of
apiVersion: storage.k8s.io/v1 kind: StorageClass ...
-
Enter a
Reclaim Policy
. -
Optionally check the
Allow Volume Expansion
box. -
Optionally enter generic/advanced parameters.
-
Click
Add Item
.
Note: You can add multiple classes using the
Add item
option.
Step 5: Complete applying storage configuration to fleet.
Click Save and Exit
to apply the storage configuration fleet.
Note: You can add the sites to fleet by adding the fleet label to the site configuration. See Create Fleet guide for more information.