Notebook的自定义镜像制作方法

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

Notebook自定义镜像制作流程

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

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

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

场景三：通过预置的镜像创建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“镜像管理”页面。