Skip to content

Latest commit

 

History

History
93 lines (75 loc) · 2.88 KB

README.md

File metadata and controls

93 lines (75 loc) · 2.88 KB
Raw

Test engine for Open Container

The oct(open container testing) project aims to promote the Open Container Initiative by providing a universal testing framework for all the container projects. The testing includes: oci specs, container function and container performance.

The oct-engine provides the framework for the open container testing.

The framework architecture

Framework

  • Open Container Pool :
    The Open Container Pool provides RESTful API for user who wants to query/build/get a container image. The Open Container Pool acts as an agent to deliver requests to different container hubs.

  • Open Test Server :
    The Open Test Server provides RESTful API for user who wants to use a certain operating system on a certain architecture. The Open Test Server acts as an agent to deliver requests to different cluster or IASS platform.

  • TestCase Scheduler :
    As the main scheduler, the Test Case Scheduler will:

    1. Parse the testing request
    2. Apply hardware resources from the Open Test Server
    3. Register container images from the Open Container Pool
    4. Deploy the testing environment
    5. Run the test
    6. Collect and publish the testing report

  • Test Case Server :
    The Test Case Server provides RESTful API for user to list/get the test cases. It uses the github as the static test case database.

TestCase specification

Refers to cases/spec

Who should join

  • Container project developer
  • Operating system distributor
  • Hardware company
  • IASS provider
  • PASS provider
  • Any container user

How to involve the oct-service

  • Fork the repository on GitHub
  • Read the APIs to test each service
  • Play with the project, submit bugs, submit patches!

If any issues are encountered while using the oct-engine project, several avenues are available for support:

Issue Tracker https://github.com/huawei-openlab/oct-engine/issues
Google Groups https://groups.google.com/forum/#!forum/oci-testing

Getting Started with oct-service

OCT-engine support multiple servers, testserver will manage all the end-node machines with ocitd deployed. But We can run testserver and ocitd on a single machine with the default configuration (ip/port) to get a first impression of the OCT-engine.

git clone https://github.com/huawei-openlab/oct-engine.git
cd oct-engine/services
make
cd testserver
./testserver &
cd ../ocitd
./ocitd &
cd ../scheduler/democase
tar czvf ../democase.tar.gz *
cd ..
# choose a testcase.
./scheduler democase.tar.gz

Quick look of the testing report

The testing report will keep updating.