nrel/boptest-worker

boptest-worker Docker镜像文档

概述

boptest-worker Docker镜像是一个专为运行boptest-worker工具设计的容器化解决方案，旨在提供隔离、便捷的优化测试任务执行环境。该镜像封装了boptest-worker的核心功能，支持任务调度、执行与监控，简化部署流程并确保跨环境的一致性。

核心功能与特性

• 环境隔离：通过容器化技术提供独立运行环境，避免依赖冲突，确保测试任务稳定执行
• 任务管理：支持优化测试任务的调度、启动、停止及状态监控，简化任务生命周期管理
• 资源控制：可配置CPU、内存等系统资源限制，适配不同规模的测试任务需求
• 日志集成：内置日志记录功能，支持日志输出至标准流或文件，便于任务执行过程追踪与问题排查
• 灵活部署：支持单机运行或与boptest主服务集成，适配分布式测试场景

使用场景

• 自动化测试环境：在开发或QA流程中，自动执行优化测试任务，提升测试效率
• 持续集成/持续部署（CI/CD）：集成至CI/CD流水线，作为测试环节执行单元测试或性能优化测试
• 分布式测试集群：作为工作节点加入分布式测试集群，分担大规模测试任务负载
• 本地开发调试：为开发人员提供一致的本地测试环境，减少"环境不一致"导致的测试问题

使用方法

前提条件

• 已安装Docker Engine（推荐20.10及以上版本）
• 网络环境可访问Docker镜像仓库（若使用私有仓库需配置认证）

获取镜像

从指定镜像仓库拉取最新版本镜像：

bash
docker pull [镜像仓库地址]/boptest-worker:latest

注：请将[镜像仓库地址]替换为实际的镜像仓库路径（如Docker Hub用户名或私有仓库地址）

基本运行命令

启动一个基础boptest-worker容器实例：

bash
docker run -d \
  --name boptest-worker-instance \
  -e TASK_ID=test-task-001 \
  -e LOG_LEVEL=info \
  -v /host/path/to/tasks:/app/tasks \
  -v /host/path/to/logs:/app/logs \
  [镜像仓库地址]/boptest-worker:latest

参数说明

环境变量配置

数据卷挂载

进阶配置示例

1. 与boptest主服务集成

当需要与boptest主服务通信时，通过BOPTEST_MASTER_URL指定主服务地址：

bash
docker run -d \
  --name boptest-worker-integrated \
  -e TASK_ID=ci-task-002 \
  -e LOG_LEVEL=debug \
  -e BOPTEST_MASTER_URL=http://boptest-master:8080 \
  -v ./local-tasks:/app/tasks \
  -v ./worker-logs:/app/logs \
  --network boptest-network \  # 加入与主服务相同的网络
  [镜像仓库地址]/boptest-worker:latest

2. docker-compose部署

创建docker-compose.yml文件实现多实例或服务编排：

yaml
version: '3.8'
services:
  boptest-worker:
    image: [镜像仓库地址]/boptest-worker:latest
    container_name: boptest-worker-node
    restart: unless-stopped
    environment:
      - TASK_ID=prod-test-task
      - LOG_LEVEL=info
      - WORKER_NAME=prod-worker-01
      - MAX_TASKS=2
      - BOPTEST_MASTER_URL=http://boptest-master:8080
    volumes:
      - ./tasks:/app/tasks:rw
      - ./logs:/app/logs:rw
    resources:
      limits:
        cpus: '1'
        memory: 1G
    networks:
      - boptest-net

networks:
  boptest-net:
    driver: bridge

启动服务：

bash
docker-compose up -d

注意事项

• 权限配置：挂载主机目录时，确保容器内用户对挂载目录有读写权限（可通过-u参数指定用户或调整主机目录权限）
• 资源调整：根据任务复杂度调整资源限制（如--cpus、--memory），避免资源不足导致任务失败
• 日志管理：长期运行场景建议配置日志轮转（如通过外部工具或容器日志驱动），防止日志文件占用过多磁盘空间
• 版本控制：生产环境建议使用固定版本标签（如:v1.0.0）而非latest，确保部署一致性