posit/workbench-session

Posit Workbench Session 容器镜像

这些容器镜像为Kubernetes中的Workbench提供会话运行时环境。每个镜像捆绑特定的R和Python版本组合，以及Jupyter、Quarto和Posit Professional Drivers，确保用户会话在匹配其语言需求的环境中运行。

https://img.shields.io/badge/github-repo?logo=github&color=grey](https://github.com/posit-dev/images-workbench) https://img.shields.io/github/actions/workflow/status/posit-dev/images-workbench/session.yml?branch=main](https://github.com/posit-dev/images-workbench/actions/workflows/session.yml) https://img.shields.io/docker/v/posit/workbench-session/latest?sort=semver&label=latest](https://hub.docker.com/r/posit/workbench-session/tags) !https://img.shields.io/docker/pulls/posit/workbench-session !https://img.shields.io/docker/image-size/posit/workbench-session/latest

[!TIP] 在Kubernetes上部署？试试Posit Workbench Helm 图表！

快速参考

相关镜像

对于Kubernetes部署，Workbench需配合多个镜像使用。有关Helm配置，请参见https://github.com/posit-dev/images-workbench#deploying-on-kubernetes%E3%80%82

如何使用此镜像

请勿直接运行这些镜像。当用户在Kubernetes上启动会话时，Workbench Job Launcher会将它们调度为会话Pod。每个Pod使用镜像中内置的R和Python版本运行交互式会话（RStudio Pro、VS Code、Positron或Jupyter）。您应选择与需求最匹配的R和Python版本的镜像，扩展镜像以包含所需的额外库和包，或从头构建自己的镜像。workbench-session-init和workbench-positron-init初始化容器提供会话镜像本身未捆绑的会话运行时组件。

通过以下任一方法将这些镜像配置为Workbench的会话镜像：

1. Helm图表值：rstudio/rstudio-workbench Helm图表包含一组默认的会话镜像。有关配置详情，请参见https://github.com/posit-dev/images-workbench#deploying-on-kubernetes%E3%80%82
2. Launcher配置：在Workbench Job Launcher配置中定义可用的会话镜像。参见在Posit Workbench、Launcher和Kubernetes中使用Docker镜像。

镜像标签

Posit将镜像发布到：

• Docker Hub: docker.io/posit/workbench-session
• GitHub Container Registry: ghcr.io/posit-dev/workbench-session

默认操作系统为Ubuntu 24.04。

标签格式为：R{r_version}-python{python_version}-{os}

示例：

• R4.5.2-python3.14.3-ubuntu-24.04 — R 4.5.2、Python 3.14.3、Ubuntu 24.04
• R4.4.3-python3.12.12-ubuntu-22.04 — R 4.4.3、Python 3.12.12、Ubuntu 22.04
• R4.3.3-python3.11.15-ubuntu-24.04 — R 4.3.3、Python 3.11.15、Ubuntu 24.04

架构

Posit为Ubuntu 24.04会话镜像发布linux/amd64和linux/arm64两种架构。从任一平台拉取相同标签，Docker会自动选择匹配的清单。Posit为Ubuntu 22.04会话镜像仅发布linux/amd64架构。

[!WARNING] Posit为这些镜像构建linux/amd64和linux/arm64版本，但workbench和workbench-session-init镜像仅构建linux/amd64版本。这些镜像的linux/arm64构建版在Workbench正式添加ARM64平台支持前仍处于开发者预览阶段。

已安装软件

每个镜像包含：

这些镜像未捆绑Workbench会话组件本身。workbench-session-init初始化容器通过共享卷在运行时提供这些组件。

用户

这些镜像未声明USER。容器以root身份启动。Workbench Job Launcher在调度会话Pod时管理运行时用户，根据Workbench管理员的配置将权限降为已登录用户。

示例

使用额外R包扩展镜像

使用任何标签作为基础镜像，构建包含额外依赖的派生镜像。例如，预安装Tidyverse的镜像：

dockerfile
FROM ***-ghcr.xuanyuan.run/posit-dev/workbench-session:R4.5.2-python3.14.3-ubuntu-24.04

RUN /opt/R/4.5.2/bin/R -e 'install.packages("tidyverse", repos = "https://p3m.dev/cran/__linux__/noble/latest")'

有关其他模式，请参见https://github.com/posit-dev/images-examples/tree/main/extending%E3%80%82

从旧镜像迁移

这些镜像替代旧版https://hub.docker.com/r/rstudio/workbench-session%E5%92%8Chttps://hub.docker.com/r/rstudio/r-session-complete%E9%95%9C%E5%83%8F%E3%80%82%E8%BF%90%E8%A1%8C%E6%97%B6%E5%B7%A5%E5%85%B7%E6%9C%AA%E5%8F%98%E3%80%82R%E3%80%81Python%E3%80%81Jupyter%E3%80%81Quarto%E5%92%8CPosit Professional Drivers仍安装在/opt下的相同路径，Workbench以相同方式将会话调度到这些镜像中。差异在于Posit发布、标记和打包镜像及其会话组件的方式。

镜像引用

旧版镜像发布在Docker Hub的rstudio/workbench-session和rstudio/r-session-complete，以及GitHub Container Registry的等效路径，标签格式如ubuntu2204-r{R1}_{R2}-py{Py1}_{Py2}（仅linux/amd64）。将镜像引用更新为新位置，并选择固定所需R、Python和OS版本的标签。参见镜像标签和架构。

标签格式

旧版workbench-session标签每个镜像捆绑两个R版本和两个Python版本，例如ubuntu2204-r4.4.1_4.3.3-py3.12.6_3.11.10。新版标签每个镜像固定单个R和Python版本，格式为R{r_version}-python{python_version}-{os}，例如R4.5.2-python3.14.3-ubuntu-24.04。要覆盖相同的R和Python组合，请配置Workbench使用多个会话镜像而非一个。

Quarto安装路径

旧版镜像将Quarto安装在/opt/quarto/{version}/bin/quarto。新版workbench-session镜像从Posit Apt仓库将Quarto安装在/opt/quarto/bin/quarto。quarto及其安装的工具仍链接到系统PATH。请相应更新对Quarto路径的引用。

会话组件

旧版r-session-complete镜像直接捆绑Workbench会话组件。workbench-session镜像不包含，而是由workbench-session-init初始化容器在运行时通过共享卷将会话组件交付到会话Pod中。

本仓库不再支持r-session-complete。如果仍在使用r-session-complete，请迁移到新版workbench-session镜像并启用workbench-session-init初始化容器。有关更多详情，请参见https://github.com/posit-dev/images-workbench/blob/main/workbench-session-init/README.md%E3%80%82

旧版rstudio/workbench-session镜像已遵循此初始化容器模式，因此从rstudio/workbench-session迁移时无需此步骤。

未变更内容

• R、Python、Jupyter和Posit Professional Drivers在/opt下的安装路径
• 这些镜像作为Workbench Job Launcher管理的会话执行环境的角色
• 捆绑的支持流行R包的系统依赖

注意事项

安全性

在生产环境中使用前请审核这些镜像。有特定常见漏洞和暴露（CVE）或漏洞要求的组织可重新构建这些镜像以满足其安全标准。

Posit每周为处于活跃支持期的Posit产品版本重新构建已发布镜像，以纳入操作系统补丁。

镜像依赖许可证

这些镜像包含第三方软件（R、Python、Jupyter、Quarto、TinyTeX、Posit Professional Drivers、系统库及其传递依赖），受各种许可证约束。您有责任确认这些镜像及其依赖项符合所有适用许可证。