README.md

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 detail on how to use these plugins are given 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 parameter to do a full build:

• clean : clean the project build directory
• compile code
• 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 finish start, you can access (change IP depends on your docker setup) the component health endpoint at:

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

Swagger UI

• static
  • http://petstore.swagger.io/?url=https://raw.githubusercontent.com/sonata-nfv/tng-vnv-tee/master/src/main/resources/static/swagger.json
  • http://petstore.swagger.io/?url=https://raw.githubusercontent.com/sonata-nfv/tng-vnv-tee/master/src/main/resources/static/swagger-dependencies.json
• pre integration
  • http://172.31.6.29:6200/tng-vnv-tee/swagger-ui.html
• local
  • http://192.168.99.100:6200/tng-vnv-tee/swagger-ui.html

Contributing

Contributing to the Gatekeeper is really easy. You must:

1. Clone this repository;
2. Work on your proposed changes, preferably through submiting issues;
3. Submit a Pull Request;
4. 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)
• grade (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.

• Guo Du (mrduguo)
• Felipe Vicens (felipevicens)

Feedback-Channels

Please use the GitHub issues and the 5GTANGO Verification and Validation group mailing list [email protected] for feedback.