ghcr.io/chaosblade-io/chaosblade-tool-arm64:1.8.0

Chaosblade：一款简单易用且功能强大的混沌工程工具集

中文版 README
Wiki: DeepWiki

🔥🔥🔥 重大更新：Chaosblade 智能代理发布 - Blade AI

Blade AI 作为 ChaosBlade 生态系统中的智能代理层：在基础层面，它调用 ChaosBlade 执行故障注入；在上层，它集成了意图理解、安全审计、效果验证、安全恢复和结构化报告等编排能力——从而将故障演练从“手动编写命令”的过程转变为通过“对话交互”完成的过程。

详细信息请参考：https://github.com/chaosblade-io/chaosblade/blob/feature/blade-ai/blade-ai/README_en.md

• 发布版本：https://github.com/chaosblade-io/chaosblade/releases/tag/blade-ai-v0.1.0
• 代码分支：blade-ai-v0.1.0

简介

ChaosBlade 是阿里巴巴开源的实验注入工具，遵循混沌工程原则和混沌实验模型，帮助企业在上云或向云原生系统迁移过程中提高分布式系统的容错能力，保障业务连续性。

ChaosBlade 是 MonkeyKing 的内部开源项目，基于阿里巴巴近十年的故障测试与演练实践，并融合了集团各业务的最佳思想和实践。

ChaosBlade 不仅简单易用，还支持丰富的实验场景。场景包括：

• 基础资源：如 CPU、内存、网络、磁盘、进程等实验场景；
• Java 应用：如数据库、缓存、消息、JVM 本身、微服务等。还可以指定任意类方法注入各种复杂实验场景；
• C++ 应用：如指定任意方法或代码行注入延迟、篡改变量和返回值等实验场景；
• 容器：如杀死容器、容器内 CPU、内存、网络、磁盘、进程等实验场景；
• 云原生平台：例如 Kubernetes 平台节点上的 CPU、内存、网络、磁盘、进程实验场景，Pod 网络和 Pod 自身（如杀死 Pod）实验场景，以及前述 Docker 容器实验场景等容器实验场景；

按领域将场景封装为独立项目，不仅可以规范领域内的场景，还便于场景的横向和纵向扩展。通过遵循混沌实验模型，可统一调用 chaosblade cli。目前包含的项目有：

