sipfront/agent

Sipfront Agent Docker镜像文档

镜像概述

该Docker镜像允许在自有环境中运行Sipfront（[***]）的本地流量生成代理，用于在私有基础设施内生成测试流量，支持自定义代理池管理和多代理并行测试。

核心功能和特性

• 本地流量生成：在私有环境中部署Sipfront流量代理，避免外部网络依赖
• 自定义代理池：支持创建和管理私有代理池，通过池ID和密钥进行身份验证
• 多代理并行：可运行多个代理实例，支持主叫方、被叫方等不同角色的流量模拟，满足并行测试需求
• 无缝集成：与Sipfront平台完全兼容，可直接在测试会话中选择私有代理池

使用场景

• 需要在私有网络环境中进行SIP流量测试的场景
• 需隔离测试流量与公共网络的企业级测试需求
• 多并发测试用例场景，需通过多个代理实例并行执行测试

使用方法

前提条件

• 拥有Sipfront账户并可访问Sipfront应用平台（[***]）
• 已创建自定义代理池并获取池ID（Pool ID）和池密钥（Pool Secret）

1. 创建代理池

1. 登录Sipfront应用平台（[***]）
2. 导航至 账户 -> 代理池（Account -> Agent Pools）
3. 创建新代理池，记录生成的 池ID（Pool ID） 和 池密钥（Pool Secret）

2. 运行代理实例

使用以下命令在代理池中运行流量生成代理：

bash
docker run -e SF_POOL_ID="xxx" -e SF_POOL_SECRET="yyy" docker.xuanyuan.run/sipfront/agent:latest

参数说明：

• SF_POOL_ID：必填，代理池ID，替换为创建代理池时获取的"xxx"
• SF_POOL_SECRET：必填，代理池密钥，替换为创建代理池时获取的"yyy"

注意：大多数测试需运行两个代理实例（一个用于主叫方，一个用于被叫方），可根据测试需求运行多个实例以并行执行多个测试用例。

3. 在代理池中运行测试

1. 启动新测试会话
2. 在测试会话配置页面的 选择代理池（Choose agent pool）选项下，选择已创建的私有代理池
3. 执行测试，流量将通过私有环境中的代理实例生成

部署示例

基本部署命令

bash
# 运行主叫方代理
docker run -d -e SF_POOL_ID="your_pool_id" -e SF_POOL_SECRET="your_pool_secret" --name sipfront-agent-caller docker.xuanyuan.run/sipfront/agent:latest

# 运行被叫方代理（同一代理池）
docker run -d -e SF_POOL_ID="your_pool_id" -e SF_POOL_SECRET="your_pool_secret" --name sipfront-agent-callee docker.xuanyuan.run/sipfront/agent:latest

多代理并行部署

如需并行执行多个测试用例，可通过启动多个容器实例实现：

bash
# 启动3个代理实例以支持并行测试
docker run -d -e SF_POOL_ID="your_pool_id" -e SF_POOL_SECRET="your_pool_secret" docker.xuanyuan.run/sipfront/agent:latest
docker run -d -e SF_POOL_ID="your_pool_id" -e SF_POOL_SECRET="your_pool_secret" docker.xuanyuan.run/sipfront/agent:latest
docker run -d -e SF_POOL_ID="your_pool_id" -e SF_POOL_SECRET="your_pool_secret" docker.xuanyuan.run/sipfront/agent:latest