pavics/crim-jupyter-eo

pavics-jupyter-images

概述

本仓库包含用于为DACCS的JupyterHub创建镜像的各类Dockerfile。这些镜像将作为JupyterHub界面中启动新JupyterLab实例时的可选镜像。

所有Dockerfile（如eo、nlp等）均衍生自https://github.com/bird-house/pavics-jupyter-base%E4%BB%93%E5%BA%93%E4%B8%AD%E7%9A%84%60base%60%E9%95%9C%E5%83%8F%E3%80%82%E4%BB%85%E7%89%B9%E5%AE%9A%E9%95%9C%E5%83%8F%E6%89%80%E9%9C%80%E7%9A%84%E5%8C%85%E5%8F%AF%E6%B7%BB%E5%8A%A0%E5%88%B0%E5%85%B6%E5%AF%B9%E5%BA%94%E7%9A%84%60environment.yml%60%E6%96%87%E4%BB%B6%E4%B8%AD%E3%80%82

这些镜像最初使用Confluence页面上列出的包进行初始化。

Docker镜像构建可在Docker Hub上查看：

• https://hub.docker.com/repository/docker/pavics/crim-jupyter-eo
• https://hub.docker.com/repository/docker/pavics/crim-jupyter-nlp

每个特定镜像的关联笔记本位于本仓库对应的notebook子文件夹中。此外，每个镜像都有一个YAML配置文件，包含https://github.com/bird-house/pavics-jupyter-base%E4%B8%AD%E7%9A%84https://github.com/bird-house/pavics-jupyter-base/blob/master/scheduler-jobs/deploy_data_specific_image%E4%BD%BF%E7%94%A8%E7%9A%84%E5%8F%82%E6%95%B0%E5%88%97%E8%A1%A8%E3%80%82%E8%AF%A5%E8%84%9A%E6%9C%AC%E7%94%A8%E4%BA%8E%E4%B8%8B%E8%BD%BD%E5%92%8C%E6%9B%B4%E6%96%B0JupyterLab%E7%8E%AF%E5%A2%83%E4%B8%AD%E5%BA%94%E6%8F%90%E4%BE%9B%E7%9A%84%E9%95%9C%E5%83%8F%E5%85%B3%E8%81%94%E7%AC%94%E8%AE%B0%E6%9C%AC%E3%80%82

核心功能与特性

• 基于统一基础镜像：所有镜像均从pavics-jupyter-base衍生，确保基础环境一致性
• 领域特定包管理：通过environment.yml为不同镜像（如eo、nlp）添加特定领域依赖
• 笔记本关联机制：每个镜像对应独立的笔记本子文件夹，便于内容管理
• 自动化部署支持：提供YAML配置文件，支持deploy_data_specific_image脚本自动化更新笔记本

发布流程

1. 使用新增/移除/更新的功能和修复更新相关的CHANGELOG.md文件
   • 标题应对应变更的适当语义化版本
   • 确保日期与PR合并时间一致
2. 经审核者批准后合并PR
3. 使用适当的镜像前缀标记新版本
   • 例如：若type为eo的镜像更新至x.y.z，标签应为eo-x.y.z
4. 在https://hub.docker.com/repositories/pavics%E4%B8%8A%E9%AA%8C%E8%AF%81%E6%9E%84%E5%BB%BA%E6%98%AF%E5%90%A6%E8%87%AA%E5%8A%A8%E8%A7%A6%E5%8F%91
   • 构建应位于对应的pavics/crim-jupyter-[type]仓库，并带有指定的x.y.z标签
   • 合并PR后，latest标签也应更新
5. 为应提供新版本的特定服务器实例的https://github.com/bird-house/birdhouse-deploy/blob/master/birdhouse/env.local.example%E6%96%87%E4%BB%B6%E6%B7%BB%E5%8A%A0%E6%96%B0%E6%9D%A1%E7%9B%AE%EF%BC%88%E5%A6%82https://github.com/bird-house/birdhouse-deploy/blob/8218166d5c8c7163293a656930ff85762eff4b60/birdhouse/env.local.example#L265-L280%E6%89%80%E7%A4%BA%EF%BC%89
   • 添加DOCKER_NOTEBOOK_IMAGES条目，格式为pavics/crim-jupyter-[type]:[x.y.z]
   • 添加镜像的JUPYTERHUB_IMAGE_SELECTION_NAMES快捷名称（注意：必须处于相同索引位置）
6. 遵循特定服务器实例的发布流程，使镜像可用

内部参考

相关CRIM Confluence页面：

• UC10 - Notebooks
  • 镜像类型与最小笔记本环境
  • 安装额外库
  • Jupyter镜像构建流程
  • Jupyter镜像层级结构