weaveworks/scope-traffic-control-plugin

Weave Scope网络降级模拟插件

镜像概述

该镜像为Weave Scope的官方插件，专门用于在测试环境中模拟各类网络降级场景。通过集成此插件，用户可便捷地在Weave Scope可视化平台中配置并施加网络故障，如延迟、丢包、带宽限制等，以验证应用在不稳定网络环境下的表现和容错能力。

核心功能与特性

• 网络降级模拟：支持模拟多种网络异常，包括但不限于延迟、丢包、带宽限制、网络分区等
• Weave Scope集成：无缝对接Weave Scope监控平台，可通过可视化界面配置和管理网络测试规则
• 轻量级设计：插件体积小巧，资源占用低，不影响测试环境的基础性能
• 灵活配置：支持自定义网络异常参数（如延迟时长、丢包率、带宽阈值等），满足多样化测试需求

适用场景

• 弱网络环境测试：验证应用在高延迟、高丢包网络环境下的响应能力和用户体验
• 服务容错能力验证：测试分布式系统在网络故障时的服务降级、熔断、重试机制是否生效
• 网络故障恢复测试：模拟网络中断后恢复的场景，验证应用的自动重连和状态恢复能力
• 微服务依赖测试：评估微服务间通信在网络不稳定时的依赖管理和错误处理逻辑

使用方法

前提条件

• 已部署Weave Scope平台（参考Weave Scope官方文档进行安装）
• Docker环境版本≥1.12.0

基本安装与运行

通过Docker命令直接运行插件容器，与Weave Scope集成：

bash
docker run -d --name weave-scope-network-simulator \
  --net=weave \
  --volume /var/run/scope/plugins:/var/run/scope/plugins \
  weaveworks/scope-network-simulator:latest

说明：--net=weave确保插件与Weave网络通信，--volume挂载Scope插件目录以实现集成

配置网络降级参数

通过环境变量或命令行参数指定网络异常规则（具体参数需参考插件官方文档），示例：

bash
docker run -d --name weave-scope-network-simulator \
  --net=weave \
  --volume /var/run/scope/plugins:/var/run/scope/plugins \
  -e NETWORK_DELAY=100ms \       # 模拟100ms网络延迟
  -e PACKET_LOSS=5% \            # 模拟5%丢包率
  -e BANDWIDTH_LIMIT=1Mbps \     # 限制带宽为1Mbps
  weaveworks/scope-network-simulator:latest

通过Docker Compose部署

创建docker-compose.yml文件集成插件：

yaml
version: '3'
services:
  scope-network-simulator:
    image: weaveworks/scope-network-simulator:latest
    container_name: weave-scope-network-simulator
    network_mode: weave
    volumes:
      - /var/run/scope/plugins:/var/run/scope/plugins
    environment:
      - NETWORK_DELAY=200ms
      - PACKET_LOSS=10%
      - BANDWIDTH_LIMIT=512Kbps

启动命令：

bash
docker-compose up -d

配置参数说明

注：具体支持的参数及格式请以插件最新版本官方文档为准。

注意事项

• 该插件仅用于测试环境，禁止在生产环境部署
• 使用前需确保Weave Scope已正常运行且插件目录挂载正确
• 测试完成后建议清理网络规则，避免影响后续测试环境