o2rproject/containerit

containerit镜像说明

镜像概述

本镜像基于rocker系列基础镜像构建，预安装了containerit R包，旨在帮助用户快速生成Dockerfile，将R脚本、会话信息或工作区及其依赖项打包为Docker容器，实现R项目的可复现性。镜像支持verse和geospatial等变体，满足不同场景需求。

核心功能

1. 自动生成Dockerfile：根据R会话信息、R脚本或Rmd文件生成包含依赖的Dockerfile。
2. 多变体支持：提供verse（基础数据分析）和geospatial（地理空间分析）等变体镜像。
3. RStudio集成：支持通过RStudio Add-in可视化生成Dockerfile。
4. 依赖过滤：可跳过基础镜像已包含的包，减少构建时间。

使用场景

1. 科研可复现性：将R分析项目打包为容器，确保结果在不同环境中一致。
2. 快速开发环境：无需本地安装依赖，直接使用预配置的containerit环境。
3. 教学演示：在课堂或 workshop 中快速展示R项目的容器化过程。

配置说明

镜像变体

• verse：基于rocker/verse，包含常用数据分析包。
• geospatial：基于rocker/geospatial，增加地理空间分析工具，适合相关领域使用。

部署示例

启动带RStudio的geospatial变体

bash
docker run --rm -it -e PASSWORD=o2r -p 8787:8787 docker.xuanyuan.run/o2rproject/containerit:geospatial /init

访问http://localhost:8787，使用用户名rstudio和密码o2r登录。

在R中生成Dockerfile

r
# 安装containerit（镜像内已预安装）
# remotes::install_github("o2r-project/containerit")

# 从会话信息生成Dockerfile
library(containerit)
my_dockerfile <- dockerfile(from = utils::sessionInfo())
print(my_dockerfile)

注意事项

• 使用前需确保本地已安装Docker Engine Community版。
• 镜像支持版本标签，可指定具体版本使用（如o2rproject/containerit:4.0.5）。
• 如需自定义镜像，可参考inst/docker目录下的Dockerfile模板。