k8s-egress-filtering-benchmark

README

Egress Filtering Benchmark

This repository contains a set of tools to measure the egress filtering performance using BPF, iptables, ipsets and calico.

How to Use

1. Setup two computers to run the test. You need to have Docker, iptables and ipset installed and you should be able to connect to those computers with SSH without requiring a password.

2. Download the latest Lokomotive release

   Unpack and move to a desired locatin:

   tar xvf lokoctl_$VERSION_linux_amd64.tar.gz
   mv lokoctl_$VERSION_linux_amd64/lokoctl ~/.local/bin/lokoctl
   

3. Create a Kubernetes cluster using Lokomotive with at least one worker node.

   A minimal working configuration that can be deployed on Packet (acquired by Equinix Metal)

   Update the variables in lokocfg.vars and execute:

   git clone git@github.com:kinvolk/egress-filtering-benchmark.git
   cd lokomotive
   lokoctl cluster apply
   

   Set location of kubeconfig using the environment variable KUBECONFIG:

   cd egress-filtering-benchmark/lokomotive
   export KUBECONFIG=$PWD/assets/cluster-assets/auth/kubeconfig
   

   Label the worker node as follows:

   kubectl label node calico-benchmark-pool-1-worker-0 nodetype=worker-benchmark
   

4. Configure the parameters of the test in the parameters.py file.

5. Install the required libraries in the client to run the Python script

pip install -r requirements.txt

1. Execute the tests:

$ cd benchmark
$ make
$ python run_tests.py --mode udp --username USERNAME --client CLIENTADDR --server SERVERADDR

This will create some csv files with the information about the test. You can plot them by your self or follow the next step.

1. Plot the data by running

$ python plot_data.py

This will create some svg files with the graphs.

Credits

The BPF filter is inspired by the tc-bpf man page and the Cilium documentation.