prp-htcondor-portal 镜像文档

1. 镜像概述

prp-htcondor-portal 是一个用于PRP（特定项目/平台）环境的Docker镜像，提供HTCondor门户功能。该镜像旨在简化用户对HTCondor集群的访问与管理，作为连接用户与HTCondor集群的中间层，实现作业提交、状态监控、资源查询等核心操作的统一入口。

2. 核心功能与特性

• HTCondor集群接入：通过标准HTCondor协议与后端集群建立连接，支持多种版本兼容性
• 作业生命周期管理：提供作业提交、查询、暂停、恢复及删除等全生命周期操作界面
• 资源监控：实时展示集群节点状态、资源利用率（CPU、内存、存储）及作业队列情况
• 用户认证集成：支持PRP环境下的用户认证机制，确保资源访问的安全性
• 轻量化部署：基于Docker容器化部署，简化依赖管理与环境配置

3. 使用场景

• PRP项目成员：作为项目内部用户访问HTCondor集群的标准化入口
• 科研工作者：提交、监控大规模计算作业，管理科研计算任务
• 集群管理员：简化集群资源监控与用户作业管理流程
• 开发测试环境：快速搭建HTCondor门户测试环境，验证作业流程

4. 使用方法

4.1 快速启动

通过以下命令快速启动容器（需替换示例参数）：

bash
docker run -d \
  --name prp-htcondor-portal \
  -p 8080:80 \
  -e HTCONDOR_COLLECTOR=collector.prp.example.com:9618 \
  -e PRP_AUTH_URL=[***] \
  -e PORTAL_LOG_LEVEL=info \
  prp-htcondor-portal:latest

容器启动后，通过 http://localhost:8080 访问门户界面。

4.2 环境变量配置

容器支持通过环境变量进行配置，常用参数如下：

4.3 Docker Compose配置

创建 docker-compose.yml 文件进行编排部署：

yaml
version: '3'
services:
  prp-htcondor-portal:
    image: prp-htcondor-portal:latest
    container_name: prp-htcondor-portal
    ports:
      - "8080:80"
    environment:
      - HTCONDOR_COLLECTOR=collector.prp.example.com:9618
      - PRP_AUTH_URL=[***]
      - PORTAL_LOG_LEVEL=info
    restart: unless-stopped
    volumes:
      - ./portal-logs:/var/log/prp-htcondor-portal  # 挂载日志目录（可选）

启动服务：

bash
docker-compose up -d

4.4 访问与操作

1. 容器启动后，通过浏览器访问 http://<主机IP>:8080
2. 使用PRP环境的用户凭证登录系统
3. 在作业管理界面提交新作业或查看现有作业状态
4. 通过资源监控页面查看集群整体运行情况

5. 注意事项

• 确保容器与HTCondor Collector之间网络通畅（默认需开放9618端口）
• 用户认证信息需符合PRP环境的安全策略要求
• 生产环境建议启用HTTPS并挂载持久化日志目录
• 大规模部署时建议结合负载均衡与高可用配置