rcsworks/cloud-connect

!RCS Sound Software

Cloud Connect 概述

Cloud Connect 是一款本地部署应用，用于实现 RCS Cloud 与位于私有网络中的设备之间的通信。RCS AudioDisplay 通过 Cloud Connect 与现场编码器进行通信。

支持的架构

我们利用 Docker 清单实现多平台支持。更多信息可参考 Docker 文档https://github.com/docker/distribution/blob/master/docs/spec/manifest-v2-2.md#manifest-list%E3%80%82%E6%8B%89%E5%8F%96 latest 标签时，将自动获取适用于您架构的正确镜像。以下是该镜像支持的架构：

版本标签

该镜像提供多种版本，可通过标签获取。请仔细阅读描述，使用不稳定或开发标签时需谨慎。

使用方法

以下是一些帮助您快速上手的示例代码片段！

docker-compose

yaml
version: "3.9"
services:
  cloud-connect:
    container_name: cloud-connect
    image: rcsworks/cloud-connect:latest
    ports:
      - 8080:8080
    environment:
      - CONNECT_ID=rcsworks  # 您的唯一 Connect ID（必填）
      - AUDIODISPLAY_SERVER_URL=https://api.audiodisplay.rcsworks.com  # 要连接的 AudioDisplay 服务器（必填）
      - AUTH_TOKEN=xxx  # 授权令牌（必填）
      - LOG_DEVICE_MESSAGE=true  # 可选，启用设备消息日志
      - OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317  # 可选，设置 OpenTelemetry 端点以发送日志
      - OTEL_EXPORTER_OTLP_API_KEY=foobar  # 可选，指定 api-key 头的令牌
    restart: unless-stopped

docker-cli

bash
docker run -d \
--name=cloud-connect \
-p 8080:8080 \
-e CONNECT_ID=rcsworks \  # 您的唯一 Connect ID（必填）
-e AUDIODISPLAY_SERVER_URL=https://api.audiodisplay.rcsworks.com \  # 要连接的 AudioDisplay 服务器（必填）
-e AUTH_TOKEN=xxx \  # 授权令牌（必填）
-e LOG_DEVICE_MESSAGE=true \  # 可选，启用设备消息日志
-e OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317 \  # 可选，设置 OpenTelemetry 端点以发送日志
-e OTEL_EXPORTER_OTLP_API_KEY=foobar \  # 可选，指定 api-key 头的令牌
--restart unless-stopped \
rcsworks/cloud-connect:latest

参数说明

应用通过运行时传递的参数进行配置，支持以下参数：

保持更新

此镜像是静态版本化的，需通过更新镜像并重新创建容器来更新内部的 Cloud Connect 应用。以下是升级容器的几种方法：

通过 Docker Compose

• 拉取最新版本镜像：docker pull rcsworks/cloud-connect
• 更新 Cloud Connect 容器：docker-compose up -d cloud-connect
• 移除未使用镜像：docker image prune

通过 Docker Run

（此方法需删除并重新创建容器）

• 拉取最新镜像：docker pull rcsworks/cloud-connect
• 停止运行中的容器：docker stop cloud-connect
• 删除容器：docker rm cloud-connect
• 使用上述原始配置重新创建容器
• 移除未使用镜像：docker image prune

通过 Watchtower

https://github.com/containrrr/watchtower 是一款用于自动更新 Docker 容器基础镜像的工具。

• 拉取指定标签的最新镜像并使用相同环境变量替换容器：

bash
docker run --rm \
-v /var/run/docker.sock:/var/run/docker.sock \
containrrr/watchtower \
--run-once connect

Watchtower 是一个实用工具，但其配置可能存在意外影响，建议参考其官方文档。对于一次性手动更新忘记原始参数的容器，这是一个有用的工具。长期解决方案推荐使用 Docker Compose。

支持

如果您遇到任何问题或需要故障排除帮助，请联系我们的支持团队。有关 Cloud Connect 的问题，最佳联系方式是 ***。

许可证

请参考最终用户许可协议。

本软件是 RCS 的专有软件，受版权和商业秘密保护，仅授权被许可人使用。请注意，被许可人从 RCS 下载的所有文件（无论是否保存在被许可人服务器中用于存档）均为 RCS 的专有财产。(1) 除被许可人外，任何人使用本软件；(2) 未经 RCS 授权制作本软件的副本，均 (A) 不仅违反许可协议，还违反美国专利法和版权法；(B) 可能使被许可人和/或任何其他侵权者面临严厉的民事和刑事处罚。如果您尚未与 RCS 签订标准许可协议，但希望使用我们的产品，请联系：

RCS Sound Software
One North Broadway. Floor 14
White Plains, New York *** USA
(914) 428-4600
：

© 2024 RCS。保留所有权利。Zetta、Selector、GSelector、Aquira、Linker、Selector2GO 和 Zetta2GO 是 RCS 的注册商标。