联犀开发者文档

Docker 与 urops

约 937 字大约 3 分钟

2026-10-16

应用或协议网关保存自己的 Dockerfile、Compose、健康检查和运行配置。镜像构建、平台注册与部署运维分别完成，不把源码目录直接交给 urops 自动构建。

1. 构建与验证自己的镜像

公开 IoT 基础应用把 Web 与 Go 构建成单镜像、单容器。从固定版本 ur-kit 根目录运行：

export PLATFORM_URL='https://<platform-host>'
export VITE_GLOB_APPID='<platform-app-id>'
export IMAGE_VERSION='<immutable-image-version>'
docker compose -f apps/iot-basic/compose.yaml config -q
docker compose -f apps/iot-basic/compose.yaml build
docker compose -f apps/iot-basic/compose.yaml up -d

Docker/Compose 的变量使用与实际样例保持一致。镜像运行阶段只保留二进制、Web dist 和必要文件，移动端单独交付。自己的 Java/Node 后端替换后，应同步修改镜像构建和运行阶段。

验证健康检查、登录、企业/项目上下文、页面刷新直达、自有 API 和平台代理。镜像标签使用不可变版本；协议网关还要检查设备端口、配置挂载、可选串口映射和平台 RPC/总线可达性。

2. 准备 urops

按现有 urops 安装指南在目标 Linux 主机安装，先确认当前二进制支持自有应用功能：

urops version
urops app --help
docker version
docker compose version

如果没有 app 子命令，先取得支持该功能的版本，再执行后续步骤。源码合并不等于已安装工具已升级，不把未正式发行的能力写成所有版本都支持。Windows 版用于支持的远程运维；本机 Docker 应用部署在 Linux 版执行。

准备目标主机上的 Compose 与可选变量文件，填写自己的镜像版本、端口、依赖和平台连接。镜像仓认证按自己的权限执行，凭据不嵌入镜像和公开仓。

3. TUI 首次部署

运行 urops，进入 自定义应用与协议网关 → 部署新应用/协议网关：

  1. 输入自己应用名称。
  2. 填写目标主机 Compose 文件路径，可选填写变量文件路径。
  3. 核对摘要后确认，等待 Docker 健康结果。
  4. 返回菜单查看新登记项，再检查状态和日志。

输入路径允许空格，不额外加引号。这里使用目标主机已有配置与镜像；本机配置路径不会自动上传到另一台主机。

4. 对应命令行

urops app up --name my-app --file '/path/to/compose.yml' --env-file '/path/to/app.env' --json
urops app list --json
urops app status --name my-app --json
urops app logs --name my-app --lines 100 --json
urops app stop --name my-app --json

首次 up 会校验 Compose 并登记配置路径，以后可用 urops app up --name my-app --json 复用登记。停止应用不删除数据卷；端口、外部网络和显式容器名仍需由部署配置避免冲突。

5. 更新与回滚

更新 Compose 中的不可变镜像版本，再运行 up；回滚时恢复上一版本配置并重新 up。数据库和存量数据兼容性由应用迁移规则保证，回滚镜像不等于自动回滚数据库。

协议网关启动后自行注册协议和服务心跳，云端只读展示登记信息与近期心跳。设备存活、真实消息流转与容器健康分别检查，不通过旧云端安装/停止入口操作网关。

交付记录包含 SDK、技能、工具和镜像版本，以及实际验证条件。远程环境操作前按目标环境说明确认；教程示例不自动授权访问生产或历史测试环境。

更新日志

2026/10/16 17:31
查看所有更新日志
  • 1a4a7-docs(开发指南): 重建平台与应用开发路线于