r-base Docker镜像文档

1. 镜像概述和主要用途

amd64/r-base 是 R 语言的官方 Docker 镜像，专为 amd64 架构构建。R 是一个用于统计计算和图形绘制的系统，由语言环境、运行时环境（含图形支持、调试器）及系统功能访问能力组成。该镜像由 Rocker 社区 维护，提供了轻量级、可移植的 R 运行环境，适用于数据分析、统计建模、学术研究及生产环境中的批处理任务。

2. 核心功能和特性

• 完整的 R 环境：包含 R 语言解释器、标准库及运行时依赖，支持统计计算、数据处理和图形生成。
• 交互式与批处理双模式：支持直接启动交互式 R 终端，或通过 R CMD、Rscript 执行批处理脚本。
• 可扩展性：可作为基础镜像，通过 Dockerfile 集成自定义 R 包、脚本及依赖，构建专用数据分析环境。
• 多架构支持：除 amd64 外，还支持 arm64v8、ppc64le、s390x 等架构（需对应架构的镜像标签）。
• 轻量级基础：基于 Linux 发行版构建，包含必要工具（如 bash、vim.tiny），兼顾功能性与资源效率。

3. 使用场景和适用范围

• 交互式数据分析：快速启动 R 终端，实时运行代码、可视化数据。
• 批处理任务：自动化执行 R 脚本（如定时数据处理、报表生成）。
• 开发与测试：隔离 R 版本及依赖，确保代码在一致环境中运行。
• 自定义镜像构建：作为基础镜像，集成特定 R 包、脚本或业务逻辑，构建专用数据分析应用。
• 教学与演示：提供统一的 R 环境，简化教学或会议中的环境配置。

4. 使用方法和配置说明

4.1 交互式 R 终端

直接启动容器进入交互式 R 环境，适合实时数据分析和代码调试：

$ docker run -ti --rm amd64/r-base

• -ti：启用交互式终端并分配伪终端。
• --rm：容器退出后自动删除，避免残留资源。

4.2 批处理模式

4.2.1 挂载本地目录运行脚本

通过挂载本地工作目录，在容器中执行 R 批处理命令。建议指定非 root 用户（docker）避免权限问题：

# 示例：运行 R CMD check 检查当前目录的 R 包
$ docker run -ti --rm -v "$PWD":/home/docker -w /home/docker -u docker amd64/r-base R CMD check .

• -v "$PWD":/home/docker：将当前目录挂载到容器内 /home/docker。
• -w /home/docker：设置工作目录为挂载目录。
• -u docker：使用 docker 用户执行命令，避免文件权限被修改。

4.2.2 进入容器编辑并运行脚本

先启动容器的 bash 终端，编辑脚本后通过 Rscript 执行：

# 启动 bash 终端
$ docker run -ti --rm amd64/r-base bash

# 在容器内编辑脚本（使用 vim.tiny）
$ vim.tiny myscript.R

# 运行脚本
$ Rscript myscript.R

4.3 构建自定义 Docker 镜像

以 amd64/r-base 为基础，通过 Dockerfile 构建包含自定义脚本或依赖的镜像。

示例 Dockerfile：

FROM amd64/r-base
COPY . /usr/local/src/myscripts  # 复制本地代码到容器
WORKDIR /usr/local/src/myscripts  # 设置工作目录
CMD ["Rscript", "myscript.R"]  # 容器启动时执行脚本

构建与运行：

# 构建镜像（假设 Dockerfile 在当前目录）
$ docker build -t my-r-app .

# 运行镜像（自动执行 myscript.R）
$ docker run --rm my-r-app

如需交互式或批处理模式运行自定义镜像，可覆盖默认命令：

# 交互式模式
$ docker run -ti --rm my-r-app R

# 批处理模式
$ docker run --rm my-r-app R CMD check .

5. 支持的标签和版本

6. 维护与支持

6.1 维护者

由 Rocker 社区 维护。

6.2 获取帮助

• Docker 社区 Slack：[***]
• Server Fault：[***]
• Unix & Linux Stack Exchange：[***]
• Stack Overflow：[***]

6.3 提交问题

• GitHub 仓库：[***]
• 邮件：***

6.4 镜像更新

• 官方镜像更新跟踪：official-images repo's library/r-base 标签
• 镜像定义文件历史：library/r-base 文件

7. 许可证信息

R 项目许可证

镜像中 R 软件的许可证信息参见 R-project 许可证页面。

其他软件许可证

Docker 镜像可能包含基础发行版（如 Bash 等）及依赖软件，其许可证可能不同。详细信息可参考 repo-info 仓库的 r-base 目录)。

**)。

使用镜像时，用户应确保遵守所有包含软件的许可证要求。

!R logo