X-Git-Url: https://osm.etsi.org/gitweb/?a=blobdiff_plain;f=src%2Femuvim%2Fapi%2Fsonata%2FREADME.md;h=d662f1e45c13eb4bef5fb5efc80e1d86111dbd80;hb=404f26f2896b92af8ddb1bec28edcc6813819e4d;hp=b8679653b27624059ddedd3c077c9509e09e3c86;hpb=64b4550b56d1d20627e0c5f715449c665ec79c84;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 b867965..d662f1e --- a/src/emuvim/api/sonata/README.md +++ b/src/emuvim/api/sonata/README.md @@ -1,24 +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 `sonata-demo.son` (from son-schema repo) do: +To upload the file `sonata-demo-docker.son` (can be found in `son-emu/misc/`) do: -* `curl -i -X POST -F file=@sonata-demo.son http://127.0.0.1:8000/api/packages` +* `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` +* `curl http://127.0.0.1:5000/packages` To instantiate (start) a service do: -* Specific service: `curl -X POST http://127.0.0.1:8000/api/instantiations -d "{\"service_uuid\":\"59446b64-f941-40a8-b511-effb0512c21b\"}"` -* Last uploaded service (makes manual tests easier): `curl -X POST http://127.0.0.1:8000/api/instantiations -d "{}"` +* 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 http://127.0.0.1:8000/api/instantiations` +* `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 @@ -38,28 +65,28 @@ _Note: This API should converge to the API of the original GK as much as possibl