X-Git-Url: https://osm.etsi.org/gitweb/?a=blobdiff_plain;f=src%2Femuvim%2Fapi%2Fsonata%2FREADME.md;h=d662f1e45c13eb4bef5fb5efc80e1d86111dbd80;hb=ca88566fc038a5a59c8ca3d3af82aab8db7d253a;hp=5fc1be0721bb5cea275e5ee14c62132852cbb1c4;hpb=644b319afbe785ecf05cad40dcbc118d57204c2d;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 5fc1be0..d662f1e --- a/src/emuvim/api/sonata/README.md +++ b/src/emuvim/api/sonata/README.md @@ -20,23 +20,32 @@ The example starts a small network with two data centers. ## 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 @@ -56,28 +65,28 @@ _Note: This API should converge to the API of the original GK as much as possibl Response: -/api/packages +/packages POST - -{file-content} as enctype=multipart/form-data +{file-content} as "content-type": "multipart/form-data" {"service_uuid": "c880aaab-f3b9-43ac-ac6b-3d27b46146b7", size=456, sha1=49ee6468dfa4ecbad440d669b249d523a38651be, error: null} -/api/packages +/packages GET - {service_uuid_list: ["c880aaab-f3b9-43ac-ac6b-3d27b46146b7", "c880aaab-f3b9-43ac-ac6b-3d27b46146b8", "c880aaab-f3b9-43ac-ac6b-3d27b46146b9"]} -/api/instantiations +/instantiations POST - {service_uuid: "c880aaab-f3b9-43ac-ac6b-3d27b46146b7"} {service_instance_uuid: "de4567-f3b9-43ac-ac6b-3d27b461123"} -/api/instantiations +/instantiations GET -