Namazu: 分布式系统模糊调度器安装与使用指南

Namazu: 分布式系统模糊调度器安装与使用指南

namazu :fish: 鯰: Programmable fuzzy scheduler for testing distributed systems 项目地址: https://gitcode.com/gh_mirrors/na/namazu

1. 目录结构及介绍

Namazu 是一个用于测试分布式系统（如 ZooKeeper）的可编程模糊调度器，它通过在不同场景下随机排列Java函数调用、以太网数据包、文件系统事件以及注入的错误等，来寻找实现层面的软件缺陷。下面简要描述其主要目录结构：

• doc: 文档相关资料。
• example: 包含示例代码和应用案例。
• misc: 杂项工具或辅助文件。
• nmz: 核心代码和模块所在目录。
• vendor: 外部依赖库或组件。
• .gitignore, .gitmodules: 版本控制相关的配置文件。
• travis.yml: Travis CI 的构建脚本。
• LICENSE: 许可证文件，采用Apache-2.0协议。
• README.md: 项目的主要读我文件，包含项目简介和快速入门信息。

2. 项目的启动文件介绍

Namazu 不直接提供一个单一的“启动文件”去执行整个框架，而是通过命令行接口(go get github.com/osrg/namazu/nmz)获取后，利用Go编写的命令行工具进行操作。例如，启动Namazu容器或者单独运行其各种inspectors（如process inspector、filesystem inspector、ethernet inspector），具体命令行使用需参考其文档说明或直接在终端执行相应的nmz命令加上适合的参数。

3. 项目的配置文件介绍

Namazu支持自定义配置文件，通常以.toml扩展名存储，如 config.toml。这个配置文件允许用户定制探索策略、事件延迟时间间隔、故障注入概率等关键行为，使测试更加灵活高效。

示例配置文件结构

• explorePolicy: 规定事件观察及动作产生政策，默认为"random"，但可自定义实现更复杂的策略。

• [explorePolicyParam]:

  • minInterval 和 maxInterval: 事件非确定性延迟的上下界，默认分别为0毫秒和0毫秒。
  • faultActionProbability: 故障注入的概率，范围0.0到1.0，默认为0.0。

• [container]: 当以容器模式运行时的相关配置，如是否启用特定的inspector，相关参数设置等。

配置文件允许用户调整非线性测试的行为，比如通过调整procPolicy来改变进程的调度策略，或是通过设置enableEthernetInspector来开启网络层的模糊测试功能。

要运用配置文件，可以在相应命令后添加-autopilot config.toml来指定配置文件路径，实现对Namazu行为的精确控制。

请注意，实际使用中应详细阅读Namazu的官方文档，特别是config.go和相关Inspector的文档部分，因为它们提供了更多可配置参数和详细的使用说明。

namazu :fish: 鯰: Programmable fuzzy scheduler for testing distributed systems 项目地址: https://gitcode.com/gh_mirrors/na/namazu