rticom/persistence-service

RTI Persistence Service Docker镜像

镜像概述

欢迎使用RTI® Persistence Service，这是一个RTI Connext®应用程序，旨在持久化DDS Topic数据。它确保DataWriter产生的数据能够在DataWriter本身生命周期之外继续存在，使需要具有TRANSIENT或PERSISTENT持久性数据的延迟加入DataReader能够访问这些数据。

更多信息请参考RTI官方文档。

版本说明

本文档适用于带有latest标签的Persistence Service镜像，该标签指向RTI发布的最新版本。如需确认latest对应的Connext版本或查看其他支持版本，请访问https://hub.docker.com/r/rticom/persistence-service/tags%E3%80%82%E5%8E%86%E5%8F%B2%E7%89%88%E6%9C%AC%E6%96%87%E6%A1%A3%E8%AF%B7%E5%8F%82%E8%80%83https://github.com/rticommunity/rticonnextdds-containers%E3%80%82

使用方法

运行Persistence 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=persistence_service \
        docker.xuanyuan.run/rticom/persistence-service:latest \
        -cfgName default

该命令启动Persistence Service，使用默认配置（内存持久化domain 0中所有TRANSIENT持久性的Topic数据）。

许可证要求

运行镜像需绑定RTI许可证文件：

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

容器用户与工作目录

• 用户：rtiuser（UID 1010）
• 组：rtigroup（GID 1010）
• 工作目录：/home/rtiuser/rti_workspace/7.7.0/user_config/persistence_service

内置配置

获取内置配置文件：

bash
docker cp persistence_service:/opt/rti.com/rti_connext_dds-7.7.0/resource/xml/RTI_PERSISTENCE_SERVICE.xml .

内置配置支持以下模式：

选择配置模式：

bash
docker run -dt \
        --network host \
        -v $PWD/rti_license.dat:/opt/rti.com/rti_connext_dds-7.7.0/rti_license.dat \
        --name=persistence_service \
        docker.xuanyuan.run/rticom/persistence-service:latest \
        -cfgName defaultDisk

环境变量参数

通用参数：

bash
-e ADMINISTRATION_DOMAIN=<管理域ID，默认0>
-e DATA_DOMAIN=<用户数据域ID，默认0>
-e STORAGE_DIRECTORY=<数据库存储目录，默认/home/rtiuser/rti_workspace/7.7.0/database>

持久化数据库文件

Volume方式（推荐）：

bash
docker run -dt \
        --network host \
        -v $PWD/rti_license.dat:/opt/rti.com/rti_connext_dds-7.7.0/rti_license.dat \
        --mount type=volume,source=persistence_service_database,target=/home/rtiuser/rti_workspace/7.7.0/database \
        --name=persistence_service \
        docker.xuanyuan.run/rticom/persistence-service:latest \
        -cfgName defaultDisk

Bind-mount方式：

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/persistence_service_database:/home/rtiuser/rti_workspace/7.7.0/database \
        --name=persistence_service \
        docker.xuanyuan.run/rticom/persistence-service:latest \
        -cfgName defaultDisk

注意：主机目录需存在且rtiuser（1010:1010）有读写权限。

自定义配置

绑定自定义配置文件并运行：

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/MyPersistenceService.xml:/home/rtiuser/rti_workspace/7.7.0/user_config/persistence_service/USER_PERSISTENCE_SERVICE.xml \
        --name=persistence_service \
        docker.xuanyuan.run/rticom/persistence-service:latest \
        -cfgName MyPersistenceService

命令行参数

添加自定义参数（如设置日志级别）：

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/MyPersistenceService.xml:/home/rtiuser/rti_workspace/7.7.0/user_config/persistence_service/USER_PERSISTENCE_SERVICE.xml \
        --name=persistence_service \
        docker.xuanyuan.run/rticom/persistence-service:latest \
        -cfgName MyPersistenceService \
        -verbosity 2

查看所有参数：

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

网络配置

• Host网络：使用--network host（推荐，简单直接）。
• 自定义网络：通过docker network create创建隔离网络。
• WAN传输：如需外部访问，可使用RTI Real-Time WAN Transport并暴露UDP端口（需自定义配置）。

健康检查

Persistence Service支持HTTP健康检查，示例Kubernetes配置：

yaml
apiVersion: v1
kind: Pod
metadata:
  name: persistence-service
spec:
  containers:
  - name: rtipersistenceservice
    image: docker.xuanyuan.run/rticom/persistence-service:latest
    args: ["-cfgName", "defaultDisk", "-healthCheckPort", "9000"]
    ports:
    - containerPort: 9000
      name: health
    livenessProbe:
      httpGet:
        path: /
        port: health
      initialDelaySeconds: 10
      periodSeconds: 30
    readinessProbe:
      httpGet:
        path: /
        port: health
      initialDelaySeconds: 5
      periodSeconds: 10

版本说明

RTI Connext产品的版本说明请访问RTI社区门户。Docker镜像版本说明请参考https://github.com/rticommunity/rticonnextdds-containers%E3%80%82

许可证

• RTI Persistence Service遵循RTI Connext Professional许可协议，详情见许可条款。
• 基础镜像Ubuntu的许可条款见https://hub.docker.com/_/ubuntu%E3%80%82
• 获取许可证文件：现有客户联系RTI支持；评估用户访问免费试用页面。

获取内置许可文件：

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

===END===