coco/nativerw

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 docker.xuanyuan.run/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
  健康检查端点，用于监控服务运行状态

日志说明

应用使用https://github.com/Financial-Times/go-logger%E8%AE%B0%E5%BD%95%E6%97%A5%E5%BF%97%EF%BC%8C%E6%97%A5%E5%BF%97%E6%96%87%E4%BB%B6%E5%9C%A8app.go%E4%B8%AD%E5%88%9D%E5%A7%8B%E5%8C%96%E9%85%8D%E7%BD%AE%E3%80%82