xyliucd/ascow

1 项目简介

1.1 声明

本项目开发和运维团队为中国工程物理研究院成都科学技术发展中心第四研究室，是基于https://github.com/PKUHPC/OpenSCOW%E5%92%8CABHPC%E5%8D%95%E5%B1%82RDMA%E7%BD%91%E7%BB%9C%E6%97%A0%E7%9B%98%E8%B6%85%E7%AE%97%E9%9B%86%E7%BE%A4%E5%BC%80%E5%8F%91%E7%9A%84%E7%94%A8%E6%88%B7%E4%B8%8E%E7%AE%A1%E7%90%86%E9%97%A8%E6%88%B7%E7%B3%BB%E7%BB%9F%EF%BC%8C**%E5%90%8C%E6%97%B6%E4%B9%9F%E9%80%82%E9%85%8D%E4%BA%8E%E9%87%87%E7%94%A8Slurm%E8%B0%83%E5%BA%A6%E7%B3%BB%E7%BB%9F%E7%9A%84%E9%9B%86%E7%BE%A4**%EF%BC%8C%E6%97%A8%E5%9C%A8%E5%B0%86%E8%AF%A5%E6%A1%86%E6%9E%B6%E5%B9%BF%E6%B3%9B%E5%BA%94%E7%94%A8%E4%BA%8E%E7%A7%91%E7%A0%94%E3%80%81%E6%95%99%E8%82%B2%E5%92%8C%E5%B7%A5%E7%A8%8B%E8%A1%8C%E4%B8%9A%E3%80%82

