e1039/e1039-sl7

e1039-docker

概述

e1039-docker是e1039软件环境的Docker镜像，旨在提供一个干净且确保能正常工作的e1039软件运行环境。该镜像已在Ubuntu、CentOS和Mac OS X系统上测试通过，理论上也支持Windows 10（需专业版以运行Docker）。

核心功能与特性

• 隔离环境：提供与主机系统隔离的软件环境，避免对主机系统造成干扰
• 无外部依赖：用户无需依赖FNAL或E1039的计算资源即可使用
• 多容器支持：可基于同一镜像创建多个完全独立的容器
• 一键初始化：容器首次启动时自动执行初始化流程（5-10分钟），将最新e1039软件安装至/opt/e1039目录
• 环境配置便捷：提供/opt/e1039/this-e1039.sh环境设置脚本，快速配置工作环境
• GUI支持：可显示ROOT等图形界面
• 多终端支持：支持单个容器同时连接多个终端

使用场景

• 普通用户：在个人计算机上快速搭建e1039软件环境，无需配置复杂依赖
• 开发者：在隔离环境中开发和测试新功能，避免影响主机系统的分析工作

安装与配置

Docker安装

参考Docker官方文档进行安装：[***]

性能说明：Linux系统上Docker资源占用低，性能接近 bare metal；Mac和Windows系统因运行在虚拟化层，会有额外性能开销。

拉取镜像

软件团队会在每次发布（合并主要PR）时构建镜像。最新PR编号为78，拉取该版本镜像的命令如下（需确保Docker已配置为非特权访问）：

bash
docker pull e1039/e1039-sw:pr78

镜像下载大小约1.5GB，下载时间取决于网络速度。

使用方法

创建容器

镜像下载完成后，可通过docker images命令查看本地镜像。e1039软件镜像的仓库名为e1039/e1039-sw，不同版本通过标签区分。创建并启动PR78版本容器的命令：

bash
docker run -it e1039/e1039-sw:pr78

容器启动后，环境类似于运行Scientific Linux 7且已安装e1039软件的远程服务器。默认用户名为e1039（具有sudo权限），密码为spinquest。

典型使用流程

bash
# 加载e1039环境
e1039@docker ~: source /opt/e1039/this-e1039.sh
Using E1039-CORE = /opt/e1039/core

# 克隆分析代码仓库
e1039@docker ~: git clone https://github.com/E1039-Collaboration/e1039-analysis.git

# 运行模拟任务
e1039@docker ~: cd e1039-analysis/SimChainDev
e1039@docker ~: root -l -b -q Fun4Sim.C\(100\)

完成工作后，输入exit退出容器，容器将停止但文件会保留（类似关闭虚拟机）。

重新连接已停止的容器

1. 通过docker ps -a命令获取所有容器状态，第一列的12位哈希码即为容器ID
2. 若容器已停止（STATUS列显示已停止），先启动容器：

   bash
   docker container start <容器ID>
   

3. 连接到容器：

   bash
   docker container attach <容器ID>
   

实用技巧

显示GUI（如ROOT绘图）

bash
docker run -it -e DISPLAY=$DISPLAY -v /tmp/.X11-unix:/tmp/.X11-unix e1039/e1039-sw:pr78

单个容器运行多个终端

1. 以分离模式启动容器：

   bash
   docker run -it -d e1039/e1039-sw:pr78
   

2. 通过docker ps -a获取容器ID
3. 启动额外终端：

   bash
   docker exec -it <容器ID> bash
   

参考文档

更多Docker详细文档请访问：[***]