创建notebook实例-九游平台

背景信息

• notebook使用涉及到计费，具体收费项如下：
  • 处于“运行中”状态的notebook，会消耗资源，产生费用。根据您选择的资源不同，收费标准不同，价格详情请参见。当您不需要使用notebook时，建议停止notebook，避免产生不必要的费用。
  • 创建notebook时，如果选择使用云硬盘evs存储配置，实例不删除，云硬盘evs会一直收费，建议及时停止并删除notebook，避免产品不必要的费用。
• 在创建notebook时，默认会开启自动停止功能，在指定时间内停止运行notebook，避免资源浪费。

• 只有处于“运行中”状态的notebook，才可以执行打开、停止操作。
• 一个账户最多创建10个notebook。

创建notebook实例

1. 登录modelarts管理控制台，在左侧导航栏中选择“权限管理”，检查是否配置了访问授权。如果未配置，请先配置访问授权。参考使用委托授权完成操作。
   图1 查看委托配置信息
   
2. 登录modelarts管理控制台，在左侧导航栏中选择“开发空间 > notebook”，进入“notebook”页面。
3. 单击右上角“创建”，进入“创建notebook”页面，请参见如下说明填写参数。
   1. 填写notebook基本信息，包含名称、描述、是否自动停止，详细参数请参见表1。
      图2 notebook基本信息
      

      表1 基本信息的参数描述

      参数名称	说明
      “名称”	notebook的名称。系统会自动生成一个名称，您可以根据业务需求重新命名，命名规则如下：只能包含数字、大小写字母、下划线和中划线，长度不能超过128位且不能为空。
      “描述”	对notebook的简要描述。
      “自动停止”	默认开启，且默认值为“1小时”，表示该notebook实例将在运行1小时之后自动停止，即1小时后停止规格资源计费。可选择“1小时”、“2小时”、“4小时”、“6小时”或“自定义”几种模式。选择“自定义”模式时，可指定1~72小时范围内任意整数。 定时停止：开启定时停止功能后，该notebook实例将在运行时长超出您所选择的时长后，自动停止。 说明： 出于对用户任务进度的保护，在您设置的自动停止时间到达后，notebook不会立即自动停止，可能会有2-5分钟的延迟，方便您进行续约。

   2. 填写notebook详细参数，如镜像、资源规格等，详细参数请参见表2。
      图3 notebook实例的详细参数
      

      表2 notebook实例的详细参数说明

      参数名称	说明
      “镜像”	支持公共镜像和自定义镜像。 公共镜像：即预置在modelarts内部的ai引擎。 可以选择界面显示的公共镜像，也可以单击“前往ai gallery获取更多镜像”进入ai gallery镜像页面。上发布了一些较高版本的pytorch、mindspore、tensorflow镜像。进入ai gallery镜像页面后，单击镜像名称，可查看镜像详情，复制对应局点的镜像url，即可在modelarts控制台“镜像管理”注册并在notebook中使用。 如果需要使用更高版本的mindspore类型的ascend架构镜像，可选择西南-贵阳一局点。 自定义镜像：可以将基于公共镜像创建的实例保存下来，作为自定义镜像使用，请参考保存notebook实例。也可以基于预置镜像或第三方镜像制作自定义镜像，请参考notebook的自定义镜像制作方法。 一个镜像对应支持一种ai引擎，创建notebook实例时选择好了对应ai引擎的镜像。用户可以根据需要选择镜像。在右侧搜索框中输入镜像名称关键字，可快速查找镜像。 notebook运行停止后，可以在同一个notebook实例中变更镜像。
      “资源类型”	支持公共资源池和专属资源池。 “公共资源池”无需单独购买，即开即用，按需付费，即按您的notebook实例运行时长进行收费。 “专属资源池”按实际情况选择已创建的专属资源池。如果没有专属资源，需要单独购买并创建。 说明： 如果您购买的专属池是单节点的tnt004规格：gpu: 1*tnt004 | cpu: 8 核 32gib (modelarts.vm.gpu._tnt004u8)，使用该集群创建notebook实例时，tnt004卡空闲但是规格显示售罄或者创建失败显示资源不足时，请联系技术支撑。
      “类型”	芯片类型包括cpu、gpu和ascend类型。 不同的镜像支持的芯片类型不同，根据实际需要选择。 gpu性能更佳，但是相对cpu而言，费用更高。
      “实例规格”	根据选择的芯片类型不同，可选资源规格也不同。请根据界面实际情况和需要选择。 cpu规格 “2核8gb”：intel cpu通用规格，用于快速数据探索和实验 “8核32gb”：intel cpu算力增强型，适用于密集计算场景下运算 gpu规格 “gpu: 1*vnt1(32gb)|cpu: 8 核 64gb”：gpu单卡规格，32gb显存，适合深度学习场景下的算法训练和调测 “gpu: 1*tnt004(16gb)|cpu: 8核* 32gb”： gpu单卡规格，16gb显存，推理计算最佳选择，覆盖场景包括计算机视觉、视频处理、nlp等 “gpu: 1*pnt1(16gb)|cpu: 8核 64gb”：gpu单卡规格，16gb显存，适合深度学习场景下的算法训练和调测 ascend规格 有snt9(32gb显存)单卡、两卡、八卡等规格。配搭arm处理器，适合深度学习场景下的模型训练和调测。
      “存储配置”	包括“云硬盘evs”、“弹性文件服务sfs”、“对象存储服务obs”和“并行文件系统pfs”。请根据界面实际情况和需要选择。 说明： “对象存储服务obs”、“并行文件系统pfs”是白名单功能，如果有试用需求，请提工单申请权限。 选择“云硬盘evs”作为存储位置。 根据实际使用量设置磁盘规格。磁盘规格默认5gb。磁盘规格的最大值请以实际界面显示为准。 从notebook实例创建成功开始，直至实例删除成功，磁盘每gb按照规定费用收费。 选择“弹性文件服务sfs”作为存储位置。 仅专属资源池支持，并需要在专属资源池对应的网络打通vpc才能生效，具体操作请参见modelarts网络。 说明： 如果需要设置sfs turbo的文件夹权限，请参考权限管理文档配置。 “弹性文件服务”：选择已创建的sfs turbo（在创建sfs turbo）。 “云上挂载路径”：默认为/home/ma-user/work/。 “子目录挂载”：选择sfs turbo的存储位置。 “挂载方式”：当用户配置了文件夹控制权限，则显示此参数。根据sfs turbo存储位置的权限显示“读写”或“只读”。 选择“对象存储服务obs”或“并行文件系统pfs”作为存储位置。 选择“存储位置”：设置用于存储notebook数据的obs路径。如果想直接使用已有的文件或数据，可将数据提前上传至对应的obs路径下。“存储位置”不能设置为obs桶的根目录，需设置为对应obs桶下的具体目录。 选择“凭据”：选择已有的凭据或单击右侧的“立即创建”，跳转至数据加密控制台创建凭据，凭据键/值填写用户的ak、sk信息（“键”分别填写“accesskeyid”，“secretaccesskey”；“值”在控制台个人账号下“我的凭证>访问密钥”获取ak、sk）。 图4 设置凭据值 “云硬盘evs”、“弹性文件服务sfs”的存储路径挂载在/home/ma-user/work目录下。 notebook实例运行中，可以通过动态挂载obs并行文件系统操作来增加数据存储路径。 停止或重启notebook实例时，存储的内容会被保留，不丢失。 删除notebook实例时，evs存储会一起释放，存储的内容不保留。sfs可以重新挂载到新的notebook，可以保留数据。
      “扩展存储配置”	说明： “扩展存储配置”功能是白名单功能，如果有试用需求，请提工单申请权限。 如果有多个数据存储路径，可以单击“增加扩展存储配置”，增加用户指定的存储挂载目录。支持增加的存储类型有“存储桶obs”、“并行文件系统pfs”、“弹性文件服务sfs”。 约束限制： 每种存储类型最多支持挂载5个。 扩展存储挂载目录不允许重复，不允许挂载到黑名单目录，允许嵌套挂载。不允许挂载的黑名单目录为以下前缀匹配的目录： /data/、/cache/、/dev/、/etc/、/bin/、/lib/、/sbin/、/modelarts/、/train-worker1-log/、/var/、/resource_info/、/usr/、/sys/、/run/、/tmp/、/infer/、/opt/ 添加扩展存储后，可进入notebook实例详情页，单击“存储配置 > 扩展存储”，查看或编辑扩展存储信息。在存储个数未达到最大个数时，也可在右侧单击“添加扩展存储”。
      “ssh远程开发”	开启此功能后，用户可以在本地开发环境中远程接入notebook实例的开发环境。 实例在停止状态时，用户可以在notebook详情页中更新ssh的配置信息。 说明： 开启此功能的实例中会预置vs code插件（python、jupyter等）以及vs code server包，会占用约1g左右的持久化存储空间。
      “密钥对”	开启“ssh远程开发”功能后，需要设置此参数。 可以选择已有密钥对。 也可以单击密钥对右侧的“立即创建”，跳转到数据加密控制台，在“密钥对管理 > 账号密钥对”页面，单击“创建密钥对”。 创建完notebook后，可以在notebook详情页中修改密钥对。 注意： 创建好的密钥对，请下载并妥善保存，使用本地ide远程连接云上notebook开发环境时，需要用到密钥对进行鉴权认证。
      “远程访问白名单”	可选，开启“ssh远程开发”功能后，可以设置此参数。 设置为允许远程接入访问这个notebook的ip地址（例如本地pc的ip地址或者访问机器的外网ip地址，最多配置5个，用英文逗号隔开），不设置则表示无接入ip地址限制。 如果用户使用的访问机器和modelarts服务的网络有隔离，则访问机器的外网地址需要在主流搜索引擎中搜索“ip地址查询”获取，而不是使用ipconfig或ifconfig/ip命令在本地查询。 图5 查询外网ip地址 创建完notebook后，可以在notebook详情页中修改白名单ip地址。

   3. 可选：添加notebook标签。在标签栏输入“标签键”和“标签值”，单击“添加”。

      表3 添加标签

      参数名	参数说明
      “标签”	modelarts支持对接标签管理服务tms，在modelarts中创建资源消耗性任务（例如：创建notebook、训练作业、推理在线服务）时，可以为这些任务配置标签，通过标签实现资源的多维分组管理。 标签详细用法请参见modelarts如何通过标签实现资源分组管理。 添加标签后，可在notebook实例详情页查看标签内容，也可进行修改、删除标签。

      

      可以在标签输入框下拉选择tms预定义标签，也可以自己输入自定义标签。预定义标签对所有支持标签功能的服务资源可见。租户自定义标签只对自己服务可见。