按照木兰宽松协议v2要求，本项目更名为ASCOW且不开源，以保障OpenSCOW的商标权，但发布的公共镜像允许任意用户下载并免费使用，本项目的基础配置文件和OpenSCOW完全兼容(可参考https://pkuhpc.github.io/OpenSCOW/docs/deploy)%EF%BC%8C%E5%A2%9E%E5%8A%A0%E7%9A%84%E9%83%A8%E5%88%86%E5%AD%97%E6%AE%B5%E5%8F%AF%E5%8F%82%E8%80%83%E6%9B%B4%E6%96%B0%E6%97%A5%E5%BF%97%E8%AF%B4%E6%98%8E%E3%80%82

本系统完全沿用OpenSCOW框架，感谢北京大学OpenSCOW开发团队的无私贡献，向他们致敬！

本系统推荐使用https://github.com/abhpc/abhpc-scow-slurm-adapter%EF%BC%8C%E5%8F%AF%E9%81%BF%E5%85%8D%E4%BA%A4%E4%BA%92%E5%BC%8F%E4%BD%9C%E4%B8%9A%E4%B8%AD%E6%96%87%E4%B9%B1%E7%A0%81%E5%92%8CGPU%E8%B5%84%E6%BA%90%E5%88%86%E9%85%8D%E7%AD%89%E9%97%AE%E9%A2%98%EF%BC%8C%E8%BF%98%E5%8F%AF%E5%AE%9E%E7%8E%B0%E5%9F%BA%E4%BA%8E%60Environment Module`的模块调用统计。

1.2 技术合作和研讨

本项目欢迎任意形式的技术合作和研讨，可联系四室主任刘晓毅(邮件：)和计算组组长徐云飞博士(邮件：)。

2 版本说明和使用方法

2.1 历史版本说明

20250901版本起，ND和SAND功能均在通用版本中实现，因此这两个版本不再更新，后续只更新通用版本。

latest-ND：禁用下载版本(已合并到通用版本)

latest-SAND: 单点登录且禁用下载版本(已合并到通用版本)

2.2 使用方法

首先拉取镜像：

bash
docker pull xyliucd/ascow:latest

使用scow-cli生成docker-compose.yml文件：

bash
./cli generate

替换为ascow镜像:

bash
sed -i s "@mirrors.pku.edu.cn/pkuhpc-icode/scow:v1.6.4@xyliucd/ascow:latest@g" docker-compose.yml

启动容器：

bash
docker compose up -d

3 更新日志(按日期倒序排列)

• 20251201：去掉夜晚模式。
• 20251114：优化作业->提交作业页面布局，新增保存为模板前的命名：
• 20251110：调整了作业—>提交作业页面的布局。
• 20251109：优化管理员界面的作业显示列表，给用户名和账户加上中文备注，方便识别用户和单位。
• 20251105：在文件目录选择框中新增上传文件和新文件按钮：
• 20251104：优化用户列表显示
• 20251101：优化账户列表显示
• 20251031：增加应用搜索栏。账户备注变为可编辑。
• 20251027：增加用户单位信息，需要在auth.yml中添加单位信息：

yml
  ldap:
  attrs:
    uid: uid
    name: cn
    mail: mail
    affiliation: description #新加的

修正了修改文件时，改变文件权限的Bug

• 20251020：修复导入用户管理界面显示姓名为userID的问题，正常应显示为LDAP中的中文名。
• 20251011：美化界面。
• 20251009：优化NGINX的websockets超时参数，避免VNC经常断线的问题。
• 20250928：优化图标显示，增加最大作业时长统计。优化筛选时间。
• 20250924：修正了不正确显示用户登录IP的Bug。优化了应用同步页面，如下所示：
• 20250923：优化应用加载页面在APP数量较多时载入缓慢的问题，采用redis缓存机制。
• 20250919：新增图表统计，可导出数据做详细分析。优化portal-web的并发度，实现基于pm2的Nginx负载均衡。
• 20250917：优化portal-web和portal-server的并发度，全部采用pm2 cluster来实现高并发度。
• 20250916：修改最大导出条目为50000条(原来设计为***条)。应用图标大小默认修改为小。优化计算资源统计表显示。
• 20250914：新增计算资源统计板块，可统计不同module核时情况：
• 20250910：限制前后缀为slm.*、*.slm、*.sh、*.bash、*.slurm、slurm.*六种文件可提交，其他文件不可提交。
• 20250909：新增已完成作业应用模块的csv导出功能，以统计不同软件模块的机时占比。
• 20250906：保存用户作业调取Environment Module记录，便于后期做软件使用分析。如用户主节点未配置Environment Module记录器，则记录值为unknown。需要配合最新的https://github.com/abhpc/abhpc-scow-slurm-adapter%E4%BD%BF%E7%94%A8%EF%BC%8C%E5%8F%82%E8%A7%81https://github.com/abhpc/abhpc-scow-slurm-adapter/blob/main/image/README/1757250643455.png%EF%BC%9A
• 20250901：ND和SAND版本合并到通用版本中来。其中，单点登录在auth.yml文件中新增以下字段实现单点登录：

yml
singleSession: on  # on为开通单点登录，off为关闭单点登录

通过在portal.yml文件中增加以下字段实现文件下载权限控制：

yml
# 是否允许文件下载
file:
  download:
    enable: false
    #enableAccounts: account1,account2,account3
    #enableUsers: user1,user2,user3
    # enable为true的情况下，禁止哪些账户或用户下载
    #disableAccounts: account1,account2,account3
    #disableUsers: user1,user2

• 20250829：忽略config/apps/*.yml的错误配置，避免某个交互式应用配置出错时，整个集群报500错误。新增交互式应用的图标大小调整。
• 20250827：在交互式应用的yml文件(config/apps/*.yml)中增加visible字段，使交互式应用可设置为公开或部分账户、用户可见。

yml
visible:
  public: no                   # 如果public值为yes，则所有用户可见
  allow_accounts: caep,mechx   # 如果public为no，allow_accounts中账户下的所有用户可见APP
  allow_users: user1,uesr2     # 如果public为no，allow_users中的用户可见APP

• 20250826：增加了Portal的pm2并发性能，解决交互式应用在线用户数大于20时系统崩溃的问题。修改文件和文件夹的图标，以方便区分文件夹和文件。文件选择器默认路径设置为用户家目录，而不是根目录/。ND版本：禁用文件下载，适用于特殊教学或培训场景。SAND版本：增加用户单点登录功能，禁用同一账户在不同电脑上登录，且禁止用户下载文件。VNC单点登录和分辨率优化：禁用VNC多点登录，初始分辨率设置为3840x2160以避免部分程序窗口无法放大。交互式应用新增文件和目录选择器，以支持基于后台的非交互式应用，例如：

yml
attributes:
  - type: file
    name: input
    label: 输入文件
    required: true
    placeholder: "比如：/home/user/fds/test.fds"

新增目录链接识别，可在交互式应用中直接链接到用户算例目录。优化资源选择，默认CPU和GPU核数独立设置，以方便用户选择资源。