X-Git-Url: https://osm.etsi.org/gitweb/?p=osm%2Fvim-emu.git;a=blobdiff_plain;f=README.md;h=6d54ca5ba7256d9da4cf1f4004988d4d5b4d6697;hp=eefb97c952c4faf12d83a0c07137b801c80859a6;hb=5877ea26273aed77b51263efb19fc13b70087c25;hpb=eb477af01a8f2f164cfc756a6a9759f3dd7e9f3a diff --git a/README.md b/README.md index eefb97c..6d54ca5 100755 --- a/README.md +++ b/README.md @@ -1,37 +1,61 @@ -# Distributed Cloud Emulator - -Lead developers (able to merge pull requests): +[![Build Status](http://jenkins.sonata-nfv.eu/buildStatus/icon?job=son-emu)](http://jenkins.sonata-nfv.eu/job/son-emu) -* Manuel Peuster -* Steven Van Rossem +# Distributed Cloud Emulator +### Lead Developers +The following lead developers are responsible for this repository and have admin rights. They can, for example, merge pull requests. + +* Manuel Peuster (mpeuster) +* Steven Van Rossem (stevenvanrossem) + +### Environment +* Python 2.7 +* Latest [Containernet](https://github.com/mpeuster/containernet) installed on the system + +### Dependencies +* pyaml (public domain) +* zerorpc (MIT) +* tabulate (public domain) +* argparse (Python software foundation license) +* networkx (BSD) +* six>=1.9 (MIT) +* ryu (Apache 2.0) +* oslo.config (Apache 2.0) +* pytest (MIT) +* pytest-runner (MIT) +* Flask (BSD) +* flask_restful (BSD) +* requests (Apache 2.0) +* docker-py (Apache 2.0) +* paramiko (LGPL) + +### 3rd-party code used +* (none) -### Requirements -* needs the latest [Dockernet](https://github.com/mpeuster/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 + * **src/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 + * **dcemulator/** Containernet wrapper that introduces the notion of data centers and API endpoints + * **examples/** Example topology scripts * **test/** Unit tests - * **example_topology.py** An example topology script to show how topologies can be specified +* **ansible/** Ansible install scripts +* **util/** helper scripts ### 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 +#### 1. Containernet * `cd` -* `git clone -b dockernet-sonata https://github.com/mpeuster/dockernet.git` -* `cd ~/dockernet/ansible` +* `git clone https://github.com/mpeuster/containernet.git` +* `cd ~/containernet/ansible` * `sudo ansible-playbook install.yml` * Wait (and have a coffee) ... @@ -59,14 +83,10 @@ In the `~/son-emu` directory: * `son-emu-cli compute start -d datacenter1 -n vnf2` * `son-emu-cli compute list` * First terminal: - * `dockernet> vnf1 ping -c 2 vnf2` + * `containernet> vnf1 ping -c 2 vnf2` * Second terminal: * `son-emu-cli monitor get_rate -vnf vnf1` -#### Example scripts: - * `./start_dcnetwork` starts an example datacenter network with monitoring api endpoint - * `./start_example_chain` sets up an example service chain, using the example docker container from `package_samples` https://github.com/sonata-nfv/packaging_samples/tree/master/VNFs - ### Run Unit Tests * `cd ~/son-emu` * `sudo py.test -v src/emuvim` (equivalent to `python setup.py test -v --addopts 'src/emuvim'` but with direct access to the commandline arguments)