rticom/perftest

RTI® Perftest Docker镜像

欢迎使用RTI® Perftest，这是RTI Connext®的开箱即用解决方案，旨在测量和分析RTI Connext应用的性能。该工具提供延迟、吞吐量及其他关键性能方面的全面指标。

更多关于RTI Perftest的信息，请参考RTI文档。

本页面文档适用于带有latest标签的Perftest Docker镜像，该标签对应RTI最新发布的长期支持（LTS）版本。如需特定标签的文档，请访问https://github.com/rticommunity/rticonnextdds-containers%E4%BB%93%E5%BA%93%E3%80%82

使用Perftest容器镜像

在Docker上运行Perftest只需执行docker run命令：

发布者（Publisher）

以下命令以发布者身份运行Perftest，发送1024字节的数据，持续60秒：

bash
docker run -t \
        --network host \
        --name=perftest_pub \
        rticom/perftest:latest \
        -pub -dataLen 1024 -executionTime 60

预期输出：

Waiting to discover 1 subscribers ...
Waiting for subscribers announcement ...
Sending 400 initialization pings ...
Sending data ...

订阅者（Subscriber）

以下命令以订阅者身份运行Perftest，接收1024字节的数据：

bash
docker run -t \
        --network host \
        --name=perftest_sub \
        rticom/perftest:latest \
        -sub -dataLen 1024

预期输出：

Waiting to discover 1 publishers ...
Interval Throughput for 1024 Bytes:
Length (Bytes), Total Samples,  Samples/s, Avg Samples/s,     Mbps,  Avg Mbps, Lost Samples, Lost Samples (%)
Waiting for data ...

上述命令在前台运行容器，若需后台运行，可添加-d参数。使用-d后，可通过以下命令查看日志：

bash
docker logs perftest_pub
docker logs perftest_sub

Perftest容器使用以下用户和组：

• 用户：rtiuser（1000）
• 组：rtigroup（1000）

工作目录：

• /home/rtiuser/rti_workspace/7.7.0/user_config/perftest

内置配置

使用以下命令获取Perftest内置配置文件：

bash
docker cp perftest:/opt/rti.com/rti_connext_dds-7.7.0/resource/xml/RTI_PERFTEST.xml .

自定义配置

若需使用自定义配置，运行容器时请执行以下步骤：

1. 将主机上的配置文件绑定挂载到容器内的/home/rtiuser/rti_workspace/7.7.0/user_config/perftest/USER_PERFTEST_CONFIG.xml路径；
2. 添加-cfgName参数指定配置名称。

示例：

bash
docker run -dt \
        --network host \
        -v $PWD/MyPerftestConfig.xml:/home/rtiuser/rti_workspace/7.7.0/user_config/perftest/USER_PERFTEST_CONFIG.xml \
        --name=perftest \
        rticom/perftest:latest \
        -cfgName MyPerftestConfig

命令行参数

若需添加额外命令行参数，可在docker run命令末尾追加。示例（设置日志 verbosity 为 WARN）：

bash
docker run -dt \
        --network host \
        --name=perftest \
        rticom/perftest:latest \
        -pub -dataLen 1024 -executionTime 60 -verbosity WARN

使用-h参数查看所有允许的参数：

bash
docker run --rm -t rticom/perftest:latest -h

使用场景

基本吞吐量测试

发布者：

bash
docker run -dt \
        --network host \
        --name=perftest_pub \
        rticom/perftest:latest \
        -pub -dataLen 1024 -executionTime 60

订阅者：

bash
docker run -dt \
        --network host \
        --name=perftest_sub \
        rticom/perftest:latest \
        -sub -dataLen 1024

延迟测试

发布者：

bash
docker run -dt \
        --network host \
        --name=perftest_pub \
        rticom/perftest:latest \
        -pub -latencyTest -dataLen 1024 -executionTime 60

订阅者：

bash
docker run -dt \
        --network host \
        --name=perftest_sub \
        rticom/perftest:latest \
        -sub -dataLen 1024

网络配置

上述示例使用--network host参数让容器运行在主机网络中，这是最直接的方式，允许容器与主机及其他容器通信。但主机网络并非在所有平台都可用，支持程度因操作系统而异。

若需在与主机隔离的自定义网络中运行容器，可使用docker network create创建网络并指定该网络运行容器。详情请参考https://docs.docker.com/network/%E3%80%82

若需在不使用主机网络的情况下让容器对外可访问，建议使用RTI Real-Time WAN Transport并通过-p选项暴露必要的UDP端口。关于WAN Transport的更多信息，请参考用户手册；关于-p选项，请参考https://docs.docker.com/engine/reference/run/#expose-incoming-ports%E3%80%82

Perftest允许通过-transport参数配置传输属性，详情请参考RTI Perftest传输特定选项文档。

发布说明

RTI Connext产品的发布说明可在RTI社区门户获取：[***]

许可证

RTI® Perftest受以下补充许可条款及RTI Connext® Professional附带的软件许可协议约束（[***]

该镜像基于Ubuntu构建，您的使用需遵守适用的许可条款：https://hub.docker.com/_/ubuntu%E3%80%82

软件物料清单（SBOM）的第三方信息以SPDX格式存储在/user/local/share/sbom/目录中。

更多第三方信息请访问：[***]

使用以下命令获取内置的RTI_License_Agreement_LM.pdf文件：

bash
docker cp perftest:/opt/rti.com/rti_connext_dds-7.7.0/RTI_License_Agreement_LM.pdf .

RTI补充许可协议

（注：此处保留原补充许可协议内容，因涉及***条款，建议直接参考官方原文） This RTI Supplemental License ("Supplemental License") is for the accompanying RTI container image ("Container Image"). Real-Time Innovations, Inc. ("RTI") licenses the Container Image to you only if you agree to comply with all of the terms and conditions of this Supplemental License. ...（原协议内容省略，如需完整请参考官方文档）