flexiEdge

flexiEdge is core component in the flexiWAN ECO System.

flexiWAN provides unique networking technology and open architecture for SD-WAN & SASE. It’s disrupts and democratizes the SD-WAN and SASE market with its 3 world First SD-WAN & SASE Open Source, First application store for SD-WAN & SASE, and First SaaS business model for SD-WAN & SASE

In addition to being a complete solution, flexiWAN removes vendor lock-in and breaks networking monopolies by slicing SD-WAN horizontally allowing for dynamic 3rd party applications (Smartphone concept) to be loaded and run in the data flow of the router or in the cloud management system.

Introduction

This chart bootstraps flexiEdge as a Kubernetes VM intsnace on top of KubeVirt technology.

Philosophy

The flexiEdge HelmChart is focused on flexiEdge deployment configuration.

To keep this HelmChart as generic as possible we tend to avoid integrating any third party solutions nor any specific use cases.

Accordingly, the encouraged approach to fulfill your needs:

1. override the default flexiEdge configuration values (yaml file or cli)
2. append your own configurations (kubectl apply -f myconf.yaml)
3. extend this HelmChart (as a Subchart)

Application Description

As Kubernetes containerized platforms become the next generation universal platform for Edge and Networking. The integration of flexiWAN makes it easy for Service Providers, ISVs, and SIs to onboard this technology and offer services based on it. This Helm Chart installs a flexiEdge networking Edge instance for secure connectivity supporting scenarios such as branch-to branch, branch-to-PoP, or remote user to branch offices or PoP.

The application is centrally managed from the cloud using flexiManage. It enhances the traffic availability, quality and security in the network.

Installing

Prerequisites

With the command helm version, make sure that you have:

• Helm v3 installed

With the command kubectl version, make sure that you have:

• Kubernetes 1.16+

With the command kubectl get kubevirt.kubevirt.io/kubevirt -n kubevirt -o=jsonpath="{.status.observedKubeVirtVersion}", make sure that you have

• KubeVirt 0.48.1+

With the command cat /etc/cni/net.d/00-multus.conf | jq .cniVersion, make sure that you have:

• Multus CNI 0.3.1+

Using SRIOV based interface requires to have the SRIOV Network Device Plugin installed and configured.

Adding Chart Repository

Add flexiEdge’s chart repository to Helm:

For Main

helm repo add flexiwan https://helm.flexiwan.com/main

For Testing

helm repo add flexiwan https://helm.flexiwan.com/testing

For Unstable

helm repo add flexiwan https://helm.flexiwan.com/unstable

You can update the chart repository by running:

helm repo update

Deploying the chart

To install the chart with the release name flexiedge:

helm install flexiedge flexiwan/flexiedge

Tip: List all releases using helm list -A

Undeploying the Chart

To uninstall/delete the flexiedge deployment:

$ helm delete flexiedge

The command removes all the Kubernetes components associated with the chart and deletes the release.

Parameters

Image parameters

Kubernetes parameters

flexiEdge parameters

Kubevirt parameters

Proxy parameters

Network parameters

Example

The following example provide a way to deploy flexiEdge with the following parameters:

• Name: flexiwan
• Ethernet interface:
  • CNI0 as calico interface with no dhcp router in disable mode
  • CNI1 as SRIOV interface assign to sriov-vfio-network-c1p1 with manual IP configuration (172.16.0.2/29 and Gateway 172.16.0.1)
• Token: ************************

helm install flexiwan flexiwan/flexiedge  --set ethernets.cni0.dhcproutes=false --set ethernets.cni1.type=sriov \
--set ethernets.cni1.sriov=smartedge-apps/sriov-vfio-network-c1p1 --set ethernets.cni1.dhcp=false \
--set ethernets.cni1.address=172.16.0.2/29 --set ethernets.cni1.gateway=172.16.0.1 --KubernetesAPI=172.26.1.1 \
–flexiwan.token=”*******************************************************”

NAME: flexiedge
LAST DEPLOYED: Sun Aug 28 16:40:24 2022
NAMESPACE: default
STATUS: deployed
REVISION: 1
TEST SUITE: None
NOTES:
==========================================================================
Thank you for using flexiWAN - The World’s First Open Source SD-WAN & SASE
==========================================================================

1. flexiEdge is now running on your Kubernetes cluster

2. NOTE: It may take a few minutes for the VM to be available.
   You can watch the status of by running 'kubectl get --namespace flexiedge vmi -w'

3. To uninstall helm chart use the command:
   helm delete flexiedge

---------

Exposing the flexiEdge dashboard

This HelmChart does not expose the flexiEdge dashboard by default, for security concerns. Thus, there are multiple ways to expose the dashboard. For instance, the dashboard access could be achieved through a port-forward :

kubectl port-forward $(kubectl get pods --selector "app.kubernetes.io/name=flexiEdge" --output=name) 8080:80

Accessible with the url: http://127.0.0.1:8080/

Another way would be to apply your own configuration, for instance, by defining and applying an IngressRoute CRD.

Uninstall the Chart

In order to delete flexiWAN simply run the following comman

$ helm uninstall flexiedge
release "flexiedge" uninstalled

Troubleshooting

To troubleshoot the Helm Chart installation process:

• First make sure the Helm is deployed:

$ helm list
NAME            NAMESPACE       REVISION        UPDATED                                 STATUS          CHART           APP VERSION
flexiedge       default         1               2022-08-28 18:27:28.471894243 +0000 UTC deployed        flexiedge-0.0.1 latest

• Check if the virt-launcher Pod is running

$ get pod -n flexiedge
NAME                            READY   STATUS    RESTARTS   AGE
virt-launcher-flexiedge-kxrft   1/1     Running   0          2m6s

• Check if the VMI is running

$ kubectl get vmi -n flexiedge
NAME        AGE     PHASE     IP              NODENAME            READY
flexiedge   2m47s   Running   10.245.14.167   ubuntu-4042ff21dd   True

• Access the VM via the Virtual Console (default user: admin, default password: flexiwan) ```bash $ virtctl console flexiedge -n flexiedge Successfully connected to flexiedge console. The escape sequence is ^]

Ubuntu 18.04 LTS flexiedge ttyS0

flexiedge login:

```

To troubleshoot flexiWAN issues refer to the troubleshooting guide here.

Additional Information

After deploying flexiWAN, follow the documentation steps here to complete the configuration.

Related material

• https://flexiwan.com/
• https://flexiwan.com/academy/
• https://docs.flexiwan.com/

Contributing

If you want to contribute to this chart, please read the Contributing Guide.