commit	9219983129248e2b5f7dfd5d1556b9789a8214ee	[log] [tgz]
author	peusterm <manuel.peuster@uni-paderborn.de>	Wed Feb 03 09:52:19 2016 +0100
committer	peusterm <manuel.peuster@uni-paderborn.de>	Wed Feb 03 09:52:19 2016 +0100
tree	2beeba5acca98e3e3f10a154fa127cf8c678472b
parent	726a45874fda781f19d1bc1c21b18ba8526e2c19 [diff]
parent	bf2e33f41b0aa5d70c4f69796e0f6f26ec175054 [diff]

Merge pull request #3 from stevenvanrossem/patch-1

Update README.md

tree: 2beeba5acca98e3e3f10a154fa127cf8c678472b

README.md

Distributed Cloud Emulator

Contributors:

Manuel Peuster manuel.peuster@upb.de

Requirements

needs the latest Dockernet to be installed in the system
the wrapper uses standard Python imports to use the Dockernet modules
Uses ZeroMQ based RPC to open a cloud-like interface that can be used by a demo CLI client
pip install import 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 an Ansible playbook.

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

1. Dockernet

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 emulator-strawman/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

TODO

DCemulator
Advanced network model
improve network management, multiple interfaces per container
API to create multiple networks (per DC?)
Add resource constraints to datacenters
Check if we can use the Mininet GUI to visualize our DCs?
(Unit tests for zerorpc API 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