AWSSSMChaosRunner 开源项目教程

AWSSSMChaosRunner 开源项目教程

awsssmchaosrunner Amazon's light-weight library for chaos engineering on AWS. It can be used for EC2 and ECS (with EC2 launch type). 项目地址: https://gitcode.com/gh_mirrors/aw/awsssmchaosrunner

1. 项目介绍

AWSSSMChaosRunner 是 Amazon 开发的一个轻量级库，用于在 AWS 上进行混沌工程。它主要用于 EC2 和 ECS（使用 EC2 启动类型）实例的故障注入测试。通过这个库，开发者可以简化故障注入测试和混沌工程的实施过程。AWSSSMChaosRunner 提供了多种故障注入选项，包括 AWS Systems Manager SendCommand 和 AWS Fault Injection Simulator。

2. 项目快速启动

2.1 环境准备

在开始之前，确保你已经安装了以下工具和依赖：

• Java 开发环境
• Maven 构建工具
• AWS CLI 配置了访问权限

2.2 添加 Maven 依赖

在你的项目 pom.xml 文件中添加 AWSSSMChaosRunner 依赖：

<dependency>
    <groupId>software.amazon.awsssmchaosrunner</groupId>
    <artifactId>awsssmchaosrunner</artifactId>
    <version>1.3.0</version>
</dependency>

2.3 初始化 SSM 客户端

使用 Kotlin 代码初始化 SSM 客户端：

@Bean
open fun awsSecurityTokenService(
    credentialsProvider: AWSCredentialsProvider,
    awsRegion: String
): AWSSecurityTokenService {
    return AWSSecurityTokenServiceClientBuilder.standard()
        .withCredentials(credentialsProvider)
        .withRegion(awsRegion)
        .build()
}

@Bean
open fun awsSimpleSystemsManagement(
    securityTokenService: AWSSecurityTokenService,
    awsAccountId: String,
    chaosRunnerRoleName: String
): AWSSimpleSystemsManagement {
    val chaosRunnerRoleArn = "arn:aws:iam::$awsAccountId:role/$chaosRunnerRoleName"
    val credentialsProvider = STSAssumeRoleSessionCredentialsProvider.Builder(chaosRunnerRoleArn, "ChaosRunnerSession")
        .withStsClient(securityTokenService)
        .build()
    return AWSSimpleSystemsManagementClientBuilder.standard()
        .withCredentials(credentialsProvider)
        .build()
}

2.4 启动故障注入

在测试开始前启动故障注入，测试结束后停止故障注入：

import software.amazon.awsssmchaosrunner.attacks.SSMAttack
import software.amazon.awsssmchaosrunner.attacks.SSMAttack.Companion.getAttack

@Before
override fun initialise(args: Array<String>) {
    if (shouldExecuteChaosRunner()) {
        ssm = applicationContext.getBean(AWSSimpleSystemsManagement::class.java)
        ssmAttack = getAttack(ssm, attackConfiguration)
        command = ssmAttack.start()
    }
}

@After
override fun destroy() {
    ssmAttack.stop(command)
}

3. 应用案例和最佳实践

3.1 应用案例

AWSSSMChaosRunner 可以用于测试服务的弹性，特别是在面对网络延迟、内存泄漏、CPU 过载等故障时。例如，Prime Video 使用 AWSSSMChaosRunner 来测试其服务的弹性，确保在面对各种故障时仍能提供稳定的服务。

3.2 最佳实践

• 权限配置：确保 IAM 角色和用户具有足够的权限来执行 SSM 命令和故障注入操作。
• 故障注入策略：根据实际需求选择合适的故障注入策略，如网络延迟、内存泄漏等。
• 监控和日志：在故障注入过程中，确保有足够的监控和日志记录，以便分析故障注入的效果和服务的响应。

4. 典型生态项目

4.1 AWS Systems Manager

AWS Systems Manager 是 AWSSSMChaosRunner 的核心依赖，用于远程执行命令和管理 EC2 和 ECS 实例。

4.2 AWS Fault Injection Simulator (FIS)

AWS FIS 是另一个与 AWSSSMChaosRunner 相关的服务，用于在生产环境中进行故障注入测试。AWSSSMChaosRunner 可以与 FIS 结合使用，提供更全面的故障注入能力。

4.3 Chaos Toolkit

Chaos Toolkit 是一个开源的混沌工程工具包，可以与 AWSSSMChaosRunner 结合使用，提供更灵活的故障注入和测试能力。

通过以上模块的介绍，你可以快速上手 AWSSSMChaosRunner，并了解其在实际应用中的使用方法和最佳实践。

awsssmchaosrunner Amazon's light-weight library for chaos engineering on AWS. It can be used for EC2 and ECS (with EC2 launch type). 项目地址: https://gitcode.com/gh_mirrors/aw/awsssmchaosrunner