Simmy 使用教程

Simmy 使用教程

Simmy Simmy is a chaos-engineering and fault-injection tool, integrating with the Polly resilience project for .NET 项目地址: https://gitcode.com/gh_mirrors/si/Simmy

1. 项目介绍

Simmy 是一个针对 .NET 平台的混沌工程和故障注入工具，它与 Polly 坚韧项目集成。Polly 是一个.NET resilience and transient-fault-handling库，它提供了处理诸如网络延迟、服务暂时性故障等问题的策略。Simmy 允许开发者在执行代码的任何位置引入混沌注入策略，以测试系统的弹性。

2. 项目快速启动

在您的项目中使用 Simmy 需要以下步骤：

首先，确保您已经安装了 Polly v7.0.0 或更高版本。

然后，您可以按照以下代码示例来设置混沌策略：

// 引入Simmy的命名空间
using Polly.Contrib.Simmy;

// 创建异常注入策略
var chaosPolicy = MonkeyPolicy.InjectException(
    fault => new SocketException(errorCode: 10013),
    injectionRate: 0.05,
    enabled: true);

// 创建结果替换策略
var chaosPolicy = MonkeyPolicy.InjectResult(
    result => new HttpResponseMessage(HttpStatusCode.BadRequest),
    injectionRate: 0.05,
    enabled: true);

// 创建延时注入策略
var chaosPolicy = MonkeyPolicy.InjectLatency(
    latency: TimeSpan.FromSeconds(5),
    injectionRate: 0.1,
    enabled: true);

// 创建自定义行为注入策略
var chaosPolicy = MonkeyPolicy.InjectBehaviour(
    behaviour: () => restartRedisVM(),
    injectionRate: 0.01,
    enabledWhen: (ctx, ct) => isEnabled(ctx, ct));

最后，通过混沌策略执行您的代码：

chaosPolicy.Execute(() => someMethod());

3. 应用案例和最佳实践

• 异常注入：模拟网络错误或服务不可用的情况，确保您的应用能够优雅地处理这些异常。
• 结果替换：用于测试不同结果的处理逻辑，例如返回错误状态的 HTTP 响应。
• 延时注入：模拟网络延迟，测试应用在高延迟情况下的表现。
• 自定义行为注入：执行特定操作，如重启服务或虚拟机，以模拟更复杂的故障场景。

在实施混沌工程时，请确保：

• 混沌策略的注入比例不要过高，以免影响正常服务的运行。
• 对注入的混沌进行监控，确保能够快速回滚或禁用策略。
• 在非生产环境中进行混沌测试，以避免对生产环境造成影响。

4. 典型生态项目

Simmy 作为 Polly 项目的扩展，与 .NET 生态系统中的其他工具和库相辅相成。以下是一些与之配合良好的项目：

• Octopus Deploy：用于自动化部署和生命周期管理。
• Azure DevOps：提供 CI/CD 服务，与 Simmy 结合可以进行持续集成和持续部署的弹性测试。
• Serilog：一个强大的日志库，可用于记录混沌测试的结果和系统的响应。

通过使用这些工具和 Simmy，您可以构建一个更加健壮和弹性的.NET应用。

Simmy Simmy is a chaos-engineering and fault-injection tool, integrating with the Polly resilience project for .NET 项目地址: https://gitcode.com/gh_mirrors/si/Simmy