Emmy

Automate the creation of Docker network topologies and analyze them.

Sample YAML file

The following YAML file would be used for creating a network with the topology {{0, 1, 2}, {2, 3}, {1, 3}}. We also bridge container 1 to the host network. Each number in the topology represents a container, and each set is a network. Notice there's a hole in this network (around {1, 2, 3}).

name: "example"
image: "alpine"
networks:
  - containers: [0, 1, 2]
    label: "big"
  - containers: [2, 3]
    image: "ubuntu"
  - containers: [1, 3]
containers:
  - bridge: true
    cmd: ["sh"]
    image: "ubuntu"
    containers:
      - 1

Options

• networks.containers
• networks.label
• networks.image
• networks.external
• networks.driver
• networks.enableIPV6
• containers.containers
• containers.cmd
• containers.image
• containers.bridge
• containers.networks

Example usage

Create a Mobius strip of alpine containers and analyze the results:

$ emmy create ./emmy/examples/mobiusStrip.yaml
$ emmy analyze
Container count: 6
Network count: 6
Connected networks count: 1
Euler characteristic: 0
Hole count:
	- 1D: 1
	- 2D: 0
Minimal paths around 1-dimensional holes:
	- example_0->example_2->example_1->example_0

Teardown the mobius strip we just created:

$ emmy teardown ./emmy/examples/mobiusStrip.yaml

Why the name emmy?

https://en.wikipedia.org/wiki/Emmy_Noether