X-Git-Url: https://osm.etsi.org/gitweb/?a=blobdiff_plain;f=README.md;h=32a465230f7762548f7bc03f4247fec3a367e820;hb=827905b867236ee8aaa3c1e84ea6958b636f0da4;hp=68e50877f62e575e7a1740a91c13c863dbb90fd5;hpb=db9c0ca298abdcf458303821c1f5035b636bce1e;p=osm%2Fvim-emu.git diff --git a/README.md b/README.md index 68e5087..32a4652 100755 --- a/README.md +++ b/README.md @@ -1,27 +1,47 @@ +[![Build Status](http://jenkins.sonata-nfv.eu/buildStatus/icon?job=son-emu)](http://jenkins.sonata-nfv.eu/job/son-emu) + # Distributed Cloud Emulator -Contributors: +## Lead Developers +The following lead developers are responsible for this repository and have admin rights. They can, for example, merge pull requests. + -* Manuel Peuster +* Manuel Peuster (mpeuster) +* Steven Van Rossem (stevenvanrossem) -### Requirements +### Dependencies * 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) +* pyaml +* zerorpc +* tabulate +* argparse +* networkx +* six>=1.9 +* ryu +* oslo.config +* pytest +* pytest-runner +* Flask +* flask_restful +* requests +* docker-py + ### 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 + * **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` @@ -51,7 +71,8 @@ In the `~/son-emu` directory: * Otherwise, for a classic installation: * `python setup.py install` * First terminal: - * `sudo python src/emuvim/example_topology.py` + * `sudo python src/emuvim/examples/simple_topology.py +` * Second terminal: * `son-emu-cli compute start -d datacenter1 -n vnf1` * `son-emu-cli compute start -d datacenter1 -n vnf2` @@ -61,10 +82,6 @@ In the `~/son-emu` directory: * 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)