harperdb/harperdb-openshift

Harper Docker镜像技术文档

镜像概述

Harper是一款全球分布式边缘应用平台，通过将用户定义的应用程序、高性能数据库及企业级流代理整合为单一包，实现复杂性简化、性能提升与成本降低。该平台支持一键式无限水平扩展，集群内数据同步延迟低至毫秒级，可将应用程序及其驱动数据部署至边缘节点，显著提升大型应用的用户体验并降低总体拥有成本。部署于全球基础设施时，Harper可作为企业数据与应用的CDN式解决方案。

核心功能与特性

分布式架构

• 无限水平扩展：支持一键式集群扩展，满足动态负载需求。
• 毫秒级数据同步：跨集群节点数据实时同步，确保边缘节点数据一致性。

Harper Studio管理界面

• 基于Web的管理平台，支持：
  • 配置数据库模式（schema）与表（table）
  • 管理用户与角色权限
  • 监控与配置数据复制策略
  • 购买及部署企业级许可证
• 简化管理流程，通过统一界面完成所有Harper管理任务。

多API支持

• REST接口：推荐用于生产环境应用的数据交互（CRUD操作），提供高性能与可扩展性。
• Operations API：用于执行管理任务（如集群配置、用户管理），详见官方操作API文档。

集成组件

• 内置用户定义应用运行环境、高性能数据库引擎及企业级流代理，无需额外集成第三方组件。

使用场景与适用范围

• 边缘计算应用：将应用与数据部署至边缘节点，降低延迟，提升终端用户体验。
• 分布式数据管理：适用于需要跨地域数据同步、高可用性的场景（如物联网、实时分析）。
• 企业级大规模应用：通过简化架构与边缘部署，降低大型应用的基础设施成本与管理复杂度。
• CDN式数据分发：利用全球分布式架构，实现数据与应用的高效分发，类似CDN的企业级解决方案。

使用方法与配置说明

配置参数（环境变量）

Harper配置可通过docker run环境变量传递，未指定时使用默认配置（以下为关键默认值）：

可选配置参数（根据需求添加）：

• THREADS：指定线程数（如THREADS=4）
• OPERATIONSAPI_NETWORK_SECUREPORT：操作API加密端口（启用HTTPS时设置，需将OPERATIONSAPI_NETWORK_PORT设为null）
• HTTP_SECUREPORT：REST接口加密端口（启用HTTPS时设置）
• REPLICATION_HOSTNAME：复制节点主机名（用于数据复制配置）
• CLUSTERING_ENABLED：是否启用NATS集群（true/false，旧版复制方式）
• CLUSTERING_USER/CLUSTERING_PASSWORD：NATS集群认证凭据
• CLUSTERING_NODENAME：集群节点名称

数据持久化

容器内所有数据（含配置、数据库文件）存储于/home/harperdb/hdb。为避免容器销毁后数据丢失，需通过Docker卷挂载该路径至宿主机：

bash
-v <宿主机目录>:/home/harperdb/hdb  # 例如：-v /data/harperdb:/home/harperdb/hdb

部署示例

1. 基础后台运行（挂载数据卷+暴露端口）

bash
docker run -d \
  -v /宿主机数据目录:/home/harperdb/hdb \  # 挂载数据卷持久化数据
  -e HDB_ADMIN_USERNAME=HDB_ADMIN \         # 管理员用户名（默认可省略）
  -e HDB_ADMIN_PASSWORD=your_secure_password \  # 修改默认密码（必填）
  -e THREADS=4 \                            # 指定4线程
  -p 9925:9925 \                            # 映射操作API端口
  -p 9926:9926 \                            # 映射REST接口端口
  harperdb/harperdb-openshift

2. 启用HTTPS与数据复制

bash
docker run -d \
  -v /宿主机数据目录:/home/harperdb/hdb \
  -e HDB_ADMIN_USERNAME=HDB_ADMIN \
  -e HDB_ADMIN_PASSWORD=your_secure_password \
  -e THREADS=4 \
  -e OPERATIONSAPI_NETWORK_PORT=null \       # 禁用非加密操作API端口
  -e OPERATIONSAPI_NETWORK_SECUREPORT=9925 \ # 启用HTTPS操作API端口
  -e HTTP_SECUREPORT=9926 \                  # 启用HTTPS REST接口端口
  -e REPLICATION_HOSTNAME=server-one \       # 配置复制主机名
  -p 9925:9925 \
  -p 9926:9926 \
  harperdb/harperdb-openshift

3. 启用HTTPS与NATS集群（旧版复制）

bash
docker run -d \
  -v /宿主机数据目录:/home/harperdb/hdb \
  -e HDB_ADMIN_USERNAME=HDB_ADMIN \
  -e HDB_ADMIN_PASSWORD=your_secure_password \
  -e THREADS=4 \
  -e OPERATIONSAPI_NETWORK_PORT=null \
  -e OPERATIONSAPI_NETWORK_SECUREPORT=9925 \
  -e HTTP_SECUREPORT=9926 \
  -e CLUSTERING_ENABLED=true \               # 启用NATS集群
  -e CLUSTERING_USER=cluster_user \          # 集群认证用户名
  -e CLUSTERING_PASSWORD=cluster_password \  # 集群认证密码
  -e CLUSTERING_NODENAME=hdb1 \              # 集群节点名称
  -p 9925:9925 \
  -p 9926:9926 \
  -p 9932:9932 \                             # 映射集群通信端口
  harperdb/harperdb-openshift

4. 执行一次性命令（如查看版本）

bash
docker run --rm harperdb/harperdb-openshift /bin/bash -c "harperdb version"

参考文档与支持

• 官方文档：HarperDB文档中心
• Harper Studio：Web管理界面
• 技术支持：HarperDB支持服务
• API文档：REST接口文档 | Operations API文档