sanogenetics/htslib-bcftools-samtools

docker-htslib-bcftools-samtools

镜像概述和主要用途

本镜像基于https://aws.amazon.com/amazon-linux-2%E6%9E%84%E5%BB%BA%EF%BC%8C%E9%9B%86%E6%88%90%E4%BA%86http://www.htslib.org/%E3%80%81bcftools%E3%80%81samtools%E5%B7%A5%E5%85%B7%E4%BB%A5%E5%8F%8AAWS CLI。主要用于处理高通量测序数据文件（如VCF、BAM等格式），并支持通过S3存储服务读取和写入文件。

核心功能和特性

• 基础环境：基于amazonlinux:2操作系统，提供稳定的运行环境
• 核心工具集：
  • htslib：处理高通量测序数据格式的基础库
  • bcftools：用于处理VCF/BCF格式变异数据的工具
  • samtools：用于处理SAM/BAM格式序列比对数据的工具
• AWS集成：包含AWS CLI工具，支持与AWS服务交互
• S3支持：可通过htslib的S3插件访问S3存储中的文件（需参考官方配置）

使用场景和适用范围

适用于生物信息学分析、高通量测序数据处理等场景，特别是需要读取或写入S3存储中基因组数据文件的任务。
注意：不支持基于角色的IAM访问，因此使用AWS Batch执行角色无法直接访问私有S3对象。

详细使用方法和配置说明

S3访问配置

关于使用htslib/bcftools/samtools读写S3文件，需参考http://www.htslib.org/doc/htslib-s3-plugin.html%E3%80%82%E5%85%B3%E9%94%AE%E9%99%90%E5%88%B6%EF%BC%9A

• 不支持基于角色的IAM访问，导致AWS Batch执行角色无法访问私有S3对象

解决IAM访问限制的方法

htslib存在相关https://github.com/samtools/htslib/issues/344%EF%BC%8C%E5%85%B6%E4%B8%AD%E6%8F%90%E5%88%B0%E5%8F%AF%E9%80%9A%E8%BF%87shell%E8%84%9A%E6%9C%AC%E5%9C%A8%E8%B0%83%E7%94%A8%E5%B7%A5%E5%85%B7%E5%89%8D%E8%AE%BE%E7%BD%AE%E8%A7%92%E8%89%B2%E5%87%AD%E8%AF%81%E3%80%82%E4%BD%BF%E7%94%A8%E6%96%B9%E5%BC%8F%E5%A6%82%E4%B8%8B%EF%BC%9A

bash
docker run --rm docker.xuanyuan.run/htslib-bcftools-samtools:1.15.1 s3role bcftools view --header-only s3://bucket/key.vcf.gz

注意事项

• 凭证过期问题：长时间运行的任务可能因AWS自动轮换凭证而导致访问失败，容器不会自动刷新凭证。

部署示例

通过Docker运行命令示例：

bash
# 查看S3中VCF文件的头部信息
docker run --rm docker.xuanyuan.run/htslib-bcftools-samtools:1.15.1 s3role bcftools view --header-only s3://your-bucket/path/to/file.vcf.gz