stefanfritsch/r_statup

r_statup 镜像文档

镜像概述

r_statup 是一个基于 Microsoft R-Open (MRO) 的 Docker 镜像，设计理念类似于 rocker/r-ver 系列镜像。其核心目标是通过 Microsoft R-Open 提供的稳定包管理机制，解决 R 语言开发和部署过程中包版本不一致的问题，确保在不同环境下的代码可重现性和运行稳定性。

核心功能与特性

基于 Microsoft R-Open

• 采用 Microsoft R-Open 作为基础 R 环境，MRO 是 R 的增强版，提供了稳定的 CRAN 镜像同步机制和可重现的数值计算能力
• 内置对多线程计算的优化支持（部分线性代数运算可利用多核心）

版本稳定性保障

• 固定 CRAN 镜像快照，确保安装的 R 包版本与 MRO 发布时的版本一致，避免因包版本更新导致的兼容性问题
• 镜像构建过程中锁定基础依赖版本，减少环境差异对运行结果的影响

兼容 rocker/r-ver 使用习惯

• 保持与 rocker/r-ver 相似的文件系统结构和环境配置，降低用户迁移成本
• 支持常见的 R 开发工具和工作流（如 RScript、R Markdown 等）

使用场景

R 语言开发环境

• 为开发者提供统一的本地开发环境，避免"在我电脑上能运行"的问题
• 支持与 IDE（如 RStudio、VS Code）结合使用，通过挂载工作目录实现代码实时编辑与运行

数据分析项目部署

• 用于部署依赖特定 R 包版本的数据分析 pipelines
• 确保在 CI/CD 流程中，测试和生产环境使用完全一致的 R 包版本

教学与科研场景

• 为学生或研究团队提供标准化的 R 环境，确保教学案例和研究代码的可重现性
• 简化跨平台（Windows/macOS/Linux）R 环境配置流程

使用方法

基础运行

通过以下命令启动一个交互式 R 终端：

bash
docker run -it --rm r_statup R

运行 R 脚本

在本地目录中准备 R 脚本（如 script.R），通过挂载目录运行：

bash
docker run -it --rm -v $(pwd):/workspace -w /workspace r_statup Rscript script.R

挂载数据卷

持久化保存工作数据或安装的额外包：

bash
# 创建数据卷
docker volume create r_data
# 挂载数据卷运行
docker run -it --rm -v r_data:/data r_statup

自定义配置（可选）

如需修改 CRAN 镜像源或添加系统依赖，可基于此镜像构建自定义镜像（创建 Dockerfile）：

dockerfile
FROM r_statup
# 示例：安装系统依赖
RUN apt-get update && apt-get install -y libssl-dev libcurl4-openssl-dev
# 示例：修改 CRAN 镜像（如需）
RUN echo 'options(repos = c(CRAN = "https://cran.mirror.example.com/"))' >> /usr/lib/R/etc/Rprofile.site

构建并使用自定义镜像：

bash
docker build -t my-r-statup .
docker run -it --rm my-r-statup R

配置参数说明

当前版本镜像无特殊环境变量或配置参数，所有基础配置均继承自 Microsoft R-Open 官方设置。如需自定义，建议通过上述 "自定义配置" 方式构建衍生镜像。