frrouting/topotests

FRRouting Topotests 镜像文档

概述

该镜像提供FRRouting（开源路由软件套件）的拓扑测试工具，用于验证网络拓扑配置和路由协议功能的正确性。镜像内置测试文档，路径为/doc/developer/topotests.rst，包含详细的测试方法和用例说明。

核心功能与特性

• 路由协议测试：支持FRRouting核心路由协议（如OSPF、BGP、RIP等）的功能验证
• 拓扑模拟：可模拟复杂网络拓扑结构，测试不同网络环境下的路由行为
• 自动化测试：提供标准化测试流程，支持批量执行测试用例并生成结果报告
• FRRouting集成：与FRRouting软件套件深度集成，确保测试环境与实际部署一致

使用场景

• 开发验证：FRRouting开发人员验证新功能或 bug 修复对路由协议的影响
• 配置测试：网络管理员测试自定义网络拓扑配置的正确性和稳定性
• CI/CD集成：作为持续集成流程的一部分，自动验证代码变更是否破坏路由功能

使用方法

基本运行

通过以下命令启动容器，可交互式访问测试环境：

bash
docker run -it --rm docker.xuanyuan.run/frr-topotests

挂载本地测试用例

将本地测试用例目录挂载到容器内，执行自定义测试：

bash
docker run -it --rm -v /path/to/local/testcases:/tests docker.xuanyuan.run/frr-topotests

访问文档

容器内测试文档路径为/doc/developer/topotests.rst，可通过以下方式查看：

bash
# 在容器内直接查看
cat /doc/developer/topotests.rst

# 或从宿主机复制文档
docker cp <container_id>:/doc/developer/topotests.rst /local/path/topotests.rst

执行测试

进入容器后，参考文档执行测试命令（具体命令以文档为准）：

bash
# 示例：运行指定测试用例
cd /tests
python3 -m pytest test_ospf_topology.py

注意事项

• 测试需依赖FRRouting运行环境，确保容器内FRRouting服务正常启动
• 复杂拓扑测试可能需要调整容器资源限制（如内存、CPU）
• 详细测试参数和用例编写规范请参考容器内文档