Elastest Orchestration Engine
The ElasTest Orchestration Engine (EOE) is the component responsible of implementing the concept of orchestration within Elastest, understood as a novel way to select, order, and execute a group of TJobs. To that aim, we have leveraged the pipelines Jenkins notation for the topology generation by means of a Jenkins shared library. This library exposes a simple API to orchestrate testing jobs. The orchestrator library API is summarized in the following table:
||Method to run a job given its identifier (jobId).This method returns a boolean value:
||Method allows to run one job given a boolean value (typically a verdict from another job). This boolean value is passes in the first argument (called verdict in the method signature). If this value job with identifier
||This method allows to run a set of jobs in parallel. The jobs identifier are passes using a variable number of arguments (varargs)|
Moreover, the exit condition for the orchestrated job can be also configured:
||The orchestration finishes at the end (option by default)|
||The orchestration finishes when any of the TJobs fail|
||The orchestration finishes when any a set of parallel TJobs fail|
Finally, the verdict of a group of parallel jobs can be also configured:
||The verdict of a set of jobs executed in parallel is
||The verdict of parallel jobs is
||If a SuT instrumented By ElasTest through EIM is used, one or more packet loss values can be set. If more than one is specified, the job will be run as many times as there are values.||setPacketLoss(['0.01', '0.02'])|
||If a SuT instrumented By ElasTest through EIM is used, one or more cpu burst (stress) values can be set. If more than one is specified, the job will be run as many times as there are values.||setCpuBurst(['0.2'])|
||Allows to check if an execution lasts less (LessThan) or more (GreaterThan) than the indicated time (In milliseconds, seconds, minutes, etc.).||checkTime(Compare.LessThan, 60, TimeUnit.SECONDS)|
At the moment, only packet loss and cpu burst can be set separately, so the two cannot be set at the same time.
How to install
- Navigate to Manage Jenkins in your Jenkins.
- Click to System Configuration
- Add new library in Global Pipeline Libraries with name OrchestrationLib and default version master
- Select Modern SCM
- Select GitHub
- Owner: elastest
- Repository: elastest-orchestration-engine
- Save changes
What is ElasTest
This repository is part of ElasTest, which is a flexible open source testing platform aimed to simplify the end-to-end testing processes for different types of applications, including web and mobile, among others.
The objective of ElasTest is to provide advance testing capabilities aimed to increase the scalability, robustness, security and quality of experience of large distributed systems. All in all, ElasTest will make any software development team capable of delivering software faster and with fewer defects.
The ElasTest project provides detailed documentation including tutorials, installation and development guide.
Source code for other ElasTest projects can be found in the GitHub ElasTest Group.
Issues and bug reports should be posted to the GitHub ElasTest Bugtracker.
Licensing and distribution
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
You can contribute to the ElasTest community through bug-reports, bug-fixes, new code or new documentation. For contributing to the ElasTest community, you can use GitHub, providing full information about your contribution and its value. In your contributions, you must comply with the following guidelines
- You must specify the specific contents of your contribution either through a detailed bug description, through a pull-request or through a patch.
- You must specify the licensing restrictions of the code you contribute.
- For newly created code to be incorporated in the ElasTest code-base, you must accept ElasTest to own the code copyright, so that its open source nature is guaranteed.
- You must justify appropriately the need and value of your contribution. The ElasTest project has no obligations in relation to accepting contributions from third parties.
- The ElasTest project leaders have the right of asking for further explanations, tests or validations of any code contributed to the community before it being incorporated into the ElasTest code-base. You must be ready to addressing all these kind of concerns before having your code approved.