jfroula/aligner-bbmap

BBMap 运行环境 Docker 镜像

镜像概述

本镜像提供了运行 bbmap.sh 及相关生物信息学工具（如 Samtools）所需的完整运行环境。镜像基于 Ubuntu 22.04 构建，通过 Miniconda 管理依赖，专为 JAWS (Joint Genome Institute & Advanced Scientific Computing) 研讨会及高通量测序数据处理场景设计。

重要版本提示：

• V2.0.2 版本：包含用于 JAWS 研讨会的 script.sh 脚本。
• V2.0.3 及更高版本：已移除 script.sh 脚本，仅保留纯净的 BBMap 和 Samtools 运行环境。

核心功能与特性

• 预装核心工具：内置 BBMap（V2.0.3为38.99版本，V2.0.2为38.84版本）和 Samtools（V2.0.3为1.15.1版本，V2.0.2为1.11版本）。
• Conda 环境管理：使用 Miniconda 进行包管理，配置了 bioconda 和 conda-forge 频道，方便后续扩展安装其他生信工具。
• HPC 兼容性优化：Miniconda 安装在 /usr/local/bin/miniconda3 而非默认的 /root 目录，以确保在 Shifter 或 Singularity 等高性能计算（HPC）容器运行时中具有良好的路径访问权限。
• 标准化工作目录：默认工作目录设置为 /bbmap，方便挂载和处理测序数据。

使用场景

• JAWS 研讨会及相关的生物信息学培训。
• 高通量测序数据（如 DNA/RNA-Seq）的质控、比对和组装。
• 需要在 HPC 集群（通过 Shifter/Singularity）上运行 BBMap 流程的场景。

使用方法与配置说明

1. 运行容器 (Docker Run)

将本地数据目录挂载到容器的 /bbmap 工作目录中，并执行 BBMap 命令：

bash
docker run --rm -v /path/to/local/data:/bbmap <image_name>:<tag> bbmap.sh in=reads.fq out=mapped.sam ref=reference.fa

如果使用的是 V2.0.2 版本并需要运行内置的研讨会脚本：

bash
docker run --rm -v /path/to/local/data:/bbmap <image_name>:2.0.2 script.sh

2. Docker Compose 配置示例

对于需要持久化数据或复杂参数配置的场景，可以使用 docker-compose.yml：

yaml
version: '3.8'
services:
  bbmap:
    image: <image_name>:2.0.3
    volumes:
      - ./data:/bbmap
    working_dir: /bbmap
    command: >
      bbmap.sh 
      in=reads.fastq.gz 
      out=mapped.sam 
      ref=ref.fa 
      threads=8

3. 环境变量说明

镜像内置了以下关键环境变量，通常无需修改：

• CONDAPATH=/usr/local/bin/miniconda3：Miniconda 的安装路径。
• PATH：已自动将 $CONDAPATH/bin 加入系统路径，可直接调用 conda、bbmap.sh、samtools 等命令。
• DEBIAN_FRONTEND=noninteractive（仅限 V2.0.2）：防止在构建或运行期间出现交互式时区配置提示。

4. 扩展安装其他工具

如需在容器内安装额外的 Conda 包，可进入容器交互模式：

bash
docker run --rm -it <image_name>:<tag> /bin/bash
# 在容器内执行
conda install -c bioconda <package_name>