deephdc/deep-oc-generic-dev

DEEP-OC-generic-dev

!Build Status

镜像概述和主要用途

DEEP-OC-generic-dev是一个集成Jupyter Notebook、Jupyter Lab和DEEP as a Service (DEEPaaS) API组件的Docker容器。该镜像不包含应用代码，旨在为DEEP-OC模块开发提供标准化环境。用户可通过挂载主机卷或使用Git拉取代码，在Jupyter环境中开发应用，测试后提交至代码仓库。

核心功能和特性

预安装软件栈

• Tensorflow（支持1.12、1.14.0、2.0.0版本）
• 版本控制工具：git
• 网络工具：curl、wget
• DEEP生态组件：deepaas、flaat
• 交互式开发环境：jupyter、jupyterlab
• 数据管理工具：mc、rclone
• 身份认证工具：oidc-agent
• 系统工具：openssh-client
• 编程语言及包管理：python、pip

使用场景和适用范围

• DEEP-OC模块的开发、测试与调试
• 机器学习模型原型验证
• 需要集成DEEPaaS API的应用开发
• 多版本Tensorflow环境下的兼容性测试

使用方法和配置说明

直接从Docker Hub运行

基础启动命令

bash
$ docker run -ti -p 5000:5000 -p 6006:6006 -p 8888:8888 deephdc/deep-oc-generic-dev

该命令会从Docker Hub拉取镜像并启动容器，映射以下端口：

• 8888：Jupyter Notebook/Lab
• 5000：DEEPaaS API
• 6006：Tensorboard（若使用）

访问Jupyter环境

启动后，通过浏览器访问：

• Jupyter Notebook：[***]
• Jupyter Lab：[***]

启动DEEPaaS API

1. 进入Jupyter Lab终端（[***]
2. 执行命令：

bash
$ deepaas-run --listen-ip=0.0.0.0 --listen-port=5000

3. 通过[***] API

挂载主机目录

如需将主机目录挂载到容器：

bash
$ docker run -ti -p 5000:5000 -p 6006:6006 -p 8888:8888 -v $HOME/data:/srv/app/data deephdc/deep-oc-generic-dev

上述命令将主机$HOME/data目录挂载到容器/srv/app/data路径。

通过docker-compose运行

版本要求

• docker-compose.yml版本为2.3，需Docker 17.06.0+和docker-compose 1.16.0+
• 若使用GPU版本（generic-gpu），需nvidia-docker和docker-compose 1.19.0+

本地构建容器

构建步骤

1. 克隆代码仓库：

bash
$ git clone https://github.com/deephdc/DEEP-OC-generic-dev

2. 基础构建（默认CPU+Python3）：

bash
$ cd DEEP-OC-generic-dev
$ docker build -t deephdc/deep-oc-generic-dev .

自定义构建参数

Dockerfile支持以下构建参数（ARG）：

• image：基础镜像（默认：tensorflow/tensorflow）
• tag：Tensorflow基础镜像标签（默认：1.14.0-py3）
• pyVer：Python版本（'python'对应Python2，'python3'对应Python3，默认：python3）

构建示例

构建Tensorflow 1.14.0 CPU版本（Python3）：

bash
$ docker build -t deephdc/deep-oc-generic-dev:tf1.14.0-cpu --build-arg tag=1.14.0-py3 --build-arg pyVer=python3 .

Jupyter Notebook/Lab认证

通过Token认证

首次访问Jupyter时，需在登录页面输入token。Token可通过以下方式获取：

• 容器启动终端的输出日志
• 执行docker logs <containerID>查看容器日志

通过密码认证

启动容器时可通过环境变量jupyterPASSWORD设置密码：

bash
$ docker run -ti -p 5000:5000 -p 6006:6006 -p 8888:8888 -e jupyterPASSWORD=your_secure_password deephdc/deep-oc-generic-dev

注意：密码长度需超过8个字符，引号会被视为密码的一部分。