notebook的自定义镜像制作方法-九游平台

用户在使用modelarts开发环境时，经常需要对开发环境进行一些改造，如安装、升级或卸载一些包。但是某些包的安装升级需要root权限，运行中的notebook实例中无root权限，所以在notebook实例中安装需要root权限的软件，目前在预置的开发环境镜像中是无法实现的。用户可以使用modelarts提供的基础镜像或用户第三方镜像来编写dockerfile，构建出完全适合自己的镜像。

notebook自定义镜像制作流程

图1 notebook自定义镜像制作流程图（适用于场景一和场景二）

场景一：基于notebook预置镜像或第三方镜像，在服务器上配置docker环境，编写dockerfile后构建镜像并注册，具体案例参考在ecs上构建自定义镜像并在notebook中使用

场景二：基于notebook提供的预置镜像或第三方镜像，借助modelarts命令行工具(ma-cli镜像构建命令介绍)制作和注册镜像，构建一个面向ai开发的自定义镜像。此场景notebook作为制作镜像的平台。具体案例参考在notebook中通过dockerfile从0制作自定义镜像。

场景三：通过预置的镜像创建notebook实例，在预置镜像上安装对应的自定义软件和依赖，进而将运行的实例环境以容器镜像的方式保存下来。具体案例参考在notebook中通过镜像保存功能制作自定义镜像。

notebook自定义镜像规范

制作自定义镜像时，base镜像需满足如下规范：

基于昇腾、dockerhub九游平台官网等官方开源的镜像制作，开源镜像需要满足如下操作系统约束：
x86：ubuntu18.04、ubuntu20.04

arm：euler2.8.3、euler2.10.7

ubuntu20.04.6可能有兼容性问题，请优先使用低于该版本的操作系统。
不满足以上镜像规范，所制作的镜像使用可能会出现故障，请用户检查镜像规范，并参考notebook自定义镜像故障基础排查自行排查，如未解决请联系华为技术工程师协助解决。

构建后需要注册镜像

用户的自定义镜像构建完成后，需要在modelarts“镜像管理”页面注册后，方可在notebook中使用。

swr镜像类型设置为“私有”时，同一账号下的子用户（iam用户）可以注册使用。

swr镜像类型设置为“公开”时，其他用户才可以注册使用。

进入modelarts控制台，单击“镜像管理 > 注册镜像”，进入“注册镜像”页面。
根据界面提示填写相关信息，然后单击“立即注册”。
- “镜像源”选择构建好的镜像。可直接复制完整的swr地址，或单击选择swr构建好的镜像进行注册。
  图2 选择镜像源
- “架构”、“类型”和“规格”：根据自定义镜像的实际框架选择。
注册后的镜像会显示在modelarts“镜像管理”页面。