allanbatista/jupyter

Simple Jupyter Docker 镜像文档

镜像概述

Simple Jupyter Docker 是一个简单易用的容器镜像，集成了 Python3、Jupyter Notebook 和 gcloud SDK，方便用户快速搭建数据分析和开发环境。该镜像支持 Google Cloud 认证配置，适用于需要与 Google Cloud Platform (GCP) 集成的场景。

项目仓库：https://github.com/allanbatista/docker-jupyter

核心功能与特性

• 内置组件：包含 Python3、Jupyter Notebook 和 gcloud SDK，无需额外安装基础依赖
• 灵活认证：支持通过环境变量配置 Google Cloud 服务账号认证
• 即开即用：简单配置即可启动 Jupyter Notebook 服务
• 数据持久化：提供明确的数据目录，便于挂载和管理工作文件

使用场景

• 快速搭建数据分析环境
• 需要与 GCP 服务交互的 Jupyter 开发场景
• 临时或轻量级的 Python Notebook 运行环境
• 教学或演示环境的快速部署

使用方法

环境变量配置

基础认证配置

• PASSWORD：Jupyter Notebook 访问密码，默认值为 password

Google Cloud SDK 认证配置

如需使用 gcloud SDK 功能，需配置以下环境变量（通过服务账号实现认证）：

• GOOGLE_APPLICATION_CREDENTIALS_JSON：服务账号密钥的 JSON 字符串
• GOOGLE_APPLICATION_PROJECT：GCP 项目 ID
• GOOGLE_APPLICATION_ACCOUNT：服务账号***（格式如 account-name@project-id.iam.gserviceaccount.com）

镜像会自动基于上述变量生成 GOOGLE_APPLICATION_CREDENTIALS 环境变量，指向容器内服务账号密钥文件的存储路径。

启动命令示例

基础启动（带密码）

bash
docker run --rm -p 8888:8888 -e PASSWORD=my_password allanbatista/jupyter notebook

带 GCP 认证的启动

bash
docker run --rm -p 8888:8888 \
  -e PASSWORD=my_password \
  -e GOOGLE_APPLICATION_CREDENTIALS_JSON='{"type":"service_account",...}' \
  -e GOOGLE_APPLICATION_PROJECT=my-gcp-project \
  -e GOOGLE_APPLICATION_ACCOUNT=my-service-account@my-gcp-project.iam.gserviceaccount.com \
  allanbatista/jupyter notebook

数据目录说明

• /jupyter/notebook：Jupyter Notebook 的工作目录，建议挂载本地目录以持久化 Notebook 文件
• /root：容器内管理员（root）的主目录

挂载工作目录示例

bash
docker run --rm -p 8888:8888 \
  -e PASSWORD=my_password \
  -v /本地工作目录:/jupyter/notebook \
  allanbatista/jupyter notebook