rticom/web-integration-service

RTI Connext Web Integration Service Docker镜像

欢迎使用RTI Connext Web Integration Service Docker镜像，这是RTI Connext的开箱即用解决方案，用于将基于Web的应用和服务与RTI Connext集成。更多信息请参考RTI官方文档。

版本说明

本页面文档适用于带有latest标签的Web Integration Service镜像，对应RTI Connext的最新版本。如需确认latest标签对应的Connext版本或查看支持该镜像的其他Connext版本，请访问https://hub.docker.com/r/rticom/web-integration-service/tags%E3%80%82%E6%97%A7%E7%89%88%E6%9C%AC%E9%95%9C%E5%83%8F%E7%9A%84%E6%96%87%E6%A1%A3%E5%8F%AF%E5%8F%82%E8%80%83https://github.com/rticommunity/rticonnextdds-containers%E3%80%82

核心功能

1. 实现Web应用与RTI Connext DDS系统的双向数据集成
2. 支持HTTP请求监听（默认端口8080）
3. 提供内置配置与自定义配置能力
4. 兼容多种Docker网络模式（主机网络、自定义网络等）
5. 支持命令行参数灵活调整服务参数

使用场景

• 工业物联网（IIoT）中Web监控平台与实时DDS数据的交互
• 企业级应用中Web服务与分布式实时系统的集成
• 实时数据可视化场景下Web前端与DDS数据源的连接

配置与使用说明

基础运行示例

运行Web Integration Service容器的基本命令如下：

bash
docker run -dt \
        --network host \
        -v $PWD/rti_license.dat:/opt/rti.com/rti_connext_dds-7.7.0/rti_license.dat \
        --name=web_integration_service \
        docker.xuanyuan.run/rticom/web-integration-service:latest \
        -cfgName shapesDemoTutorial \
        -documentRoot /home/rtiuser/rti_workspace/7.7.0/examples/web_integration_service

该命令启动服务后，可通过http://localhost:8080%E8%AE%BF%E9%97%AE%E3%80%82

许可证绑定

运行服务需绑定RTI许可证文件，通过-v参数挂载：

bash
-v $PWD/your/rti_license.dat:/opt/rti.com/rti_connext_dds-7.7.0/rti_license.dat

内置配置

获取内置配置文件：

bash
docker cp web_integration_service:/opt/rti.com/rti_connext_dds-7.7.0/resource/xml/RTI_WEB_INTEGRATION_SERVICE.xml .

内置配置包含：

自定义配置

1. 将自定义配置文件（如MyWebIntegrationService.xml）挂载到容器内指定路径：

bash
-v $PWD/MyWebIntegrationService.xml:/home/rtiuser/rti_workspace/7.7.0/user_config/web_integration_service/USER_WEB_INTEGRATION_SERVICE.xml

2. 通过-cfgName指定配置名称：

bash
docker run -dt \
        --network host \
        -v $PWD/rti_license.dat:/opt/rti.com/rti_connext_dds-7.7.0/rti_license.dat \
        -v $PWD/MyWebIntegrationService.xml:/home/rtiuser/rti_workspace/7.7.0/user_config/web_integration_service/USER_WEB_INTEGRATION_SERVICE.xml \
        --name=web_integration_service \
        docker.xuanyuan.run/rticom/web-integration-service:latest \
        -cfgName MyWebIntegrationService

命令行参数

可在docker run命令末尾添加参数调整服务行为，例如修改监听端口：

bash
docker run -dt \
        --network host \
        -v $PWD/rti_license.dat:/opt/rti.com/rti_connext_dds-7.7.0/rti_license.dat \
        -v $PWD/MyWebIntegrationService.xml:/home/rtiuser/rti_workspace/7.7.0/user_config/web_integration_service/USER_WEB_INTEGRATION_SERVICE.xml \
        --name=web_integration_service \
        docker.xuanyuan.run/rticom/web-integration-service:latest \
        -cfgName MyWebIntegrationService \
        -listeningPorts 9090

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

bash
docker run --rm -t docker.xuanyuan.run/rticom/web-integration-service:latest -h

网络配置

• 主机网络：使用--network host参数，适用于容器与主机及其他容器直接通信（部分平台可能不支持）。
• 自定义网络：通过docker network create创建隔离网络，参考https://docs.docker.com/network/%E3%80%82
• 端口映射：若不使用主机网络，可通过-p参数暴露UDP端口，例如：-p 8080:8080。

许可证信息

RTI Web Integration Service的使用需遵守RTI Connext Professional软件许可协议及补充许可条款。镜像基于Ubuntu构建，需遵守https://hub.docker.com/_/ubuntu%E3%80%82

获取许可证文件：

• 现有客户：联系RTI支持。
• 评估用户：访问RTI免费试用页面获取试用许可证。