---
title: 使用HPCRunner一键构建镜像
description: "- 待构建镜像的节点已挂载配置YUM源。"
url: https://www.hikunpeng.com/document/detail/zh/kunpenghpcs/hpcindapp/prtg-osc/topic_0000002500006673.html
sourcePath: /source/zh/kunpenghpcs/hpcindapp/prtg-osc/topic_0000002500006673.html
indexId: 15d2134785a40ce5184196dc3a121309369d88c3e2d815638dc1975048b7301e69
---
# 使用HPCRunner一键构建镜像

#### 前置条件

- 待构建镜像的节点已挂载配置YUM源。
  YUM源挂载配置建议使用全量的ISO Everything包。

- 待构建镜像的节点需要服务器有外网权限。如无外网权限请先配置外网权限或外网代理。


#### 安装步骤

1. 使用PuTTY工具，以root用户登录节点。
2. 安装基础依赖包。执行如下命令：
  yum -y install git time zlib zlib-devel gcc gcc-c++ environment-modules python python3 python3-devel python3-libs python3-pip cmake make numactl numactl-devel numactl-libs rpmdevtools wget libtirpc libtirpc-devel unzip flex tar patch glibc-devel rpcbind csh perl-XML-LibXML xorg-x11-xauth curl curl-devel libcurl-devel libxml2-devel

3. 克隆仓库。如已通过手动下载了贾维斯智能助手（HPCRunner），则忽略该步骤，否则执行如下命令：
  git clone https://gitcode.com/openeuler/hpcrunner.git

  回显结果包含如下示例内容，表示HPCRunner克隆成功：

```
Cloning into 'hpcrunner'...
remote: Enumerating objects: 13018, done.
remote: Counting objects: 100% (171/171), done.
remote: Compressing objects: 100% (142/142), done.
remote: Total 13018 (delta 89), reused 57 (delta 23), pack-reused 12847 (from 1)
Receiving objects: 100% (13018/13018), 72.71 MiB | 2.57 MiB/s, done.
Resolving deltas: 100% (6150/6150), done.
```


4. 初始化HPCRunner。执行如下命令：
  cd hpcrunner

  source init.sh

5. 安装go。执行如下命令：
  ./jarvis -install go/1.18 com

  回显结果包含如下示例内容，表示go安装成功：

```
SUCCESSFULLY EXECUTED AT 2025-10-13 09:51:31, CONGRATULATIONS!!!
```


  若网络条件不佳或在线下载较慢，可提前将go软件的安装包提前下载至HPCRunner的downloads目录,以避免解压或编译安装失败。 go软件的下载地址为：https://go.dev/dl/go1.18.linux-arm64(https://go.dev/dl/go1.18.linux-arm64)

6. 配置加载go环境变量。执行如下命令：
  module load ${JARVIS_ROOT}/software/modulefiles/go/1.18

  无回显结果表示正常。

7. 安装singularity。执行如下命令：
  ./jarvis -install singularity/3.9.6 any

  回显结果包含如下示例内容，表示singularity安装成功：

```
SUCCESSFULLY EXECUTED AT 2025-10-13 09:55:31, CONGRATULATIONS!!!
```


  若网络条件不佳或在线下载较慢，可提前将singularity软件的安装包提前下载至HPCRunner的downloads目录,以避免解压或编译安装失败。 singularity软件的下载地址为：https://github.com/sylabs/singularity/releases/download/v3.9.6/singularity-ce-3.9.6.tar.gz(https://github.com/sylabs/singularity/releases/download/v3.9.6/singularity-ce-3.9.6.tar.gz)

8. 配置加载singularity环境变量。执行如下命令：
  module load ${JARVIS_ROOT}/software/modulefiles/singularity/3.9.6

  无回显结果表示正常。

9. 使用singularity构建镜像。执行如下命令：
  singularity build ${HOME}/openeuler-gcc-ecFlow-5.5.2.sif container/ecFlow/5.5.2/openeuler-gcc-ecFlow-5.5.2.def

  回显结果包含如下示例内容，表示镜像构建成功：

```
SUCCESSFULLY EXECUTED AT 2025-10-14 08:16:21, CONGRATULATIONS!!!
INFO:    Adding labels
INFO:    Adding environment to container
INFO:    Creating SIF file...
INFO:    Build complete: ${HOME}/openeuler-gcc-ecFlow-5.5.2.sif
```


  运行“singularity build”命令需要服务器有外网权限。 ${HOME}/openeuler-gcc-ecFlow-5.5.2.sif 表示生成的.sif文件保存到当前用户家目录。

10. 运行测试生成的镜像。执行如下命令：
  singularity exec ${HOME}/openeuler-gcc-ecFlow-5.5.2.sif ecflow_client --version

  回显结果包含如下示例内容，表示运行测试成功：

```
Ecflow version(5.5.2) boost(1.72.0) compiler(gcc 10.3.1) protocol(JSON cereal 1.3.0) openssl(enabled) Compiled on Oct  9 2025 19:58:29
```


  如遇到文件系统只读的权限问题可加参数--writable-tmpfs执行，执行如下命令： singularity exec --writable-tmpfs ${HOME}/openeuler-gcc-ecFlow-5.5.2.sif ecflow_client --version


#### 运行和验证

可通过源码包自带的shell脚本进行集成测试，以下骤为测试步骤。

1. 执行以下命令在容器中切换到ecFlow的源码单元测试用例目录并执行单元测用例（容器所在路径和ecFlow软件目录可根据实际情况调整）：
  singularity exec ${HOME}/openeuler-gcc-ecFlow-5.5.2.sif bash -c 'cd ${JARVIS_TMP}/ecFlow-5.5.2-Source/build && make test'

2. 用例执行结果查看，如图1所示。