biocontainers/bowtie

BioContainers 镜像文档

镜像概述和主要用途

BioContainers是一个社区驱动的项目，旨在利用Docker、rkt等容器技术解决生物信息学软件的部署和分发问题。通过提供标准化的容器化环境，BioContainers确保生物信息学工具在不同计算环境（本地桌面、云平台、HPC集群）中的一致性和可复现性，特别专注于基因组学、蛋白质组学、转录组学和代谢组学等组学领域。

核心功能和特性

核心目标

• 提供标准化规范和基础镜像，简化生物信息学软件的构建与部署
• 维护可直接使用的生物信息学工具容器库（https://github.com/BioContainers/containers）
• 定义容器构建标准，确保容器间兼容性及与其他生物信息学工具的集成能力
• 建立完整的容器开发、部署和测试基础设施，支持Travis CI、Shippable等持续集成工具
• 为缺乏生物信息学支持的研究人员提供容器部署支持
• 通过容器版本控制实现分析流程的可复现性，确保结果一致性
• 协调开发者与生物信息学家，推动文档和软件开发最佳实践

使用场景和适用范围

BioContainers适用于以下场景：

• 生物信息学软件的快速部署，避免复杂的依赖配置
• 跨平台（本地、云、HPC）的分析流程一致性保障
• 组学数据分析（基因组、蛋白质组等）的可复现研究
• 生物信息学管道的集成与标准化
• 教学和培训环境的快速搭建

使用方法和配置说明

容器获取与使用

容器仓库

BioContainers容器主要托管在两个 registry：

• Docker Hub：https://hub.docker.com/u/biodckr/（Docker格式容器）
• QUAY Hub：https://quay.io/organization/biodckr（支持Docker和rkt格式容器）

基本使用流程

1. 获取容器
   使用Docker拉取容器：

   bash
   docker pull docker.xuanyuan.run/biodckr/[软件名称]:[版本标签]
   

2. 运行容器
   以交互式方式运行容器：

   bash
   docker run -it docker.xuanyuan.run/biodckr/[软件名称]:[版本标签] /bin/bash
   

   直接执行软件命令：

   bash
   docker run docker.xuanyuan.run/biodckr/[软件名称]:[版本标签] [软件命令及参数]
   

请求容器

若所需软件未在BioContainers中提供，可通过以下步骤请求：

1. 在 http://github.com/BioContainers/sandbox/issues 提交issue
2. 提供软件名称、代码/二进制文件URL及软件相关信息（参考http://github.com/BioContainers/container-specs.md）
3. 容器构建完成后，issue将被关闭并通知请求者

容器开发指南

开发环境要求

• Linux操作系统
• Docker或rkt运行时环境
• 待容器化的生物信息学软件

创建Docker容器

1. 编写Dockerfile
   Dockerfile是定义容器构建流程的文本文件，包含基础镜像选择、软件下载、安装及配置等步骤。参考https://docs.docker.com/reference/builder/了解语法。

2. 构建与测试
   本地构建并测试容器：

   bash
   docker build -t my-biocontainer .
   docker run -it docker.xuanyuan.run/my-biocontainer /bin/bash
   

3. 贡献容器
   容器测试通过后，可联系BioContainers团队，通过自动化构建系统将容器纳入官方仓库。

创建rkt容器

1. 编写rkt配置文件
   遵循rkt容器规范定义构建流程，参考https://github.com/coreos/rkt/blob/master/Documentation/getting-started-guide.md。

2. 构建与测试
   使用rkt构建工具创建并测试容器。

3. 贡献容器
   联系团队将容器集成到官方仓库的自动化构建流程。

支持与参与

参与方式

• 浏览https://github.com/BioContainers/containers使用现有工具
• 在https://github.com/BioContainers/sandbox/issues提交新软件需求或改进建议
• 参与社区讨论（https://gitter.im/biocontainers/Lobby）
• 贡献容器构建 recipe 或改进文档

资源链接

• 项目主页：[***]
• 规范文档：https://github.com/BioContainers/specs
• 贡献指南：https://github.com/BioContainers/specs/blob/master/CONTRIBUTING.md
• 项目Wiki：https://github.com/BioContainers/specs/wiki
• 联系***：***

许可证

BioContainers项目采用http://www.apache.org/licenses/LICENSE-2.0许可证。