云生信学生物信息学

Docker 或 Apptainer 跑生信流程:固定镜像并正确挂载数据

作者:发布于 2026-11-19更新于 2026-11-15约 5 分钟阅读
固定容器镜像与挂载

固定容器镜像与挂载:记录tag、digest或SIF校验;输入只读,工作与输出分盘;在容器内核对路径和权限;小样本跑通后保存日志
本文操作与检查路径示意。

容器能固定软件和依赖版本,但不会自动把宿主机数据放进容器,也不代表程序已经具备合适的CPU、内存或GPU额度。运行生信流程前,先固定镜像版本,再明确宿主机输入、临时目录和输出分别映射到容器内哪里,并用小样本验证读写和权限。

固定镜像身份,不使用漂移标签

镜像名加latest可能随时间变化。Docker文档支持按tag或内容digest引用镜像;为正式运行记录仓库、tag、digest、拉取日期和启动命令。Apptainer的SIF文件也应记录来源和SHA256。镜像固定只控制用户空间环境,宿主机内核、GPU驱动、挂载目录和资源限制仍需另行记录。

路径 容器内用途 建议权限
/project/input 原始FASTQ、FASTA或参考文件 只读
/project/work 临时文件、排序缓存、索引 读写并单独估算空间
/project/output 最终结果和日志 读写、独立目录
容器内部临时层 临时运行但退出后可能消失 不要放唯一结果

明确挂载并先检查容器内路径

Docker使用bind mount将宿主机目录映射到容器路径。输入可以只读挂载,工作目录和输出分别挂载。以Docker为例,替换经确认的目录与镜像digest;工具命令需换成项目实际入口。

docker run --rm \
  --user "$(id -u):$(id -g)" \
  -v /data/project/input:/project/input:ro \
  -v /scratch/job123/work:/project/work:rw \
  -v /results/job123:/project/output:rw \
  -w /project/work \
  registry.example.org/bio/tool@sha256:REPLACE_WITH_VERIFIED_DIGEST \
  sh -lc 'test -r /project/input/sample.fa && touch /project/output/.write-test && my_tool --input /project/input/sample.fa --output /project/output/result'

在真实任务前先运行只读检查和输出目录写入测试,确认运行用户的UID/GID在宿主机有相应权限。不要通过容器内root身份随意创建文件,否则结果可能归属root,课题组用户无法读取。若目录属于组共享,按管理员约定设置组权限和umask。退出前删除测试文件,真正结果保存在宿主机挂载的输出盘。

Apptainer挂载同样要显式核对

在集群上常用Apptainer/Singularity。官方文档允许用--bind指定源目录、容器目标路径和ro/rw选项,但管理员可禁用用户自定义挂载,系统也可能自动挂载home和当前目录。不要假设文件能被自动看见;在执行分析前打印容器内目录、确认输入文件存在且输出路径可写。

apptainer exec \
  --bind /data/project/input:/project/input:ro \
  --bind /scratch/job123/work:/project/work:rw \
  --bind /results/job123:/project/output:rw \
  tool.sif sh -lc 'id; ls -l /project/input; touch /project/output/.write-test'

验证资源、临时文件和输出

用小样本完整跑一次,记录退出码、容器日志、镜像摘要、宿主机挂载路径、工作目录峰值、内存/CPU额度和输出清单。输入目录只读可以防止误改原始数据;工作盘应有足够临时空间,尤其是BAM排序、解压和数据库索引步骤。若临时目录落到容器可写层,需确认它是否有容量限制及退出后的保存行为。容器内部工具可见GPU不等于GPU计算一定被调用,需依据工具日志和运行期间监控检查。

交付时保留镜像digest或SIF校验值、挂载映射、完整命令、环境变量、日志、输入输出校验值和资源记录。失败时先区分镜像/依赖错误、挂载缺失、权限拒绝、磁盘空间不足和资源超限,再改对应设置。容器能复现软件栈,但仍需维护数据清单、分析参数和参考库版本。

参考资料

下载练习材料

下载教程 PDF · 下载代码与示例数据 ZIP

先核对包内SHA256清单,再在独立目录复现。

需要额外算力时

适用前提:已有镜像或可容器化流程,运行资源不足。如需额外资源,可评估服务器租赁及按需环境部署。咨询时说明软件版本、任务规模和使用期限,配置与支持范围另行确认。

咨询本任务的服务器配置

咨询本任务的服务器配置

留下手机号,我们会结合本文任务与您沟通服务器配置和报价。

也可联系云生信企业微信客服,说明本文任务。

把知识用于当前任务

下一步可以直接开始分析

按研究目标查找在线工具、课程、计算资源或完整分析服务。

按目标找方案仍有疑问,联系客服 ↗