benjaminvincentlab/rserver-binfotron

rserver-binfotron

镜像概述

rserver-binfotron是用于运行binfotron功能的Docker镜像，基于RStudio Server构建，提供Web界面访问。该镜像支持本地环境部署和生物信息集群环境（通过Singularity）部署，方便用户在不同场景下使用binfotron功能及RStudio进行数据分析。

DockerHub地址：https://hub.docker.com/repository/docker/benjaminvincentlab/rserver-binfotron

核心功能和特性

• 基于RStudio Server，提供直观的Web界面，支持R语言开发和数据分析
• 集成binfotron功能，满足特定生物信息学分析需求
• 支持本地Docker环境快速部署和运行
• 适配生物信息集群环境，可通过Singularity容器化工具运行
• 标签版本结构清晰，便于识别R版本和Dockerfile版本

使用场景

• 本地开发与测试：在个人计算机上快速部署，通过RStudio界面调试和运行binfotron功能
• 生物信息集群分析：在生物信息学集群环境中，通过Singularity部署，利用集群资源进行大规模数据分析
• 团队协作：统一运行环境，确保binfotron功能在不同用户间的一致性

使用方法

本地构建

通过以下命令在本地构建镜像（以版本4.0.3.2为例）：

bash
docker build -t benjaminvincentlab/rserver-binfotron:4.0.3.2 .

本地运行

使用Docker运行镜像，映射端口并挂载本地目录：

bash
docker run -e PASSWORD=12qwaszx --rm -p 8787:8787 -v ~/Desktop:/home/rstudio benjaminvincentlab/rserver-binfotron:4.0.3.2 8787

运行后，在浏览器中访问 localhost:8787 即可打开RStudio界面，使用设置的密码（示例中为12qwaszx）登录。

在生物信息集群使用Singularity运行

在生物信息集群环境中，可通过Singularity运行该镜像，需注意以下事项：

手动配置与运行

1. 使用--pid标志：确保作业结束时终止rserver所有进程，避免残留进程占用节点资源。
2. 使用开放端口：选择集群中未被占用的端口。
3. 设置唯一--server-data-dir：通过临时目录生成唯一数据目录：

   bash
   data_dir=$(mktemp -d -t rserver-XXXXXXXX)
   

4. 创建--database-config-file：生成数据库配置文件，示例如下：

   bash
   database_config_path=${data_dir}/database.conf
   echo "provider=sqlite" > $database_config_path
   echo "directory=${data_dir}" >> $database_config_path
   echo "provider=postgresql" >> $database_config_path
   echo "host=localhost" >> $database_config_path
   echo "database=rstudio" >> $database_config_path
   echo "port=5432" >> $database_config_path
   echo "username=postgres" >> $database_config_path
   echo "password=postgres" >> $database_config_path
   echo "connection-timeout-seconds=10" >> $database_config_path
   echo "connection-uri=postgresql://postgres@localhost:5432/rstudio?sslmode=allow&options=-csearch_path=public" >> $database_config_path
   

5. 执行Singularity命令：

   bash
   singularity exec --pid --nohttps --home $rstudio_home_dir --bind $bindings $image_path \
     rserver --www-port $source_command --server-data-dir $data_dir --database-config-file $database_config_path
   

便捷脚本运行

可直接使用集群提供的run_rserver脚本（[***]

标签版本结构说明

镜像标签采用v.w.x.y格式，各部分含义如下：

• v.w.x：对应R语言版本
• y：Dockerfile自身版本号

例如，标签4.0.3.2表示基于R 4.0.3版本，Dockerfile版本为2。