Skip to content

Latest commit

 

History

History

examples

README.md

ComNetsEmu Examples

These examples are intended for two purposes:

  1. Get started using ComNetsEmu's Python APIs and main features.
  2. Get started with core/essential tools/libraries/frameworks used in the application folder.

dockerhost.py and dockerhostcli.py

These examples show how to use Docker containers as Mininet's hosts and spawn terminals (currently only Xterm is supported) for them.

dockerindocker.py

This example demonstrates how to use ComNetsEmu's API to deploy Docker container inside Dockerhost instance. Docker-in-Docker(dind) is used by ComNetsEmu as an lightweight emulation for nested-Virtualization. The Dockerhost with internal Docker containers deployed is used to mimic an actual physical host that runs Docker containers.

Echo Server as a Service (echo_server)

This basic example demonstrates how to build and deploy a containerized service (a simple echo server) as an internal container on ComNetsEmu.

Manage APP container inside Dockerhost (dockerhost_manage_appcontainer.py)

This example shows how to manage application containers from one DockerHost instance instead of calling functions directly on manager object. This can be useful if you want to let one DockerHost node in the network to be the master node (like the master node in K8s) in to manage application containers on other worker nodes. Check the Docstring in ./dockerhost_manage_appcontainer.py for details.

DPDK

A basic example of running DPDK application inside Docker container and deploying it on ComNetsEmu. Check the doc in the subdirectory for details.

mininet_demystify

Demystify technologies used in Mininet for lightweight network emulation. Run two bash scripts inside the folder with root privilege:

  • run.sh: Build a topology with three hosts connected to a single switch and run basic ping, iperf and Openflow tests.
  • clean.sh: Cleanup all network resources and processes created by run.sh.

tun_ebpf.py

This example shows how to create TUN interface inside Docker host and attach XDP program to veth interface. This example requires installation of BCC to manage eBPF programs. BCC can be installed from source via installer with -b option.