phatblinkie/ogs

ogs test 镜像文档

概述

ogs test镜像是一个专为测试OGS（Open Game Server或其他相关系统/服务）功能和服务设计的Docker镜像。该镜像封装了测试所需的基础环境、依赖组件及配置模板，旨在为开发人员和测试人员提供便捷、一致的测试环境，简化OGS相关功能的测试流程。

核心功能与特性

• 环境隔离：通过Docker容器化技术，提供独立的测试环境，避免与本地环境冲突。
• 依赖集成：内置OGS测试所需的基础依赖组件，无需手动配置。
• 便捷配置：支持通过环境变量或配置文件自定义测试参数，灵活适配不同测试场景。
• 轻量高效：基于精简基础镜像构建，体积小，启动速度快，资源占用低。

使用场景

• 开发阶段测试：开发人员在本地验证OGS组件功能、接口兼容性及业务逻辑正确性。
• 自动化测试：集成到CI/CD流程中，作为自动化测试环节的执行环境，确保代码提交前的功能验证。
• 多版本兼容性测试：通过调整配置，快速切换测试环境，验证OGS不同版本的兼容性。

使用方法与配置说明

基本使用（docker run）

通过以下命令启动ogs test容器：

bash
docker run -d --name ogs-test-container ogs-test:latest

自定义配置

可通过环境变量调整测试参数，常用环境变量说明：

• TEST_MODE：测试模式，可选值为unit（单元测试）、integration（集成测试），默认值为unit。
• OGS_VERSION：指定测试的OGS版本，如v1.0.0，默认使用最新版本。
• LOG_LEVEL：日志级别，可选info、debug、warn、error，默认info。

示例（指定集成测试模式及OGS版本）：

bash
docker run -d \
  --name ogs-test-integration \
  -e TEST_MODE=integration \
  -e OGS_VERSION=v1.0.0 \
  ogs-test:latest

挂载测试用例（可选）

如需使用自定义测试用例，可通过挂载本地目录到容器内/tests路径：

bash
docker run -d \
  --name ogs-test-custom \
  -v /local/tests:/tests \
  ogs-test:latest

查看测试日志

通过以下命令查看容器内测试日志：

bash
docker logs -f ogs-test-container

注意事项

• 确保Docker环境版本不低于19.03，以支持容器所需的特性。
• 测试过程中如需网络访问外部服务，需根据实际情况配置容器网络（如--network参数）。
• 对于大规模测试场景，建议结合docker-compose进行多容器协同测试。