palaeontologyhelsinki/rnames_staging

RNames Staging Docker镜像文档

概述

RNames Staging是一个专为名称管理服务设计的暂存环境Docker镜像。该镜像提供了名称解析、名称管理及相关功能的完整测试环境，旨在支持开发团队在开发和测试阶段对名称服务功能进行验证与集成测试。

核心功能与特性

• 提供完整的名称服务暂存环境
• 支持名称解析和管理功能测试
• 包含开发和测试所需的全部依赖组件
• 配置灵活，易于集成到开发工作流中
• 支持数据持久化，便于测试场景的复现

使用场景

• 开发阶段的名称服务功能测试
• 集成测试环境中的名称服务组件部署
• 名称服务相关功能的原型验证
• 开发团队的本地开发环境搭建

使用方法

基本使用

使用以下命令启动RNames Staging容器：

bash
docker run -d --name rnames-staging -p 8080:8080 docker.xuanyuan.run/rnames-staging:latest

环境变量配置

该镜像支持以下环境变量配置：

• LOG_LEVEL: 日志级别，默认为INFO，可选值：DEBUG, INFO, WARN, ERROR
• PORT: 服务监听端口，默认为8080
• DATABASE_URL: 数据库连接URL，用于配置持久化存储
• CACHE_TTL: 缓存过期时间，单位为秒，默认为3600

示例：

bash
docker run -d --name rnames-staging \
  -p 8080:8080 \
  -e LOG_LEVEL=DEBUG \
  -e DATABASE_URL=sqlite:///rnames.db \
  docker.xuanyuan.run/rnames-staging:latest

Docker Compose配置

以下是一个基本的docker-compose.yml配置示例：

yaml
version: '3'
services:
  rnames-staging:
    image: docker.xuanyuan.run/rnames-staging:latest
    ports:
      - "8080:8080"
    environment:
      - LOG_LEVEL=INFO
      - PORT=8080
      - DATABASE_URL=sqlite:///rnames.db
    volumes:
      - rnames-data:/data

volumes:
  rnames-data:

数据持久化

为了保持测试数据的持久性，可以通过挂载卷的方式持久化数据目录：

bash
docker run -d --name rnames-staging \
  -p 8080:8080 \
  -v ./rnames-data:/data \
  docker.xuanyuan.run/rnames-staging:latest

访问服务

服务启动后，可以通过以下地址访问RNames Staging服务：

• 服务端点: http://localhost:8080
• API文档: http://localhost:8080/swagger-ui.html (如支持)

注意事项

• 该镜像仅用于开发和测试环境，不适用于生产环境
• 暂存环境数据可能会定期清理，请不要存储重要数据
• 在生产环境中请使用正式版本的RNames镜像

维护与更新

• 定期拉取最新镜像以获取功能更新和安全补丁
• 通过监控日志文件排查服务运行问题
• 根据测试需求调整环境变量配置

故障排除

如遇到服务启动问题，可通过以下命令查看容器日志：

bash
docker logs rnames-staging