hpc-sdk

欧洲材料-MarketPlace HPC应用程序的SDK

通过MarketPlace代理与HPC交互

通过SDK使用/集成HPC网关应用程序

此存储库提供SDK，用于使用或集成HPC网关应用程序到其他MarketPlace应用程序中。

首先，使用以下命令创建一个 hpc 实例

python

from marketplace_hpc import HpcGatewayApp

hpc = HpcGatewayApp(
    client_id=<app_id>, # This is the HPC gateway app.
    access_token=<your_access_token>,
)

以下功能受支持，可以使用SDK调用。

• 检查系统可用性： hpc.heartbeat()
• 创建新的计算： hpc.new_job()，资源id将返回到远程工作目录中列出文件，上传/下载/删除文件以及启动/删除作业。
• 上传文件： hpc.upload_file(resourceid=<resourceid>, source_path=<file_local_path>).
• 下载文件： hpc.download_file(resourceid=<resourceid>, filename=<filename>).
• 删除文件： hpc.delete_file(resourceid=resourceid, filename=<filename>)
• 列出作业（仅CSCS部署）： hpc.list_jobs().
• 启动作业： hpc.run_job(resourceid=<resourceid>)
• 删除作业： hpc.delete_job(resourceid=resourceid)

您可以在以下位置找到示例： https://github.com/materials-marketplace/hpc-sdk/blob/main/hpc_api.ipynb

材料云（CSCS）部署

相应的HPC-Gateway应用程序是部署在生产服务器上的 https://www.materials-marketplace.eu/app/hpc-app（ID： 5fd66c68-50e9-474a-b55d-148777ae3efd）。

由于它是使用EPFL提供的Materials Cloud CSCS资源部署的，因此仅供测试目的，并希望使用它的MarketPlace用户需要联系Jusong Yu @unkpcz（jusong.yu@epfl.ch）以将您的MarketPlace账户添加到白名单，然后通过以下方式注册账户：

curl -X POST \
   -H "Authorization:Bearer <put_your_token_here>" \
   'https://mp-hpc.herokuapp.com/user'

IWM部署

对应的HPC-Gateway应用程序是HPC网关（代理）（ID: dc67d85e-7945-49fa-bf85-3159a8358f85），它部署在预发布服务器上，因为需要RPC代理服务器。

对于维护者

要创建新版本，克隆存储库，使用pip install '.[dev]'安装开发依赖项，然后执行bumpver update。这将：

1. 创建一个带有增加版本的标签版本并将其推送到存储库。
2. 触发一个创建GitHub版本的GitHub操作工作流程。

附加说明

• 使用--dry选项预览发布更改。
• 发布标签（例如a/b/rc）由最后一个版本确定。使用--tag选项切换发布标签。

致谢

这项工作得到了由Horizon 2020资助的MARKETPLACE项目的支持，该项目是在H2020-NMBP-25-2017征集（项目编号760173）下进行的。