Notebook使用说明
在软件开发领域，随着技术的发展，降低开发者成本和提升开发体验一直是追求的目标。然而，在AI开发阶段，开发者们面临着工具链复杂、资源管理困难等挑战，这与传统软件开发形成了鲜明对比。如何解决这些问题，提升AI开发的效率和体验？ModelArts提供灵活开放的开发环境，通过云原生的资源使用和开发工具链的集成，旨在为不同类型AI开发、探索、教学用户提供更好的云化AI开发体验，降低开发门槛。
控制台导航栏说明
为了提升创建Notebook的效率，ModelArts对导航栏进行了一系列的易用性改进。现推出新版导航栏入口样式，旨在简化操作流程并增强界面的直观性。
- 本文档中的“新版”：是指“西南-贵阳一”区域的默认控制台界面，部分新版功能需要切换至该区域查看使用，对应的文档适用于此区域新版控制台。
- 本文档中的“旧版”：是指除“西南-贵阳一”区域外的其他区域默认控制台界面（“西南-贵阳一”区域也可切回旧版）。
Notebook导航栏入口：
- 新版：选择，进入“Notebook”页面。
图1 新版入口
- 旧版：选择，进入“Notebook”页面。
图2 旧版入口
Notebook入门案例
ModelArts新版控制台提供了很多Notebook的入门案例，您可以登录ModelArts新版控制台，在左侧导航栏选择“快速入门”，在“开发实践”页签单击案例卡片，了解案例详细说明，也可以在案例卡片中单击“开发”，快速实现对应的功能。
使用Notebook
创建Notebook
ModelArts提供了云化版本的Notebook，无需关注安装配置，即开即用，具体参见创建Notebook实例（新版页面）。
打开Notebook
- JupyterLab：支持通过JupyterLab工具在线打开Notebook，具体请参见通过JupyterLab在线使用Notebook实例。
图4 使用JupyterLab在线开发调试代码
- 本地IDE：支持本地IDE的方式开发模型，通过开启SSH连接，用户本地IDE可以远程连接到ModelArts的Notebook开发环境中，调试和运行代码。本地IDE方式不影响用户的编码习惯，并且可以方便快捷地使用云上的Notebook开发环境。
本地IDE当前支持VS Code、PyCharm、SSH工具。PyCharm和VS Code还分别有专门的插件PyCharm Toolkit、VS Code Toolkit，让远程连接操作更便捷。具体参见通过PyCharm远程使用Notebook实例、通过VS Code远程使用Notebook实例、通过SSH工具远程使用Notebook。
图5 本地IDE远程访问Notebook
管理Notebook
在Notebook的使用中，可以快速查找实例，可以在同一个Notebook实例中切换镜像，方便用户灵活调整实例的AI引擎；可以切换节点运行规格，方便用户灵活调整规格资源；可以初期存储使用量较小时选择小存储，可以在创建完成后根据需要扩充EVS容量；使用动态挂载OBS将OBS对象存储模拟成本地文件系统；还可以在Notebook异常时查看实例的事件定位等，具体参见管理Notebook实例。
上传文件至Notebook
- 将本地文件上传，请参考支持上传本地文件。
- GitHub的开源仓库的文件上传，请参考支持Clone GitHub开源仓库。
- 存放在OBS中的文件上传，请参考支持上传OBS文件。
- 类似开源数据集这样的远端文件上传，请参考支持上传远端文件。
CodeLab
ModelArts提供了CodeLab功能，一方面，一键进入开发环境，同时预置了免费的算力规格，可直接免费体验Notebook功能；另一方面，针对AI Gallery社区发布的Notebook样例（.ipynb格式文件），可直接在CodeLab中打开，查看他人分享的样例代码，具体请参见使用CodeLab免费体验Notebook。
ModelArts CLI
ModelArts CLI集成在ModelArts开发环境Notebook中，用于连接ModelArts服务并在ModelArts资源上执行管理命令。ma-cli支持用户在ModelArts Notebook及线下虚拟机中与云端服务交互，使用ma-cli命令可以实现命令自动补全、鉴权、镜像构建、提交ModelArts训练作业、提交DLI Spark作业、OBS数据复制等，具体参见ModelArts CLI命令参考。
MoXing
ModelArts Notebook内置MoXing Framework模块，ModelArts mox.file提供了一套更为方便地访问OBS的API，允许用户通过一系列模仿操作本地文件系统的API来操作OBS文件。具体参见在Notebook中使用MoXing命令。