• https://github.com/chaosblade-io/chaosblade%EF%BC%9A%E6%B7%B7%E6%B2%8C%E5%AE%9E%E9%AA%8C%E7%AE%A1%E7%90%86%E5%B7%A5%E5%85%B7%EF%BC%8C%E5%8C%85%E6%8B%AC%E5%88%9B%E5%BB%BA%E5%AE%9E%E9%AA%8C%E3%80%81%E9%94%80%E6%AF%81%E5%AE%9E%E9%AA%8C%E3%80%81%E6%9F%A5%E8%AF%A2%E5%AE%9E%E9%AA%8C%E3%80%81%E5%87%86%E5%A4%87%E5%AE%9E%E9%AA%8C%E7%8E%AF%E5%A2%83%E5%92%8C%E5%8F%96%E6%B6%88%E5%AE%9E%E9%AA%8C%E7%8E%AF%E5%A2%83%E7%AD%89%E5%91%BD%E4%BB%A4%E3%80%82%E5%AE%83%E6%98%AF%E6%B7%B7%E6%B2%8C%E5%AE%9E%E9%AA%8C%E7%9A%84%E6%89%A7%E8%A1%8C%E5%B7%A5%E5%85%B7%EF%BC%8C%E6%89%A7%E8%A1%8C%E6%96%B9%E5%BC%8F%E5%8C%85%E6%8B%AC CLI 和 HTTP。提供完整的命令、实验场景及场景参数说明，操作简单清晰。
• https://github.com/chaosblade-io/chaosblade-spec-go%EF%BC%9A%E6%B7%B7%E6%B2%8C%E5%AE%9E%E9%AA%8C%E6%A8%A1%E5%9E%8B%E7%9A%84 Golang 语言定义，使用 Golang 语言实现的场景可基于此规范轻松实现。
• https://github.com/chaosblade-io/chaosblade-exec-os%EF%BC%9A%E5%9F%BA%E7%A1%80%E8%B5%84%E6%BA%90%E5%AE%9E%E9%AA%8C%E5%9C%BA%E6%99%AF%E7%9A%84%E5%AE%9E%E7%8E%B0%E3%80%82
• https://github.com/chaosblade-io/chaosblade-exec-docker%EF%BC%9ADocker 容器实验场景实现，通过调用 Docker API 进行标准化。
• https://github.com/chaosblade-io/chaosblade-exec-cri%EF%BC%9A%E5%AE%B9%E5%99%A8%E5%AE%9E%E9%AA%8C%E5%9C%BA%E6%99%AF%E5%AE%9E%E7%8E%B0%EF%BC%8C%E9%80%9A%E8%BF%87%E8%B0%83%E7%94%A8 CRI 进行标准化。
• https://github.com/chaosblade-io/chaosblade-operator%EF%BC%9AKubernetes 平台实验场景实现，通过 Kubernetes 标准 CRD 方式定义混沌实验，使用 Kubernetes 资源操作方式（包括 kubectl、client-go 等）创建、更新和删除实验场景非常便捷，也可使用前述 chaosblade cli 工具。
• https://github.com/chaosblade-io/chaosblade-exec-jvm%EF%BC%9AJava 应用实验场景实现，采用 Java Agent 技术动态挂载，无需任何接入，零成本使用，同时支持卸载并完全回收 Agent 创建的各种资源。
• https://github.com/chaosblade-io/chaosblade-exec-cplus%EF%BC%9AC++ 应用实验场景实现，采用 GDB 技术实现方法和代码行级别的实验场景注入。
• https://github.com/chaosblade-io/chaosblade-box%EF%BC%9A%E5%85%B7%E5%A4%87%E6%B7%B7%E6%B2%8C%E5%B7%A5%E7%A8%8B%E5%B9%B3%E5%8F%B0%E5%92%8C%E9%9F%A7%E6%80%A7%E6%B5%8B%E8%AF%95%E5%B9%B3%E5%8F%B0%E8%83%BD%E5%8A%9B%E3%80%82%E6%9C%89%E5%85%B3%E9%9F%A7%E6%80%A7%E6%B5%8B%E8%AF%95%E5%B9%B3%E5%8F%B0%E8%83%BD%E5%8A%9B%E7%9A%84%E6%9B%B4%E5%A4%9A%E4%BF%A1%E6%81%AF%EF%BC%8C%E8%AF%B7%E5%8F%82%E8%A7%81 https://github.com/chaosblade-io/chaosblade-box/tree/main2 分支。

快速开始

本指南帮助您在 5 分钟内使用 ChaosBlade 在 Kubernetes 上运行首次故障注入。我们将以向 Pod 注入 CPU 压力故障作为简单示例。

前提条件

开始前，请确保您已具备：

• kubectl 访问权限：能够访问运行中的 Kubernetes 集群（kubectl cluster-info 命令返回成功）
• 目标命名空间：至少有一个运行中的 Pod（默认：default）
• 已安装 ChaosBlade：
• https://github.com/chaosblade-io/chaosblade/releases CLI 工具包已下载并解压（blade 可执行文件位于您的 PATH 中）
• https://github.com/chaosblade-io/chaosblade-operator/releases 已部署到集群（Kubernetes 场景必需）

使用 Helm 安装 operator：

script
helm install chaosblade-operator chaosblade-operator- .tgz --namespace chaosblade --create-namespace

验证 operator 正在运行：

script
kubectl get pods -n chaosblade

注入首次故障（CPU 压力）

对 default 命名空间中的 Pod 运行 CPU 满负载故障：

script
blade create k8s pod-cpu fullload --cpu-percent 80 --kubeconfig ~/.kube/config --names --namespace default

如果注入成功，ChaosBlade 将返回包含实验 uid 的 JSON 结果。保存此 uid 以便稍后检查状态或销毁实验：

{"code":200,"success":true,"result":" "}

检查实验状态

script
blade status

恢复（销毁故障）

演练后请务必恢复，使目标恢复正常：

script
blade destroy

