View on GitHub


Human-Readable Scenario Specification for Automated Creation of Simulations on CloudSim Plus and CloudSim

CloudSim Plus Automation: Human-Readable Scenario Specification Tool for Automated Creation of Simulations on CloudSim and CloudSim Plus Build Status Maven Central Javadocs GPL licensed

CloudSim Plus Automation is a Java command line tool based on CloudSim Plus (and some CloudReports classes) which is able to read specifications of CloudSim Plus simulation scenarios from a YAML file, a very human-readable data format. Simulation scenarios can be written inside a YAML file and CloudSim Plus Automation reads these simulation scenarios, creates and runs them on CloudSim Plus.

The tool releases researchers from writing Java code just to run simulation scenarios. This way, the attention can be focused on the problem to be solved, such as the creation of new algorithms for load balancing, new virtual machine scheduling policies, VM placement, resource provisioning, workload prediction, server consolidation, energy efficiency, cost reduction and so on.

A snippet of an YAML file used to automate the creation of CloudSim Plus simulation scenarios is presented below. Check a complete example in some files such as the CloudEnvironment1.yml.

  - !datacenter
    amount: 1
    vmAllocationPolicy: Simple
      - !host
        amount: 8
        ram: 1000000
        bw: 100000
        storage: 40000
        pes: 4
        mips: 50000
        vmScheduler: TimeShared
        ramProvisioner: Simple
        bwProvisioner: Simple
        peProvisioner: Simple
  - !customer
    amount: 4
      - !vm
        amount: 4
        size: 500
        pes: 2
        mips: 1000
        ram: 2000
        bw: 1000
        cloudletScheduler: SpaceShared
      - !cloudlet
        amount: 8
        pes: 2
        length: 1000
        fileSize: 50
        outputSize: 70
        utilizationModelCpu: Full
        utilizationModelRam: Full
        utilizationModelBw: Full
      - !cloudlet
        amount: 8
        pes: 2
        length: 2000
        fileSize: 50
        outputSize: 70
        utilizationModelCpu: Full
        utilizationModelRam: Full
        utilizationModelBw: Full

This work contributes to:

Using the command line tool

You can simply download the jar file from the latest release and run it in a terminal by issuing the following command (check the correct version number of the jar file):

java -jar cloudsim-plus-automation-4.0.0-with-dependencies.jar PathToYamlSimulationScenarioFile

Execute the tool without any parameter to see the usage help.

Using it as a maven dependency into your own project

You can build your own applications on top of CloudSim Plus Automation to automate the creation cloud computing simulations. This way, your applications will be able to read simulation scenarios from YAML files, build and execute them on CloudSim Plus. Just add CloudSim Plus Automation as a Maven dependency into your own project and start coding.

    <!-- Set a specific version or use the latest one -->

You can programmatically load a YAML file containing simulation scenarios using some code such as the example below. The complete example project is available here.

try {
    //Loads a YAML file containing 1 or more simulation scenarios.
    final YamlCloudScenarioReader reader = new YamlCloudScenarioReader("PATH TO YOUR YAML FILE");
    //Gets the list or parsed scenarios.
    final List<YamlCloudScenario> simulationScenarios = reader.getScenarios();
    //For each existing scenario, creates and runs it in CloudSim Plus, printing results.
    for (YamlCloudScenario scenario : simulationScenarios) {
        new CloudSimulation(scenario).run();
} catch (FileNotFoundException | YamlException e) {
    System.err.println("Error when trying to load the simulation scenario from the YAML file: "+e.getMessage());

Published Paper

For more information, read the paper published on the Springer Lecture Notes in Computer Science Volume 8662. Realize the paper is related to an older version of the tool, which is compatible with CloudSim 3. The YAML structure has changed since there too, making it simpler and matching the name of entries with CloudSim and CloudSim Plus classes (such as VmAllocationPolicy, VmScheduler, CloudletScheduler). See the last section for more information.

If you are using this work for publishing a paper, please cite our paper above.


If you are looking for the CloudSim Automation, which is the version compatible with CloudSim 4, it is available at cloudsim-version branch. However, that version isn’t actively maintained anymore.