OSG Compute Entrypoint for HTCondor 镜像文档

镜像概述和主要用途

该镜像为OSG（Open Science Grid）计算基础设施提供标准化入口点，专门用于对接HTCondor分布式任务调度系统。作为OSG计算节点的核心组件，它负责协调计算节点与HTCondor集群的通信，处理任务的接收、执行、状态反馈及资源管理，确保科学计算任务在分布式环境中高效、可靠运行。

核心功能和特性

• HTCondor协议集成：原生支持HTCondor通信协议，可无缝接入HTCondor集群，实现任务调度指令的解析与执行。
• OSG环境标准化：内置OSG计算节点所需的基础配置与依赖，简化集群部署流程，确保环境一致性。
• 任务生命周期管理：支持任务启动、运行监控、异常处理及资源回收，保障任务完整生命周期的可控性。
• 资源动态适配：可根据节点CPU、内存等硬件资源自动调整任务处理能力，优化资源利用率。
• 日志与监控集成：提供任务执行日志与节点状态监控接口，便于问题排查与集群性能优化。

使用场景和适用范围

• 科学计算集群：适用于高校、科研机构部署OSG计算节点，接入HTCondor调度系统处理大规模科学计算任务（如数据分析、模拟仿真等）。
• 分布式任务处理：用于需要跨节点协同执行的计算场景，支持多任务并行处理与资源动态分配。
• OSG基础设施扩展：作为标准化组件，支持OSG计算集群的快速扩容与节点统一管理。

使用方法和配置说明

前提条件

• Docker引擎（20.10+版本）
• 网络可访问HTCondor集群控制节点
• 计算节点需满足OSG基础资源要求（建议至少2 CPU核心、4GB内存）

镜像拉取

bash
docker pull <镜像仓库地址>/osg-compute-entrypoint-htcondor:latest

基础运行示例

bash
docker run -d \
  --name osg-condor-entrypoint \
  --network host \  # 推荐使用主机网络以确保HTCondor通信稳定性
  -e CONDOR_HOST=condor-master.example.com \  # HTCondor控制节点地址
  -e NODE_NAME=osg-compute-01 \  # 计算节点唯一标识
  -e RESOURCE_CPUS=4 \  # 分配CPU核心数
  -e RESOURCE_MEMORY=8G \  # 分配内存大小
  <镜像仓库地址>/osg-compute-entrypoint-htcondor:latest

环境变量配置

持久化存储配置

如需持久化日志或自定义配置，可挂载本地目录：

bash
docker run -d \
  --name osg-condor-entrypoint \
  --network host \
  -e CONDOR_HOST=condor-master.example.com \
  -e NODE_NAME=osg-compute-01 \
  -v /local/osg/logs:/var/log/osg-entrypoint \  # 日志持久化
  -v /local/osg/config:/etc/osg-entrypoint \    # 自定义配置文件
  <镜像仓库地址>/osg-compute-entrypoint-htcondor:latest

状态检查与管理

• 查看容器运行状态：

  bash
  docker ps --filter "name=osg-condor-entrypoint"
  

• 查看任务执行日志：

  bash
  docker logs osg-condor-entrypoint
  

• 检查HTCondor节点注册状态（需容器内安装condor客户端）：

  bash
  docker exec -it osg-condor-entrypoint condor_status -node $NODE_NAME
  

注意事项

• 网络配置：建议使用--network host模式以避免端口映射导致的通信问题。
• 资源限制：根据实际硬件配置调整RESOURCE_CPUS和RESOURCE_MEMORY，避免资源超配。
• 集群兼容性：需确保镜像版本与HTCondor集群版本兼容（推荐HTCondor 8.8+）。