Test Execution Engine for 5GTANGO Verification and Validation

This is a 5GTANGO component to execute the test suites for 5G Network Services.

What it is

The TEE is responsible for the execution of individual test plans generated from the LCM. Currently it supports 3 test plugin types:

bash tester - A general bash script executor
wrk tester - A test plugin developed to report results from the WRK benchmark application
TTCN-3 tester - A test adapter designed to run TTCN-3 scripts

More details on how to use these plugins are available in the wiki

Build from source code

./gradlew

The project depends on java and docker to build. Once you have those two tools, you simply run ./gradlew command without parameters to do a full build:

clean : clean the project build directory
compile code
process resources
process resources
package jar
compile test
process test resources
execute test
execute docker build
execute docker push: optional, default to
- true on jenkins build
- false on local build

For advanced build arguments, please checkout the gradle-buildscript project.

Run the docker image

docker pull registry.sonata-nfv.eu:5000/tng-vnv-tee
docker run -d \
    --name tng-vnv-tee \
    -p 6200:6200 \
    -v /var/run/docker.sock:/var/run/docker.sock \
    -v $(which docker):/usr/bin/docker \
    -v tee:/workspace \
    -e APP_GK_HOST=172.31.6.42 \
    registry.sonata-nfv.eu:5000/tng-vnv-tee

Health Checking

Once the component has started, you can access the component health endpoint at (change IP Addresses depending on your docker setup):

http://192.168.99.100:6200/tng-vnv-tee/health

Swagger UI

Contributing

Contributing to the Gatekeeper is really easy. You must:

Clone this repository;
Work on your proposed changes, preferably through submitting issues;
Submit a Pull Request;
Follow/answer related issues (see Feedback-Channel, below).

Dependencies

No specific libraries are required for building this project. The following tools are used to build the component

java (version 8)
gradle (version 4.9)
docker (version 18.x)

License

This 5GTANGO component is published under Apache 2.0 license. Please see the LICENSE file for more details.

Lead Developers

The following lead developers are responsible for this repository and have admin rights. They can, for example, merge pull requests.

George Andreou (allemaos)
Guo Du (mrduguo)
Felipe Vicens (felipevicens)

Feedback-Channels

Please use the GitHub issues and the 5GTANGO Verification and Validation group mailing list 5gtango-dev@list.atosresearch.eu for feedback.

sonata-nfv / tng-vnv-tee

readme