Gitiles
Code Review Sign In
osm.etsi.org / osm / vim-emu / d313dc1ebe04c14d3e1cc915b9778474c7236409
commitd313dc1ebe04c14d3e1cc915b9778474c7236409[log] [tgz]
authorpeusterm <manuel.peuster@uni-paderborn.de>Thu Feb 04 15:36:02 2016 +0100
committerpeusterm <manuel.peuster@uni-paderborn.de>Thu Feb 04 15:36:02 2016 +0100
treea682d6af671baf59081bd9ef3d2ca405a7a480b9
parenta47db03ce7574cd082d2a8c5a40c3ad352ff89fc [diff]
added CLI interface to retrive datacenter information
4 files changed
tree: a682d6af671baf59081bd9ef3d2ca405a7a480b9
  1. .gitignore
  2. LICENSE
  3. README.md
  4. ansible/
  5. emuvim/
README.md

Distributed Cloud Emulator

Contributors:

Requirements

  • needs the latest Dockernet to be installed on the system
  • the emulator is implemented against Dockernet's APIs
  • The emulator uses ZeroMQ based RPC to for communication between demo CLI client and cloud-like APIs
  • pip install zerorpc
  • (This will be replaced / extended by a REST API later)

Project structure

  • emuvim/ all emulator code
  • api/ Data center API endpoint implementations (zerorpc, OpenStack REST, ...)
  • cli/ CLI client to interact with a running emulator
  • dcemulator/ Dockernet wrapper that introduces the notion of data centers and API endpoints
  • test/ Unit tests
  • example_topology.py An example topology script to show how topologies can be specified

Installation

Automatic installation is provide through Ansible playbooks.

  • Requires: Ubuntu 14.04 LTS
  • sudo apt-get install ansible git
  • sudo vim /etc/ansible/hosts
  • Add: localhost ansible_connection=local

1. Dockernet

  • cd
  • git clone https://github.com/mpeuster/dockernet.git
  • cd ~/dockernet/ansible
  • sudo ansible-playbook install.yml
  • Wait (and have a coffee) ...

2. Emulator

  • Fork the repository.
  • cd
  • git clone https://github.com/<user>/son-emu.git
  • cd ~/son-emu/ansible
  • sudo ansible-playbook install.yml

Run

  • First terminal:
  • cd ~/son-emu/emuvim
  • sudo python example_topology.py
  • Second terminal:
  • cd ~/son-emu/emuvim/cli
  • ./son-emu-cli compute start -d dc1 -n vnf1
  • ./son-emu-cli compute start -d dc1 -n vnf2
  • ./son-emu-cli compute list
  • First terminal:
  • dockernet> vnf1 ping -c 2 vnf2

Run Unit Tests

  • cd ~/son-emu/emuvim
  • sudo python test or sudo python test -v for more outputs

TODO

  • DCemulator
  • Advanced network model
  • improve network management, multiple interfaces per container
  • API to create multiple networks (per DC?)
  • SDN Controller
  • simple API to chain running VNFs
  • Add resource constraints to datacenters
  • Check if we can use the Mininet GUI to visualize our DCs?
  • (Unit tests for zerorpc API endpoint, and any other new endpoint)

Features / Done

  • Define a topology (Python script)
  • Add data centers
  • Add switches and links between the,
  • Define API endpoints in topology
  • call startAPI from topology definition and start it in a own thread
  • make it possible to start different API endpoints for different DCs
  • DCemulator
  • correctly start and connect new compute resources at runtime
  • remove and disconnect compute resources at runtime
  • do IP management for new containers
  • list active compute resources
  • Cloud-like reference API with CLI for demonstrations
  • Write CLI client
  • Start compute (name, DC, image, network)
  • Stop compute
  • Create an Ansible-based automatic installation routine
  • Unit tests