4. 参数填写完成后，单击“立即创建”进行规格确认。
5. 参数确认无误后，单击“提交”，完成notebook的创建操作。

   进入notebook列表，正在创建中的notebook状态为“创建中”，创建过程需要几分钟，请耐心等待。当notebook状态变为“运行中”时，表示notebook已创建并启动完成。

6. 在notebook列表，单击实例名称，进入实例详情页，查看notebook实例配置信息。
   图6 查看notebook实例详情
   

   “ssh远程开发”功能开启时，在“白名单”右侧单击修改，可以修改允许远程访问的白名单ip地址。实例在停止状态时，在“认证”右侧单击修改，用户可以更新密钥对。

   单击“存储配置”页签的“添加数据存储”，可以挂载obs并行文件系统，方便读取数据，具体操作参见动态挂载obs并行文件系统。

   如果存储使用的是云硬盘evs，单击存储容量右侧的“扩容”，可以动态扩充云硬盘evs的容量，具体操作参见动态扩充云硬盘evs容量。

打开notebook实例

针对创建好的notebook实例（即状态为“运行中”的实例），可以打开notebook并在开发环境中启动编码。

pytorch、tensorflow、mindspore、tensorflow-mindspore、cylp-cbcpy、rlstudio-ray、mindquantum-mindspore镜像支持以下2种方式访问：

