ucsdets/phys164

PHYS 164 Docker镜像文档

镜像概述

PHYS 164 Docker镜像是专为PHYS 164课程设计的容器化环境，基于ucsdets/datascience-notebook:2019.4-stable基础镜像构建。该镜像提供了扩展机制，允许用户根据课程需求添加新的软件包，同时确保容器与数据科学和机器学习平台保持兼容性。

核心功能与特性

• 基于稳定基础镜像：以ucsdets/datascience-notebook:2019.4-stable为底层环境，确保数据科学工具链的稳定性和兼容性
• 支持自定义扩展：通过Dockerfile灵活添加课程所需的新软件包，满足个性化教学需求
• 平台兼容性保障：保持与数据科学和机器学习平台的兼容性，确保课程内容和工具正常运行

使用场景与适用范围

• PHYS 164课程的标准化教学环境搭建
• 课程所需特定软件包的集成与扩展
• 确保师生使用统一的开发环境，避免因本地配置差异导致的问题

使用方法与配置说明

自定义镜像构建步骤

1. 创建Dockerfile
   在项目目录下创建Dockerfile，并确保FROM指令位于文件顶部以指定基础镜像：

   dockerfile
   FROM ucsdets/datascience-notebook:2019.4-stable
   
   # 示例：添加Python包
   RUN pip install numpy pandas matplotlib
   
   # 示例：添加系统依赖包
   RUN apt-get update && apt-get install -y git wget
   

2. 构建镜像
   在Dockerfile所在目录执行以下命令构建自定义镜像：

   bash
   docker build -t phys164-course-image .
   

运行容器

构建完成后，通过以下命令启动容器：

bash
docker run -p 8888:8888 phys164-course-image

容器启动后，可通过浏览器访问日志中显示的Jupyter Notebook链接（通常格式为http://127.0.0.1:8888/?token=<随机令牌>）。

注意事项

• 必须将FROM ucsdets/datascience-notebook:2019.4-stable保持为Dockerfile的第一行，以确保与数据科学平台的兼容性
• 添加新包时，建议指定版本号以保证环境一致性，例如pip install numpy==1.21.0
• 对于系统级包，建议在安装后清理apt缓存以减小镜像体积：RUN apt-get clean && rm -rf /var/lib/apt/lists/*