创建并使用Notebook

Notebook功能介绍

• 提供一个云平台集成的机器学习实验环境，在该环境中您可以进行机器学习的本地开发。

• 提供一个拷贝或者处理数据集的工具，将处理完的数据集直接提交至持久化存储，还可以结合大数据工具进行数据集的处理。

• 提供机器学习的测试、预处理等工作环境，在该环境中您可以编写、调试机器学习主要代码，且将其打包成docker Image推送至集群本地或者远程的容器镜像仓库。

步骤一：创建Notebook

1. 登录开发控制台。具体操作，请参见访问AI开发控制台。

2. 在开发控制台左侧导航栏中，单击Notebook。

3. 在Notebook页面，单击创建Notebook。

4. 在Notebook message、Notebook资源配置和高级配置区域，配置相关信息后，单击创建Notebook。

   

   • 在Notebook message区域：

     1. 输入Notebook名称，选择Notebook镜像和命名空间，其中命名空间只能提交到集群管理员为开发分配的命名空间中，Notebook镜像可选择默认镜像和自定义镜像，其他选项请按需配置。

        说明

        • 选择Notebook镜像时，请务必选择适合您需求的Notebook镜像。Jupyter Notebook只能选择Jupyter镜像，VSCode Notebook只能选择VSCode镜像，否则Notebook无法正常工作。

        • 自定义Notebook镜像仅在当前集群中可见，其他集群或多用户无法共享。

     2. 打开Workspace PVC开关，在Workspace持久化的目标PVC下拉列表，选择Workspace挂载的PVC。

     3. 打开Token开关，给Notebook注入自定义Token来增强安全性。目前仅支持Jupyter类型的Notebook。

     4. 通过选择Notebook Type来决定镜像的启动方式，因为不同的Notebook类型需要在不同的环境中运行。例如，当Notebook Type选择Jupyter时，表示创建一条Jupyter Notebook类型的Notebook。

   • 在Notebook资源配置区域，输入CPU（核数）和GPU卡数，选择内存（GPU）。

   • 在高级配置区域，您可以选择添加Label、Annotation、NodeSelector、Toleration为您的Notebook增加配置。

5. 任务创建完成后，您可以在Notebook页面，单击刚创建的Notebook的名称，即可查看Notebook的运行状况等信息。

步骤二：使用Notebook

制作Notebook自定义镜像说明

您在制作Notebook自定义镜像之前，首先请在Jupyter Notebook或VSCode Notebook环境中安装最新版的Arena组件，然后才能在开发环境中运行为您提供的Demo示例流程。关于如何安装Arena组件，请参见配置Arena客户端。

FROM tensorflow/tensorflow:1.15.5-gpu
USER root
RUN pip install jupyter && \
    pip install ipywidgets && \
    jupyter nbextension enable --py widgetsnbextension && \
    pip install jupyterlab && jupyter serverextension enable --py jupyterlab
# 下载安装Arena的Python SDK工具包。
RUN pip install arenasdk
# 您可以通过其他途径安装JupyterLab，但是必须暴露服务到8888端口。
EXPOSE 8888
USER jovyan

FROM ubuntu:18.04
USER root

RUN apt update && \
  	apt install -y curl

RUN cd /opt && \
  	wget https://aliacs-k8s-cn-hongkong.oss-cn-hongkong.aliyuncs.com/arena/install.sh && \
    /opt/install.sh

在Notebook中保存自身为镜像

云原生AI套件开发控制台组件ack-ai-dev-console在1.0.22及以后版本中，支持在Notebook中提交该Notebook自身为镜像并保存到宿主机中，以达到保存该Notebook开发环境的目的。

如果您需要在Notebook中保存自身为镜像，可以按照以下操作步骤执行：

1. 在Notebook中下载ack-commit-agent的一个客户端二进制工具，这里是该工具的下载地址。

2. 下载结束之后，您需要在Notebook中执行以下命令，使得该客户端全局可执行。

   chmod +x ack-commit-ctl
   mv ack-commit-ctl /usr/bin/

3. 使用该工具提交保存Notebook的镜像，这里展示一个提交镜像的示例操作。

   ack-commit-ctl commit image-commit-sample:v0.1.0-test
   INFO[0000] container id: xxx
   INFO[0002] Container save success, image: image-commit-sample:v0.1.0-test

   提交操作结束后出现类似以上输出说明将该Notebook保存为镜像提交成功。

4. 执行以下命令，指定镜像仓库的用户名和密码，将镜像推送到镜像仓库中。

   ack-commit-ctl push image-commit-sample:v0.1.0-test --username=username --password=password
   INFO[0000] Start pushing the image:  image-commit-sample:v0.1.0-test 
   INFO[0000] Waiting...                                   
   INFO[0003] Image pushed successfully: image-commit-sample:v0.1.0-test

   出现类似以上输出则说明镜像已成功推送到镜像仓库中。