JupyterHub onbuild镜像

镜像概述和主要用途

JupyterHub onbuild镜像是JupyterHub的特殊版本，设计用于简化配置文件的集成流程。当基于此镜像构建Docker镜像时，Dockerfile所在目录下的jupyterhub_config.py文件会被自动加载到镜像中，并作为JupyterHub的配置文件使用，无需手动复制配置文件。

核心功能和特性

• 自动配置加载：自动检测并加载与Dockerfile相邻的jupyterhub_config.py文件，简化JupyterHub配置流程
• 版本兼容性：支持通过指定标签继承特定版本的JupyterHub，确保配置与JupyterHub版本匹配

使用场景和适用范围

适用于需要快速构建包含自定义配置的JupyterHub镜像的场景，尤其适合开发者或管理员在部署JupyterHub时，希望简化配置文件集成步骤，避免手动处理配置文件复制操作。

使用方法和配置说明

基本构建示例

创建Dockerfile并基于此镜像构建，示例如下：

dockerfile
FROM quay.io/jupyterhub/jupyterhub-onbuild:4.0.2
# 可添加其他自定义构建指令（如安装依赖等）

配置文件要求

• 配置文件必须命名为jupyterhub_config.py
• 配置文件需放置在与Dockerfile相同的目录下，以便onbuild过程自动检测并加载

重要注意事项

[!NOTE] 请继承与您所需JupyterHub版本对应的标签。可访问Quay.io页面查看所有可用标签列表。

[!WARNING] 在0.6版本之前，quay.io/jupyterhub/jupyterhub镜像的默认行为是自动加载jupyterhub_config.py文件，而现在此行为由本onbuild镜像提供。