X-Git-Url: https://gerrit.o-ran-sc.org/r/gitweb?a=blobdiff_plain;f=test%2Fcr%2FREADME.md;h=b8c4ad171d6d691efeb1bffc65e4ba3b2c143a3a;hb=0fd1a064d5c81207fd1be8665577787281b6a8fd;hp=251f0b314061e2f6206d56b718a1e4058a2cb6db;hpb=113bf0910498992f20a6cb70f2bc70d4d5b204ca;p=nonrtric.git diff --git a/test/cr/README.md b/test/cr/README.md index 251f0b31..b8c4ad17 100644 --- a/test/cr/README.md +++ b/test/cr/README.md @@ -2,7 +2,7 @@ The callback receiver is intended for function tests to simulate a RAPP. The callback receiver exposes the read and write urls, used by the agent, as configured in service. -The callback receiver receives notifications from PMS when synchronization happens between PMS and RICs. +The callback receiver receives notifications from PMS when synchronization happens between PMS and RICs. However, the callback receiver can be uses to receive any json payload from any source. # Ports and certificates @@ -24,23 +24,39 @@ The following REST operations are available: >Send a message to CR
This method puts a request message from PMS to notify that sychronization between PMS and certain RIC happens.
-```URI and payload, (PUT or POST): /callbacks/ ```

+```URI and payload, (PUT or POST): /callbacks/ ```
```response: OK 200 or 500 for other errors``` +>Fetch one message for an id from CR
+This method fetches the oldes message for an id, and removes the message.
+```URI and payload, (GET): /get-event/```
+```response: 200 or 500 for other errors``` + +>Fetch all messages for an id from CR
+This method fetches all message in an array for an id, and removes all messages.
+```URI and payload, (GET): /get-all-events/```
+```response: 200 or 500 for other errors``` + +>Dump all currently wating callback messages in CR
+This method fetches all message in an array for an id. Messages are left intact in the CR.
+```URI and payload, (GET): /db```
+```response: 200``` + >Metrics - counters
There are a number of counters that can be read to monitor the message processing. Do a http GET on any of the current counters and an integer value will be returned with http response code 200. ```/counter/received_callbacks``` - The total number of received callbacks
```/counter/fetched_callbacks``` - The total number of fetched callbacks
```/counter/current_messages``` - The current number of callback messages waiting to be fetched
+All counters also support the query parameter "id" to fetch counter for one individual id, eg ```/counter/current_messages?id=my-id``` ### Build and start ### >Build image
-```docker build -t callback-receiver .``` +```docker build --build-arg NEXUS_PROXY_REPO=nexus3.onap.org:10001/ -t callback-receiver .``` >Start the image on both http and https
-```docker run -it -p 8090:8090 -p 8091:8091 callback-receiver``` +```docker run --rm -it -p 8090:8090 -p 8091:8091 callback-receiver``` It will listen to http 8090 port and https 8091 port(using default certificates) at the same time. @@ -53,16 +69,16 @@ file "pass" stores the password when you run the shell script This certificates/key can be overriden by mounting a volume when using "docker run" or "docker-compose" In 'docker run', use field: --volume "$PWD/certificate:/usr/src/app/cert" a1test -```docker run -it -p 8090:8090 -p 8091:8091 -v "/PATH_TO_CERT/cert:/usr/src/app/cert" callback-receiver``` +```docker run --rm -it -p 8090:8090 -p 8091:8091 -v "/PATH_TO_CERT/cert:/usr/src/app/cert" callback-receiver``` In 'docker-compose.yml', use field: volumes: - ./certificate:/usr/src/app/cert:ro -The script ```crstub-build-start.sh``` do the above two steps in one go. This starts the callback-receiver container in stand-alone mode for basic test.
If the callback-receiver should be executed manually with the agent, replace docker run with this command to connect to the docker network with the correct service name (--name shall be aligned with the other components, i.e. the host named given in all callback urls). -```docker run -it -p 8090:8090 -p 8091:8091 --network nonrtric-docker-net --name callback-receiver callback-receiver``` +The script ```cr-build-start.sh``` do the above two steps in one go. This starts the callback-receiver container in stand-alone mode for basic test.
If the callback-receiver should be executed manually with the agent, replace docker run with this command to connect to the docker network with the correct service name (--name shall be aligned with the other components, i.e. the host named given in all callback urls). +```docker run --rm -it -p 8090:8090 -p 8091:8091 --network nonrtric-docker-net --name callback-receiver callback-receiver``` >Start the image on http only
-```docker run -it -p 8090:8090 callback-receiver``` +```docker run --rm -it -p 8090:8090 callback-receiver``` ### Basic test ###