ldmx/pro Docker 镜像 - 轩辕镜像

ldmx-sw生产镜像

镜像概述和主要用途

本镜像提供预编译版本的ldmx-sw，基于ldmx/dev镜像构建，适用于生产环境中运行ldmx-sw应用。镜像通过固定入口点为fire命令，简化了应用执行流程，用户只需提供配置文件或参数即可运行。

核心功能和特性

• 预编译环境：内置预编译的ldmx-sw，无需用户手动编译
• 固定入口点：默认执行fire命令，专注于运行ldmx-sw应用
• 灵活挂载：支持挂载本地工作目录，方便访问配置文件
• 多平台支持：兼容Docker和Singularity容器平台

使用场景和适用范围

适用于需要在生产环境中快速部署和运行ldmx-sw应用的场景，尤其适合需要执行Python配置文件或传递参数运行ldmx-sw的用户。

使用方法和配置说明

Docker使用

1. 拉取最新镜像

bash
docker pull ldmx/pro

2. 设置便捷运行别名

建议定义bash别名简化运行命令（或直接复制使用）：

bash
alias ldmx-pro='docker run --rm -it -u $(id -u ${USER}):$(id -g ${USER}) -v $(pwd):$(pwd) ldmx/pro $(pwd)'

• --rm：容器退出后自动删除
• -it：交互式终端
• -u：指定当前用户ID和组ID，避免权限问题
• -v：挂载当前工作目录到容器内相同路径

3. 运行配置文件

使用定义的别名运行配置文件：

bash
ldmx-pro config.py

镜像详情

本镜像基于ldmx/dev镜像构建，与开发镜像的主要区别在于入口点更严格：开发镜像允许用户自定义运行命令，而生产镜像固定使用fire命令。运行时会自动挂载并进入当前工作目录，然后执行用户提供的配置文件或参数。

Singularity使用

1. 定义镜像名称

将myTag替换为实际可用的镜像标签：

bash
export LDMX_PRODUCTION_IMG=$(pwd -P)/ldmx_production_myTag.sif

2. 构建Singularity镜像

从Docker Hub下载并转换为Singularity格式：

bash
singularity build ${LDMX_PRODUCTION_IMG} docker://ldmx/pro:myTag

3. 设置便捷运行别名

bash
alias ldmx-pro='singularity run --no-home ${LDMX_PRODUCTION_IMG} .'

• --no-home：不挂载用户主目录

4. 运行配置文件

bash
ldmx-pro config.py

注：Singularity默认自动挂载当前目录并以交互模式运行，因此所需配置选项少于Docker。