就这样！您已完成完整的注入-验证-恢复周期。要探索更多场景，请运行 blade create k8s -h 或参见 云原生下的混沌工程实践。

CLI 命令

chaosblade 支持 CLI 和 HTTP 调用方式。支持的命令如下：

• prepare：别名为 p，混沌工程实验前的准备工作，例如对 Java 应用进行注入时，需要挂载 Java agent。例如，要对应用名称为 business 的应用进行注入，在目标主机执行 blade p jvm --process business。若挂载成功，会返回 uid 用于状态查询或代理撤销。
• revoke：别名为 r，撤销之前的混沌工程实验准备工作，例如卸载 Java agent。命令为 blade revoke UID
• create：别名为 c，创建混沌工程实验。命令格式为 blade create [TARGET] [ACTION] [FLAGS]。例如，要实现 Dubbo 消费者调用 xxx.xxx.Service 接口延迟 3 秒，执行的命令为 blade create dubbo delay --consumer --time 3000 --Service xxx.xxx.Service，若注入成功，会返回实验 uid 用于状态查询和销毁实验。
• destroy：别名为 d，销毁混沌工程实验，例如销毁上述提到的 Dubbo 延迟实验，命令为 blade destroy UID
• status：别名为 s，查询准备阶段或实验状态，命令为 blade status UID 或 blade status --type create
• server：启动 Web 服务器，暴露 HTTP 服务，通过 HTTP 请求调用 chaosblade。例如，在目标机器 xxxx 上执行：blade server start -p 9526 以执行 CPU 满负载实验：curl "http://xxxx:9526/chaosblade?cmd=create%20cpu%20fullload"

使用 blade help [COMMAND] 或 blade [COMMAND] -h 命令查看帮助信息。

体验演示

下载 chaosblade 演示镜像，体验 blade 工具包的使用。

下载镜像命令：

script
docker pull chaosbladeio/chaosblade-demo

运行演示容器：

script
docker run -it --privileged chaosbladeio/chaosblade-demo

进入容器后，可阅读 README.txt 文件来实施混沌实验，祝您使用愉快。

云原生

https://github.com/chaosblade-io/chaosblade-operator 项目是面向云原生平台的混沌实验注入工具。它遵循混沌实验模型对实验场景进行标准化定义，将实验定义为 Kubernetes CRD 资源，把实验模型映射到 Kubernetes 资源属性，使混沌实验模型与 Kubernetes 声明式设计友好结合。在依托混沌实验模型便捷开发场景的同时，也能很好地融入 Kubernetes 设计理念，通过 kubectl 或编写代码直接调用 Kubernetes API 来创建、更新和删除混沌实验，资源状态可清晰指示实验执行状态，规范 Kubernetes 故障注入。除了使用上述方式执行实验外，还可以使用 chaosblade cli 方式非常便捷地执行 Kubernetes 实验场景和查询实验状态。详情请阅读中文文档：云原生下的混沌工程实践

编译

详情请参见 BUILD.md。

问题与反馈

如需提交 bug 报告、提问或参与讨论，请提交 https://github.com/chaosblade-io/chaosblade/issues%E3%80%82

您也可以通过以下方式联系我们：

• 钉钉群（推荐中文用户）：23177705
• Slack 群：chaosblade-io
• Gitter 房间：https://gitter.im/chaosblade-io/community
• ：
• ***：chaosblade.io

贡献

我们欢迎每一份贡献，即使只是一个标点符号。详情参见 CONTRIBUTING。关于特定社区参与人员的晋升阶梯，请参见：(https://github.com/chaosblade-io/community/blob/main/Contributor_Ladder.md)

企业登记

我们开源项目的初衷是降低企业落地混沌工程的门槛，因此我们高度重视项目在企业中的使用情况。欢迎大家在此 https://github.com/chaosblade-io/chaosblade/issues/32 进行登记。登记后，您将被邀请加入企业邮件组，共同探讨混沌工程在企业落地过程中遇到的问题并分享落地经验。

贡献者

代码贡献者

这个项目的存在归功于所有贡献者。[贡献]

许可证

Chaosblade 采用 Apache License, Version 2.0 许可证。完整许可证文本参见 LICENSE。