# msaf9/cloudschedx architecture

> Architecture diagram of the GitHub repository msaf9/cloudschedx, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/msaf9/cloudschedx
- Repository: https://github.com/msaf9/cloudschedx

## Overview

CloudSchedX is a CloudSim-based cloud resource-allocation and simulation project. Its documented workflow assigns cloudlets to VMs at the broker’s global scheduling stage, then shares CPU time among each VM’s assigned cloudlets through local scheduling; simulation results support evaluation of resource-allocation policies. The tree also contains security and privacy examples and monitors, but the README does not describe how those modules are wired into scheduling. Relationships outside the documented workflow are therefore omitted rather than inferred from filenames.

Main entry points: [`cloudsim/modules/cloudsim/src/main/java/org/cloudbus/cloudsim/DatacenterBroker.java`](https://github.com/msaf9/cloudschedx/blob/main/cloudsim/modules/cloudsim/src/main/java/org/cloudbus/cloudsim/DatacenterBroker.java) (Cloudlet broker), [`cloudsim/modules/cloudsim/src/main/java/org/cloudbus/cloudsim/Datacenter.java`](https://github.com/msaf9/cloudschedx/blob/main/cloudsim/modules/cloudsim/src/main/java/org/cloudbus/cloudsim/Datacenter.java) (Datacenter), [`cloudsim/modules/cloudsim/src/main/java/org/cloudbus/cloudsim/CloudletScheduler.java`](https://github.com/msaf9/cloudschedx/blob/main/cloudsim/modules/cloudsim/src/main/java/org/cloudbus/cloudsim/CloudletScheduler.java) (Local schedulers), [`cloudsim/modules/cloudsim-examples/src/main/java/coms/project/secure`](https://github.com/msaf9/cloudschedx/tree/main/cloudsim/modules/cloudsim-examples/src/main/java/coms/project/secure) (Secure schedulers)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_simulation["Simulation runtime"]
  node_examples["Example simulations"]
  node_engine["Event engine<br/>[CloudSim.java]"]
  node_events["Simulation events<br/>[SimEvent.java]"]
  node_broker["Cloudlet broker"]
end

subgraph group_resources["Cloud resources"]
  node_cloudlet["Cloudlet tasks<br/>[Cloudlet.java]"]
  node_datacenter["Datacenter<br/>[Datacenter.java]"]
  node_characteristics["Datacenter profile"]
  node_host["Compute hosts<br/>[Host.java]"]
  node_vm["Virtual machines<br/>[Vm.java]"]
  node_storage[("File storage<br/>[Storage.java]")]
end

subgraph group_scheduling["Scheduling policies"]
  node_local["Local schedulers"]
  node_global["Global schedulers"]
  node_localexamples["Local examples"]
end

subgraph group_controls["Security and privacy"]
  node_secure["Secure schedulers"]
  node_security["Security attacks"]
  node_privacy["Privacy attacks"]
  node_monitors["Policy monitors"]
end

node_user(("Simulation user"))

node_user -->|"starts"| node_examples
node_examples -.->|"runs simulation"| node_engine
node_engine -.->|"global assignment"| node_broker
node_broker -->|"assigns tasks"| node_cloudlet
node_broker -->|"assigns to VM"| node_vm
node_vm -->|"uses for sharing"| node_local
node_local -->|"shares CPU time"| node_cloudlet
node_datacenter -.->|"contains compute"| node_host
node_datacenter -.->|"uses profile"| node_characteristics
node_datacenter -.->|"accesses files"| node_storage
node_global -.->|"policy variants"| node_broker
node_localexamples -.->|"policy variants"| node_local
node_secure -.->|"secure variants"| node_global
node_secure -.->|"secure variants"| node_localexamples

click node_examples "https://github.com/msaf9/cloudschedx/tree/main/cloudsim/modules/cloudsim-examples/src/main/java"
click node_engine "https://github.com/msaf9/cloudschedx/blob/main/cloudsim/modules/cloudsim/src/main/java/org/cloudbus/cloudsim/core/CloudSim.java"
click node_events "https://github.com/msaf9/cloudschedx/blob/main/cloudsim/modules/cloudsim/src/main/java/org/cloudbus/cloudsim/core/SimEvent.java"
click node_broker "https://github.com/msaf9/cloudschedx/blob/main/cloudsim/modules/cloudsim/src/main/java/org/cloudbus/cloudsim/DatacenterBroker.java"
click node_cloudlet "https://github.com/msaf9/cloudschedx/blob/main/cloudsim/modules/cloudsim/src/main/java/org/cloudbus/cloudsim/Cloudlet.java"
click node_datacenter "https://github.com/msaf9/cloudschedx/blob/main/cloudsim/modules/cloudsim/src/main/java/org/cloudbus/cloudsim/Datacenter.java"
click node_characteristics "https://github.com/msaf9/cloudschedx/blob/main/cloudsim/modules/cloudsim/src/main/java/org/cloudbus/cloudsim/DatacenterCharacteristics.java"
click node_host "https://github.com/msaf9/cloudschedx/blob/main/cloudsim/modules/cloudsim/src/main/java/org/cloudbus/cloudsim/Host.java"
click node_vm "https://github.com/msaf9/cloudschedx/blob/main/cloudsim/modules/cloudsim/src/main/java/org/cloudbus/cloudsim/Vm.java"
click node_local "https://github.com/msaf9/cloudschedx/blob/main/cloudsim/modules/cloudsim/src/main/java/org/cloudbus/cloudsim/CloudletScheduler.java"
click node_global "https://github.com/msaf9/cloudschedx/tree/main/cloudsim/modules/cloudsim-examples/src/main/java/coms/project/scheduling/global"
click node_localexamples "https://github.com/msaf9/cloudschedx/tree/main/cloudsim/modules/cloudsim-examples/src/main/java/coms/project/scheduling/local"
click node_secure "https://github.com/msaf9/cloudschedx/tree/main/cloudsim/modules/cloudsim-examples/src/main/java/coms/project/secure"
click node_security "https://github.com/msaf9/cloudschedx/blob/main/cloudsim/modules/cloudsim-examples/src/main/java/coms/project/attack/security/SecurityAttackSimulator.java"
click node_privacy "https://github.com/msaf9/cloudschedx/blob/main/cloudsim/modules/cloudsim-examples/src/main/java/coms/project/attack/privacy/PrivacyAttackSimulator.java"
click node_monitors "https://github.com/msaf9/cloudschedx/tree/main/cloudsim/modules/cloudsim-examples/src/main/java/coms/project/monitor"
click node_storage "https://github.com/msaf9/cloudschedx/blob/main/cloudsim/modules/cloudsim/src/main/java/org/cloudbus/cloudsim/Storage.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_examples,node_engine,node_events,node_broker,node_user toneBlue
class node_cloudlet,node_datacenter,node_characteristics,node_host,node_vm,node_storage toneAmber
class node_local,node_global,node_localexamples toneMint
class node_secure,node_security,node_privacy,node_monitors toneRose
```

## Components

### Simulation runtime

- [Example simulations](https://github.com/msaf9/cloudschedx/tree/main/cloudsim/modules/cloudsim-examples/src/main/java): `cloudsim/modules/cloudsim-examples/src/main/java`
- [Event engine](https://github.com/msaf9/cloudschedx/blob/main/cloudsim/modules/cloudsim/src/main/java/org/cloudbus/cloudsim/core/CloudSim.java): `cloudsim/modules/cloudsim/src/main/java/org/cloudbus/cloudsim/core/CloudSim.java`
- [Simulation events](https://github.com/msaf9/cloudschedx/blob/main/cloudsim/modules/cloudsim/src/main/java/org/cloudbus/cloudsim/core/SimEvent.java): `cloudsim/modules/cloudsim/src/main/java/org/cloudbus/cloudsim/core/SimEvent.java`
- [Cloudlet broker](https://github.com/msaf9/cloudschedx/blob/main/cloudsim/modules/cloudsim/src/main/java/org/cloudbus/cloudsim/DatacenterBroker.java): `cloudsim/modules/cloudsim/src/main/java/org/cloudbus/cloudsim/DatacenterBroker.java`

### Cloud resources

- [Cloudlet tasks](https://github.com/msaf9/cloudschedx/blob/main/cloudsim/modules/cloudsim/src/main/java/org/cloudbus/cloudsim/Cloudlet.java): `cloudsim/modules/cloudsim/src/main/java/org/cloudbus/cloudsim/Cloudlet.java`
- [Datacenter](https://github.com/msaf9/cloudschedx/blob/main/cloudsim/modules/cloudsim/src/main/java/org/cloudbus/cloudsim/Datacenter.java): `cloudsim/modules/cloudsim/src/main/java/org/cloudbus/cloudsim/Datacenter.java`
- [Datacenter profile](https://github.com/msaf9/cloudschedx/blob/main/cloudsim/modules/cloudsim/src/main/java/org/cloudbus/cloudsim/DatacenterCharacteristics.java): `cloudsim/modules/cloudsim/src/main/java/org/cloudbus/cloudsim/DatacenterCharacteristics.java`
- [Compute hosts](https://github.com/msaf9/cloudschedx/blob/main/cloudsim/modules/cloudsim/src/main/java/org/cloudbus/cloudsim/Host.java): `cloudsim/modules/cloudsim/src/main/java/org/cloudbus/cloudsim/Host.java`
- [Virtual machines](https://github.com/msaf9/cloudschedx/blob/main/cloudsim/modules/cloudsim/src/main/java/org/cloudbus/cloudsim/Vm.java): `cloudsim/modules/cloudsim/src/main/java/org/cloudbus/cloudsim/Vm.java`
- [File storage](https://github.com/msaf9/cloudschedx/blob/main/cloudsim/modules/cloudsim/src/main/java/org/cloudbus/cloudsim/Storage.java): `cloudsim/modules/cloudsim/src/main/java/org/cloudbus/cloudsim/Storage.java`

### Scheduling policies

- [Local schedulers](https://github.com/msaf9/cloudschedx/blob/main/cloudsim/modules/cloudsim/src/main/java/org/cloudbus/cloudsim/CloudletScheduler.java): `cloudsim/modules/cloudsim/src/main/java/org/cloudbus/cloudsim/CloudletScheduler.java`
- [Global schedulers](https://github.com/msaf9/cloudschedx/tree/main/cloudsim/modules/cloudsim-examples/src/main/java/coms/project/scheduling/global): `cloudsim/modules/cloudsim-examples/src/main/java/coms/project/scheduling/global`
- [Local examples](https://github.com/msaf9/cloudschedx/tree/main/cloudsim/modules/cloudsim-examples/src/main/java/coms/project/scheduling/local): `cloudsim/modules/cloudsim-examples/src/main/java/coms/project/scheduling/local`

### Security and privacy

- [Secure schedulers](https://github.com/msaf9/cloudschedx/tree/main/cloudsim/modules/cloudsim-examples/src/main/java/coms/project/secure): `cloudsim/modules/cloudsim-examples/src/main/java/coms/project/secure`
- [Security attacks](https://github.com/msaf9/cloudschedx/blob/main/cloudsim/modules/cloudsim-examples/src/main/java/coms/project/attack/security/SecurityAttackSimulator.java): `cloudsim/modules/cloudsim-examples/src/main/java/coms/project/attack/security/SecurityAttackSimulator.java`
- [Privacy attacks](https://github.com/msaf9/cloudschedx/blob/main/cloudsim/modules/cloudsim-examples/src/main/java/coms/project/attack/privacy/PrivacyAttackSimulator.java): `cloudsim/modules/cloudsim-examples/src/main/java/coms/project/attack/privacy/PrivacyAttackSimulator.java`
- [Policy monitors](https://github.com/msaf9/cloudschedx/tree/main/cloudsim/modules/cloudsim-examples/src/main/java/coms/project/monitor): `cloudsim/modules/cloudsim-examples/src/main/java/coms/project/monitor`

### Other components

- **Simulation user**

## Connections

- Simulation user → Example simulations: starts (evidence: `README.md`)
- Example simulations → Event engine: runs simulation (evidence: `cloudsim/modules/cloudsim-examples/src/main/java/coms/project/secure/CloudSimGASecure.java`)
- Event engine → Cloudlet broker: global assignment (evidence: `cloudsim/modules/cloudsim/src/main/java/org/cloudbus/cloudsim/DatacenterBroker.java`)
- Cloudlet broker → Cloudlet tasks: assigns tasks (evidence: `README.md`)
- Cloudlet broker → Virtual machines: assigns to VM (evidence: `README.md`)
- Virtual machines → Local schedulers: uses for sharing (evidence: `README.md`)
- Local schedulers → Cloudlet tasks: shares CPU time (evidence: `README.md`)
- Datacenter → Compute hosts: contains compute (evidence: `cloudsim/modules/cloudsim/src/main/java/org/cloudbus/cloudsim/Datacenter.java`)
- Datacenter → Datacenter profile: uses profile (evidence: `cloudsim/modules/cloudsim/src/main/java/org/cloudbus/cloudsim/Datacenter.java`)
- Datacenter → File storage: accesses files (evidence: `cloudsim/modules/cloudsim/src/main/java/org/cloudbus/cloudsim/Datacenter.java`)
- Global schedulers → Cloudlet broker: policy variants (evidence: `cloudsim/modules/cloudsim-examples/src/main/java/coms/project/scheduling/global/CloudSimWOA.java`)
- Local examples → Local schedulers: policy variants
- Secure schedulers → Global schedulers: secure variants
- Secure schedulers → Local examples: secure variants
