rstudio/content-pro Docker 镜像 - 轩辕镜像

RStudio Content 镜像文档

镜像概述

本文档描述了RStudio的两个Docker镜像：content-base和content-pro，以及它们的构建、检查和使用方法。

content/base

基础镜像，包含：

• 基础示例所需的"大部分"系统依赖
• 单个R版本
• 单个Python版本

注意：构建content-pro镜像前必须先构建content-base镜像。

content/pro

扩展镜像，在content-base基础上安装了RStudio Pro驱动。构建前提：必须先构建对应R和Python版本的content-base镜像，否则会报错。

镜像检查

概述

scripts/build-image-yaml.sh脚本用于在容器内运行scripts/examine-image.sh分析脚本，向stderr输出进度信息，向stdout输出YAML结果。

使用方法

生成单个镜像的YAML

console
./scripts/build-image-yaml.sh rstudio/content-base:r3.6.3-py3.8.8-bionic > runtime.yaml

生成多个content-base镜像的合并YAML

console
./scripts/build-image-yaml.sh rstudio/content-base:r3.1.3-py2.7.18-bionic \
		rstudio/content-base:r3.2.5-py2.7.18-bionic \
		rstudio/content-base:r3.3.3-py3.6.13-bionic \
		rstudio/content-base:r3.4.4-py3.6.13-bionic \
		rstudio/content-base:r3.4.4-py3.7.10-bionic \
		rstudio/content-base:r3.5.3-py2.7.18-bionic \
		rstudio/content-base:r3.5.3-py3.7.10-bionic \
		rstudio/content-base:r3.6.3-py2.7.18-bionic \
		rstudio/content-base:r3.6.3-py3.6.13-bionic \
		rstudio/content-base:r3.6.3-py3.8.8-bionic  \
		rstudio/content-base:r4.0.5-py3.6.13-bionic \
		rstudio/content-base:r4.0.5-py3.7.10-bionic \
		rstudio/content-base:r4.0.5-py3.8.8-bionic  \
		rstudio/content-base:r4.0.5-py3.9.2-bionic  \
		rstudio/content-base:r4.1.0-py3.8.8-bionic  \
		rstudio/content-base:r4.1.0-py3.9.2-bionic  > runtime.yaml

生成多个content-pro镜像的合并YAML

console
./scripts/build-image-yaml.sh rstudio/content-pro:r3.1.3-py2.7.18-bionic \
		rstudio/content-pro:r3.2.5-py2.7.18-bionic \
		rstudio/content-pro:r3.3.3-py3.6.13-bionic \
		rstudio/content-pro:r3.4.4-py3.6.13-bionic \
		rstudio/content-pro:r3.4.4-py3.7.10-bionic \
		rstudio/content-pro:r3.5.3-py2.7.18-bionic \
		rstudio/content-pro:r3.5.3-py3.7.10-bionic \
		rstudio/content-pro:r3.6.3-py2.7.18-bionic \
		rstudio/content-pro:r3.6.3-py3.6.13-bionic \
		rstudio/content-pro:r3.6.3-py3.8.8-bionic  \
		rstudio/content-pro:r4.0.5-py3.6.13-bionic \
		rstudio/content-pro:r4.0.5-py3.7.10-bionic \
		rstudio/content-pro:r4.0.5-py3.8.8-bionic  \
		rstudio/content-pro:r4.0.5-py3.9.2-bionic  \
		rstudio/content-pro:r4.1.0-py3.8.8-bionic  \
		rstudio/content-pro:r4.1.0-py3.9.2-bionic  > runtime.yaml

环境变量

• NO_PATH_LOOKUPS：设置为1时，在查找R、Python和Quarto安装路径时忽略PATH环境变量

  console
  NO_PATH_LOOKUPS=1 ./scripts/build-image.sh \
      rstudio/content-pro:r3.1.3-py2.7.18-bionic > runtime.yaml
  

• DEBUG：设置为1时，输出镜像分析的额外调试信息

  console
  DEBUG=1 ./scripts/build-image.sh \
      rstudio/content-pro:r3.1.3-py2.7.18-bionic > runtime.yaml
  

构建矩阵

CONTENT_BUILD_MATRIX变量在buildx bake配置文件中定义，用于指定构建content-base和content-pro镜像时使用的R和Python版本组合。

• 添加新组合：更新该矩阵后，下次推送到main分支时，Github Action会自动将新组合的镜像发布到仓库。
• 本地构建：从仓库根目录执行以下命令构建content镜像

  console
  just bake content-images
  

Github Actions

content-base和content-pro镜像通过build-bake工作流构建。

许可信息

RStudio Docker Products仓库的许可信息参见LICENSE.md。

与所有容器镜像一样，本镜像包含的其他软件（如bash、Linux、系统库等及直接/间接依赖）可能受其他许可协议约束。镜像用户有责任确保对本镜像（及所有依赖层）的使用符合其中包含的所有软件的许可要求。