X-Git-Url: https://osm.etsi.org/gitweb/?a=blobdiff_plain;f=src%2Femuvim%2Fapi%2Fsonata%2FREADME.md;h=d662f1e45c13eb4bef5fb5efc80e1d86111dbd80;hb=404f26f2896b92af8ddb1bec28edcc6813819e4d;hp=1845489b3101bb5a6b9a22302c5ba962d717ee8e;hpb=e26487ba6b33c22a1e3f5f843364df9f0efc07eb;p=osm%2Fvim-emu.git diff --git a/src/emuvim/api/sonata/README.md b/src/emuvim/api/sonata/README.md old mode 100644 new mode 100755 index 1845489..d662f1e --- a/src/emuvim/api/sonata/README.md +++ b/src/emuvim/api/sonata/README.md @@ -1,23 +1,51 @@ # SONATA dummy gatekeeper API: +## Requirements + +* uuid +* hashlib +* zipfile +* yaml +* docker-py +* flask +* flask_restful + +## Run REST API in standalone mode (without emulator): +* `python src/emuvim/api/sonata/dummygatekeeper.py` + +## Run emulator example with active SONATA dummy gatekeeper: +The example starts a small network with two data centers. + +* `sudo python src/emuvim/examples/sonata_y1_demo_topology_1.py` + ## Upload a package (*.son) file: -To upload the file `simplest-example.son` do: +To upload the file `sonata-demo-docker.son` (can be found in `son-emu/misc/`) do: -* `curl -i -X POST -F file=@simplest-example.son http://127.0.0.1:8000/api/packages/uploads` +* `curl -i -X POST -F package=@sonata-demo-docker.son http://127.0.0.1:5000/packages` To list all uploaded packages do: -* `curl http://127.0.0.1:8000/api/packages/uploads` +* `curl http://127.0.0.1:5000/packages` To instantiate (start) a service do: -* `curl ...` +* Specific service: `curl -X POST http://127.0.0.1:5000/instantiations -d "{\"service_uuid\":\"59446b64-f941-40a8-b511-effb0512c21b\"}"` +* Last uploaded service (makes manual tests easier): `curl -X POST http://127.0.0.1:5000/instantiations -d "{}"` To list all running services do: -* `curl ...` +* `curl http://127.0.0.1:5000/instantiations` + +## VNF Requirements + +A VNF container that is used with the dummy gatekeeper should specify a emulator specific entrypoint script in its Dockerfile: +* `ENV SON_EMU_CMD ./start.sh` + +This script is called by the dummy gatekeeper after a VNF was started and the chaining was done. The script can then be used to trigger the execution of individual VNF software. + +ATTENTION: The specified script must not block! ## API definition @@ -37,35 +65,49 @@ _Note: This API should converge to the API of the original GK as much as possibl