• 在线jupyterlab访问，具体参见通过jupyterlab在线使用notebook实例进行ai开发。
• 本地ide使用pycharm工具，远程连接访问，具体参见通过pycharm远程使用notebook实例。
• 本地ide使用vs code工具，远程连接访问，具体参见通过vs code远程使用notebook实例。
• 本地ide使用ssh工具，远程连接访问，具体参见通过ssh工具远程使用notebook。

modelarts提供的notebook实例是以ma-user启动的，用户进入实例后，工作目录默认是/home/ma-user。

notebook容器挂载目录介绍

创建notebook实例，存储选择evs时，notebook会使用/home/ma-user/work目录作为用户的工作空间持久化存储。

存放在work目录的内容，在实例停止、重新启动后依然保留，其他目录下的内容不会保留，使用开发环境时建议将需要持久化的数据放在/home/ma-user/work目录。

更多notebook实例的目录挂载情况（以下挂载点在保存镜像的时候不会保存）如表4所示。

notebook选择存储说明

不同存储的实现方式都不同，在性能、易用性、成本的权衡中可以有不同的选择，没有一个存储可以覆盖所有场景，了解下云上开发环境中各种存储使用场景说明，更能提高使用效率。

1. 在开发环境中如何使用云硬盘evs块存储？

   例如，在创建notebook实例时选择云硬盘evs存储小容量，notebook运行过程中如果发现存储容量不够，可以扩容，请参考动态扩充云硬盘evs容量。

2. 在开发环境中如何使用obs并行文件系统？

   例如，在notebook中训练时，可直接使用挂载至notebook容器中的数据集，在运行过程中可以动态挂载obs并行文件系统。