stefanfritsch/r_barebones_statup

r_statup 镜像文档

镜像概述

r_statup 是一个精简的 R 语言运行环境镜像，仅包含基础的 R 安装及 devtools 包。该镜像专注于提供最小化的 R 运行环境，同时集成 devtools 工具以支持 R 包的开发、安装与管理，适合对环境体积有严格要求的场景。

核心功能与特性

• 精简 R 运行环境：包含基础 R 语言解释器及核心依赖，确保基本 R 脚本可正常执行
• 集成 devtools 工具：预装 devtools 包，支持 R 包的开发（如 load_all()、check()）、从 GitHub/GitLab 安装包（install_github()）等功能
• 最小化体积：仅保留必要组件，相比完整 R 镜像显著减小存储空间占用

使用场景与适用范围

• R 包开发的初始环境搭建，快速启动包开发工作流
• 轻量级 R 脚本运行，无需完整 R 环境的场景
• CI/CD 流程中需要临时 R 环境的场景，减少环境准备时间
• 教学或演示环境，需要快速部署基础 R 开发环境

使用方法与配置说明

基本使用（交互式 R 会话）

通过以下命令启动交互式 R 会话：

bash
docker run -it --rm r_statup R

• -it：启用交互式终端
• --rm：容器退出后自动删除
• R：指定容器启动命令，进入 R 解释器

使用 devtools 安装 R 包

在启动的 R 会话中，可通过 devtools 安装其他 R 包，例如从 GitHub 安装包：

r
# 安装 GitHub 上的 R 包
devtools::install_github("username/repo")

# 安装本地开发的 R 包
devtools::install_local("/path/to/local/package")

运行 R 脚本文件

将本地 R 脚本挂载到容器中执行：

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

• -v $(pwd):/workspace：将当前目录挂载到容器内的 /workspace 目录
• Rscript /workspace/your_script.R：执行挂载目录中的 R 脚本

配置说明

• 环境变量：暂无特殊环境变量配置需求
• 数据持久化：如需保留 R 包或数据，可通过 -v 参数挂载本地目录至容器内的 R 库路径（如 /usr/local/lib/R/site-library）

注意事项

• 该镜像为精简版本，不含图形界面相关依赖（如 X11、cairo 等），若需图形输出需额外安装相关系统库及 R 包
• devtools 功能依赖网络连接，确保容器可访问互联网以正常使用包安装功能