CloudSimPy 项目教程

1. 项目目录结构及介绍

CloudSimPy 项目的目录结构如下：

CloudSimPy/
├── core/
│   ├── config/
│   ├── job/
│   ├── machine/
│   ├── cluster/
│   ├── algorithm/
│   ├── scheduler/
│   ├── broker/
│   ├── monitor/
│   └── simulation/
├── playground/
│   ├── DAG/
│   ├── Non_DAG/
│   └── auxiliary/
├── README.en.md
├── README.md
└── LICENSE

目录介绍

• core/: 核心包，包含数据中心作业调度问题中的各个实体的抽象和建模。

  • config/: 包含任务实例、任务、作业的配置文件。
  • job/: 包含任务实例、任务、作业的建模。
  • machine/: 包含机器的建模。
  • cluster/: 包含计算集群的建模。
  • algorithm/: 定义调度算法的接口。
  • scheduler/: 包含调度器的建模。
  • broker/: 包含代理的实现，用于提交作业。
  • monitor/: 包含监测器的实现，用于监测仿真状态。
  • simulation/: 包含仿真的建模。

• playground/: 用于方便用户进行试验的包。

  • DAG/: 支持考虑任务间依赖关系情况下的仿真实验。
  • Non_DAG/: 支持不考虑任务间依赖关系情况下的仿真实验。
  • auxiliary/: 包含一些辅助类和函数。

• README.en.md: 英文版的项目介绍文档。

• README.md: 中文版的项目介绍文档。

• LICENSE: 项目的开源许可证文件。

2. 项目的启动文件介绍

CloudSimPy 项目的启动文件通常位于 playground/ 目录下。具体来说，启动文件可能位于 playground/Non_DAG/launch_scripts/ 或 playground/DAG/launch_scripts/ 目录中。

示例启动文件

以 playground/Non_DAG/launch_scripts/main-makespan.py 为例：

# main-makespan.py
import sys
import os
sys.path.append(os.path.abspath('../../..'))

from playground.Non_DAG.algorithm.DeepJS.DRL import DRLAlgorithm
from core.simulation import Simulation
from core.broker import Broker
from core.scheduler import Scheduler
from core.monitor import Monitor

# 创建仿真对象
simulation = Simulation()

# 创建集群、调度器、代理和监测器
cluster = simulation.create_cluster()
scheduler = Scheduler(cluster)
broker = Broker(cluster)
monitor = Monitor(simulation)

# 运行仿真
simulation.run()

启动文件功能

• 导入模块: 导入所需的模块和类。
• 创建仿真对象: 创建 Simulation 对象，用于管理整个仿真过程。
• 创建集群、调度器、代理和监测器: 分别创建 Cluster、Scheduler、Broker 和 Monitor 对象。
• 运行仿真: 调用 simulation.run() 方法启动仿真。

3. 项目的配置文件介绍

CloudSimPy 项目的配置文件主要位于 core/config/ 目录下，用于定义任务实例、任务、作业的配置。

示例配置文件

以 core/config/TaskInstanceConfig.py 为例：

# TaskInstanceConfig.py
class TaskInstanceConfig:
    def __init__(self, cpu, memory, duration):
        self.cpu = cpu
        self.memory = memory
        self.duration = duration

配置文件功能

• 定义资源需求: 配置文件中定义了任务实例所需的 CPU、内存和持续时间等资源需求。
• 初始化配置: 通过构造函数初始化任务实例的配置。

通过这些配置文件，用户可以自定义任务实例、任务和作业的资源需求，从而进行不同场景的仿真实验。