coco/nativerw Docker 镜像 - 轩辕镜像

Native Store Reader Writer (nativerw)

镜像概述和主要用途

nativerw（Native Store Reader Writer）是一个用于从原生CMS（内容管理系统）写入任何原始内容/数据到MongoDB的工具，无需进行数据转换。存储的数据可直接像从原始CMS一样读取，支持基本的读写操作及健康检查功能。

核心功能和特性

• 无转换存储：直接存储原生CMS的原始数据，无需格式转换
• 双向数据操作：支持将数据写入MongoDB及从MongoDB读取数据
• MongoDB连接管理：可配置MongoDB连接地址及节点数量，确保高可用性
• 健康检查机制：提供就绪检查（/__gtg）和健康检查（/__health）端点
• UUID集合查询：支持获取指定集合的所有UUID（尽力而为，大数据集可能超时）

使用场景和适用范围

适用于需要直接存储和访问原生CMS原始数据的场景，如内容管理系统的数据备份、中间数据存储，或需保持数据原始格式进行后续处理的业务系统。

详细使用方法和配置说明

构建Docker镜像

bash
# 构建可执行文件
CGO_ENABLED=0 go build -a -installsuffix cgo -o nativerw .
# 构建Docker镜像
docker build -t coco/nativerw .

运行参数配置

运行容器时需通过环境变量注入以下配置参数：

容器启动示例：

bash
docker run -e MONGOS="host1:27017,host2:27017,host3:27017" -e MONGO_NODE_COUNT=3 coco/nativerw

API端点说明

nativerw支持以下API端点：

• GET /{collection}/{uuid}
  检索指定集合中指定UUID的原生文档，返回格式为JSON或二进制（取决于存储方式）

• PUT /{collection}/{uuid}
  为指定UUID插入或更新原生文档（upsert操作）

• GET /{collection}/__ids
  返回指定集合的所有UUID（尽力而为）。若集合过大，可能在10秒超时前无法返回所有UUID；返回UUID数量少于约10,000时，可认为已返回完整集合

• GET /__gtg
  就绪检查端点，用于验证服务是否就绪

• GET /__health
  健康检查端点，用于监控服务运行状态

日志说明

应用使用go-logger记录日志，日志文件在app.go中初始化配置。