rstudio/r-base

Posit R Docker 镜像

简短描述

R 的 Docker 镜像

[!NOTE] 这些镜像已迁移至 Docker Hub 上的 posit/r-base。目前 rstudio/r-base 镜像仍会继续更新，但将来会被弃用。

https://github.com/rstudio/r-docker/actions/workflows/build.yml/badge.svg](https://github.com/rstudio/r-docker/actions/workflows/build.yml)

镜像概述和主要用途

Posit 为不同 Linux 发行版创建并https://github.com/rstudio/r-builds%E3%80%82%E8%BF%99%E4%BA%9B Docker 镜像基于这些 R 二进制文件构建，故意设计为最小化，主要用途是作为其他需要 R 的镜像的基础。

若需快速开始使用 R 或 RStudio，可参考 Rocker 项目。

警告：这些镜像仍处于实验阶段，可能会发生变化。目前不应用于严格可重现的环境。

核心功能和特性

• 基于 Posit 优化的 R 二进制文件：使用 Posit 提供的预编译 R 二进制文件，确保稳定性和兼容性。
• 多发行版支持：覆盖 Ubuntu、Debian、CentOS、Rocky Linux、openSUSE 等多种 Linux 发行版。
• 多架构支持：同时支持 x86_64/amd64 和 aarch64/arm64 架构（CentOS 7 除外，不支持 arm64）。
• 灵活的标签策略：提供按发行版、R 版本（精确版本和浮动补丁版本）分类的标签，满足不同场景需求。
• 最小化设计：仅包含 R 运行所需的系统库，适合作为基础镜像构建自定义环境。

使用场景和适用范围

• 构建自定义 R 环境：作为基础镜像，添加特定 R 包、工具或应用，构建专用镜像。
• 多版本 R 测试：通过不同标签快速切换 R 版本，测试代码兼容性。
• 跨发行版验证：在多种 Linux 发行版上验证 R 应用的运行情况。

不适用场景：直接用于生产环境（实验阶段）、需要完整 RStudio 环境（建议使用 Rocker 项目）。

使用方法和配置说明

快速运行 R

可直接通过 docker run 命令启动 R 交互环境：

bash
docker run --rm -it posit/r-base:4.5-noble

作为基础镜像构建自定义镜像

在 Dockerfile 中使用该镜像作为基础，构建包含额外依赖或 R 包的自定义镜像：

dockerfile
FROM posit/r-base:4.5-noble

# 示例：安装系统依赖
RUN apt-get update && apt-get install -y \
    libcurl4-openssl-dev \
    libssl-dev \
    && rm -rf /var/lib/apt/lists/*

# 示例：安装 R 包
RUN R -e "install.packages('dplyr', repos='https://cloud.r-project.org/')"

版本和标签说明

镜像标签遵循以下模式：

支持的操作系统和架构

以下发行版同时支持 x86_64/amd64 和 aarch64/arm64 架构（CentOS 7 仅支持 x86_64）：

注：CentOS 7 的 arm64 架构不被支持。

支持的 R 版本

支持 R 3.1 及以上的所有次要版本，且均为最新补丁版本。新 R 版本会在 Posit CDN 发布后添加（可能存在短暂延迟）。

R 简介

R 是用于统计计算和图形的语言与环境。更多信息：

• R 官方介绍
• R for Data Science（数据科学中的 R）

资源

• 使用 Docker 与 R
• 在容器中运行 Posit 产品

支持

Posit 不提供这些镜像或 R 语言的专业支持。建议在 Posit 社区 提问或反馈。

许可

查看 R 许可信息。

开发者资源

镜像结构

• base：基础镜像，包含最小化操作系统和 R 所需的系统库。
• x.y：每个 R 主版本的镜像，基于 base 镜像并从 Posit CDN 安装 R。

构建镜像

使用 make 命令构建和测试镜像：

bash
# 构建并测试所有镜像
make

# 构建并测试特定 R 版本的镜像
make VERSIONS=4.4

# 构建并测试特定发行版的镜像
make VARIANTS=noble

# 构建特定镜像（如 R 4.4 在 noble 上）
make build-4.4-noble

# 构建特定补丁版本（如 R 4.4.3 在 noble 上）
make build-4.4.3-noble

# 测试特定镜像
make test-4.4-noble

# 测试特定补丁版本
make test-4.4.3-noble

# 构建并测试所有镜像（含历史补丁版本）
make INCLUDE_PATCH_VERSIONS=yes

更新镜像

当添加新发行版或 R 版本时，按以下步骤更新：

1. 更新 update.sh 和 Makefile，添加新发行版或 R 版本信息。
2. 更新 README.md 文档。
3. 在 /base/<distro>/ 目录下创建新的 Dockerfile。
4. 生成新 Dockerfile：

   bash
   make update-all
   
   # 或使用 Docker 生成
   make update-all-docker
   

5. 本地构建并测试新镜像。
6. 提交 Pull Request。

重建镜像

当 R 构建更新但 Dockerfile 或基础镜像未变时，重建镜像（忽略缓存，重新安装 R）：

bash
# 重建所有镜像
make rebuild-all

# 重建特定镜像
make rebuild-4.4-noble

发布镜像

镜像通过 GitHub Actions 工作流自动构建和发布，详见 https://github.com/rstudio/r-docker/actions/workflows/build.yml%E3%80%82