管理镜像

约束与限制

• 系统镜像为内置镜像，不支持修改和删除。
• 系统预置角色中，不同角色的权限如下。
  • 当前工作空间管理员，以及具有DAYU Administrator或者Tenant Administrator权限的用户，可以创建和管理所有自定义镜像。
  • 开发者可以新建和管理自己创建的自定义镜像，可以查询工作空间下的所有自定义镜像。
  • 运维者和访客仅具有查询工作空间下所有自定义镜像的权限。
• 用户自定义角色的用户，拥有“新建”权限时，可以创建自定义镜像，和对自己创建的自定义镜像进行管理。拥有“删除”、“操作”、“查询”和“编辑”权限时，可以对工作空间下的所有自定义镜像进行对应操作。创建自定义角色请参考（可选）自定义工作空间角色。
• 如果用户同时拥有系统预置角色和用户自定义角色，其权限取两种角色权限的并集。
• 同一个工作空间最多可以创建100个自定义镜像。
• 同一个工作空间创建的自定义镜像不能重名。

查看系统镜像

1. 登录DataArts Studio管理控制台。

   详情请参考访问DataArts Studio实例控制台。

2. 在DataArts Studio控制台首页，选择对应工作空间的“管理中心”模块，进入管理中心页面。
3. 在管理中心页面，单击“镜像管理”，进入镜像管理页面。
4. 选择“系统镜像”页签，查看系统镜像。
   图1 查看系统镜像
   

创建自定义镜像

用户可基于公开镜像通过Dockerfile构建包含所需依赖的自定义镜像，然后推送至容器镜像服务（SWR）后在DataArts Studio控制台完成注册。注册后的自定义镜像可在创建Notebook运行环境和Notebook作业调度配置时选用，实现运行环境的标准化管理和复用。

1. 下载镜像。
   1. 准备容器环境。

      请参考安装容器引擎文档中的“安装容器引擎”章节。

   2. 选择合适的基础镜像。DataArts Studio当前支持选择表1中所列举的基础镜像。

      表1 Notebook基础镜像

      镜像名称	镜像版本	下载指令	说明
      dgc-notebook-kernel-public-x86_64:26.9.0.20260910160323	26.9.0.20260910160323	docker pull swr.cn-north-7.myhuaweicloud.com/dgc-notebook/dgc-notebook-kernel-public-x86_64:26.9.0.20260910160323	python_version：3.10.6

   3. 使用root用户登录容器环境，执行1.b中选择镜像的下载指令获取镜像。

      示例：

      docker pull swr.cn-north-7.myhuaweicloud.com/dgc-notebook/dgc-notebook-kernel-public-x86_64:26.9.0.20260910160323

2. 制作自定义镜像。
   1. 连接容器镜像服务。
      1. 登录SWR管理控制台。
      2. 选择左侧导航栏的“总览”，单击页面右上角的“登录指令”，在弹出的页面中单击复制登录指令。
      3. 在安装容器引擎的虚拟机中执行上一步复制的登录指令。
   2. 创建容器镜像组织。如果已创建组织则本步骤可以忽略。
      1. 在SWR管理控制台的左侧导航栏中选择“组织管理”，单击页面右上角的“创建组织”。
      2. 填写组织名称，单击“确定”。
   3. 使用root用户登录容器环境，创建并编写Dockerfile文件。

      以下示例以Python基础镜像为例。Dockerfile文件以FROM指令开头，必须使用1下载的镜像作为基础镜像。FROM指令之后，可添加对镜像进行自定义修改的指令。

      1. 创建一个名为“Dockerfile”的文件。

         mkdir myimage

         cd myimage

         touch Dockerfile

      2. 编辑Dockerfile文件。

         vim Dockerfile

         增加文件内容如下：

         # Dockerfile
         FROM swr.cn-north-7.myhuaweicloud.com/dgc-notebook/dgc-notebook-kernel-public-x86_64:26.9.0.20260910160323
         
         # MODIFICATIONS GO HERE
         RUN pip install --upgrade pandas==2.1.0

      3. 按“Esc”，输入:wq，保存并退出。
   4. 创建并编写Dockerfile后，执行以下命令构建自定义镜像。

      示例：

      # build the docker image
      docker build -t 华为云SWR域名/组织/镜像名:版本 .

   5. 将自定义镜像推送至SWR。

      进入SWR首页，单击“登录指令”复制临时登录指令并执行，然后将镜像推送到SWR。

      示例：

      # login to SWR
      docker login -u cn-north-7@HST3UHL10SX8xxxxxxxx -p cb50728xxxxx swr.cn-north-7.myhuaweicloud.com
      # push the docker image
      docker push 华为云SWR域名/组织/镜像名:版本

3. 注册自定义镜像。
   1. 登录DataArts Studio管理控制台。

      详情请参考访问DataArts Studio实例控制台。

   2. 在DataArts Studio控制台首页，选择对应工作空间的“管理中心”模块，进入管理中心页面。
   3. 在管理中心页面，单击“镜像管理”，进入镜像管理页面，选择“自定义镜像”页签。Custom Images
   4. 单击界面上的“SWR注册镜像”，并参考下表配置相关参数。

      表2 注册镜像

      参数	参数说明
      镜像源	自定义镜像的SWR地址。 单击选择框，并单击镜像名称，勾选镜像版本，单击“确定”。 选择后会显示当前镜像源所属组织、名称、版本信息。 如果当前无可用SWR镜像，请先参考创建自定义镜像在SWR中创建自定义镜像。
      镜像类型	选择当前注册镜像的类型。
      CPU架构	选择当前注册镜像的CPU架构。当前仅支持x86_64架构。
      描述	填写自定义镜像的描述信息。可选参数。

   5. 填写完成后单击“保存”，完成注册。
   6. 可以在自定义镜像列表中查看自定义镜像的名称、镜像类型、所属组织、版本数、更新时间等信息。
   7. 用户可以根据需要对自定义镜像添加版本或进行删除。
      • 单击“操作”列中的“添加版本”，可以继续为当前镜像添加版本，最多支持100条软件版本。
      • 单击“操作”列中的“删除”，查看操作影响，并根据界面提示输入“DELETE”后，单击“确定”进行删除。
        

        • 删除操作会解除与SWR镜像的关联，对应的SWR镜像不受影响。
        • 删除操作无法恢复，请谨慎操作。