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

   出現類似以上輸出則說明鏡像已成功推送到鏡像倉庫中。