Repository files navigation

pyns2(renamed from netns-siml) is network simulator with linux network namespace create virtual network by yaml format config file.

Blog post(Japanese)

Nowveth andbridge type interface is supported.

This tool works on Linux and need root access.To quick use, please you can useVagrant.This also works on privileged docker container. But under docker for mac environment, external access(NAT) don't work.

You can try pyns2 in two ways.

If you try pyns2 with vagrant, you can use full function; an external network access and ebpf monitoring.

1. clone this repository

$ git clone https://github.com/terassyi/pyns2.git$cd pyns2

2. run vm and connect it

$ vagrant up$ vagrant ssh

3. run example

$ pyns2 run pyns2/example/example-container.yml

You can try pyns2 with docker easier than with vagrant, but features are limited.

1. clone this repository

$ git clone https://github.com/terassyi/pyns2.git$cd pyns2

2. run container

$ docker build -t pyns2.$ docker run -it --privileged --name pyns2 bash

3. run example

$ pyns2 run pyns2/example/example.yml

This is the example of network definition. This file is inexamples/example-container.yml

example-network-container:host:ifaces:br0:type:"bridge"address:"192.168.50.2/24"ifaces:                    -"host1-veth1-br"                    -"host2-veth1-br"                    -"host-veth1-br"host-veth1:type:"veth"address:"192.168.50.1/24"peer:"host-veth1-br"nat:src:"192.168.50.0/24"out_iface:"eth0"netns:host1:ifaces:host1-veth1:type:"veth"address:"192.168.50.100/24"peer:"host1-veth1-br"routes:              -route:gateway:"192.168.50.1"dest:"default"host2:ifaces:host2-veth1:type:"veth"address:"192.168.50.101/24"peer:"host2-veth1-br"routes:                -route:gateway:"192.168.50.1"dest:"default"

Other exampele is located inexamples/

• create <file>

  This command create netns and interface.

• set <file>

  This command set created interfaces in netns

• run <file>

  This command run virtual network from config file. This command is equal tocreate andset

• delete <file>

  This command deletes virtual network created by run command

• exec <netns name> <command>This command executes the command(default isbash) in the target network namespace.

  Note: if you want to execute the command contains space(exp: ping 8.8.8.8) , you have to write as list object like ['ping', '8.8.8.8']

• up <file>

  This command up created interfaces

• down <file>

  This command down creted interfaces

• list <file>

  This command shows created netns

• validate <file>

  This command checks whether config file valid

• check_netns

  This command output current netns name

• implement monitoring modules
• add supports of other interface types