文档首页/ 魔坊（ModelArts）模型训推平台/ 镜像管理/ 镜像注册与管理
更新时间：2026-07-17 GMT+08:00
查看PDF
分享

镜像注册与管理

ModelArts提供注册镜像功能，支持用户自行制作容器镜像并在ModelArts上运行。本文介绍如何注册镜像，并对已注册镜像进行使用、查看、编辑、删除等操作。

关于自定义镜像的制作，请参见制作自定义镜像用于创建Notebook、制作自定义镜像用于训练模型和制作自定义镜像用于推理。

注册镜像

  1. 登录ModelArts管理控制台，在左侧导航栏按需选择以下操作。
    • 新版控制台：选择“资产管理 > 镜像”，选择“已注册镜像”页签，单击“注册镜像”。
    • 旧版控制台：选择“资产管理 > 镜像管理”，选择“已注册镜像”页签，单击“注册镜像”。
  2. 在“注册镜像”页面，按需配置以下参数，单击“立即注册”。
    图1 注册镜像

    表1 注册镜像参数说明

    参数

    说明

    镜像源

    任选以下方式配置镜像源：

    • 方式一：直接输入镜像路径。

      镜像路径示例：<swr-domain-name>/<namespace>/<repository>:<tag>。

    • 方式二：单击图标，按需选择“容器镜像服务SWR”或者“SWR企业版”页签中的镜像，单击“确定”。

      关于SWR镜像的详细信息，请参见什么是容器镜像服务。

    标签

    输入镜像的标签，最多可添加20个标签。

    版本描述

    自定义镜像的版本描述，最大支持256个字符，不能包含字符&<>"'/。

    架构

    按需选择ARM或x86_64，需要和镜像源保持一致。

    您可以通过docker run --rm {image_name} uname -m命令查看架构。image_name请替换为实际镜像。示例如下： 
    docker run --rm swr.cn-north-4.myhuaweicloud.com/dev-custom/notebook-test-cc:v5 uname -m

    如下图所示，该镜像的架构为x86。

    图2 查看镜像架构

    类型

    按需选择NPU、CPU或GPU，需要和镜像源保持一致。

    您可以通过镜像地址查看安装的是cuda或cann包。cuda包为GPU，cann包为NPU。

    例如，镜像地址为swr.cn-north-4.myhuaweicloud.com/atelier/pytorch_cuda:pytorch_1.12.1-cuda_10.2-py_3.9.11-ubuntu_20.04-x86_64-20260425154604-d9a1f9f，从“cuda_10.2”可以看到安装的是cuda，因此类型为GPU。

    规格

    按镜像选择目标规格。当类型选择NPU时，规格对应的机型和镜像机型需要保持一致。

    规格可以从镜像地址中获取。例如，镜像地址为swr.cn-north-4.myhuaweicloud.com/atelier/pytorch_ascend:pytorch_2.7.1-cann_8.5.2-py_3.12-euler_2.10.11-aarch64-snt9b-20260417112518-aabfd52，可以看到镜像规格为snt9b。

    镜像说明

    对上传的自定义镜像进行说明。仅支持上传.md文件，且不超过32KB。最大支持30000个字符。

    单击添加文件，支持修改上传后的Markdown文件或直接编辑Markdown文件。示例如下：

    # 镜像的主要作用
...
# 不同镜像版本的区别
...
# 镜像的使用方法
...

    新增的镜像说明将会在“概览信息”页签展示。

    在“已注册镜像”页签可以查看注册好的镜像。

使用注册镜像

镜像注册完后，您可以在模型训练、在线推理和Notebook中使用该镜像。

  • 模型训练：
    • 新版控制台：创建训练自定义作业时，在“训练配置”区域，选择“自定义镜像”，单击图标，在“选择镜像”面板的“已注册镜像”页签，按需选择已注册镜像。具体操作，请参见创建训练自定义作业。
      图3 训练配置-自定义镜像

    • 旧版控制台：创建训练作业时，在“环境配置”区域，“启动方式”选择“自定义”，输入已注册的镜像。具体操作，请参见创建生产训练作业。
  • 在线推理：部署在线服务时，在“单元配置”区域，选择“自定义镜像”，单击图标，在“选择镜像”面板的“已注册镜像”页签，按需选择已注册镜像。具体操作，请参见推理部署。
    图4 单元配置-自定义镜像

  • Notebook：创建Notebook时，在“环境配置”区域，选择“自定义镜像”，单击图标，在“选择镜像”面板的“已注册镜像”页签，按需选择已注册镜像。具体操作，请参见创建Notebook实例。
    图5 环境配置-自定义镜像

添加镜像版本

在“已注册镜像”页签，任选以下方式添加镜像版本。
  • 方式一：
    1. 在目标镜像的“操作”列，单击“添加版本”。
    2. 在“添加镜像版本”面板，单击图标，选择目标版本，单击“确定”，按需配置版本描述、架构、类型和规格，单击“确定”。
    3. 在“已注册镜像”页签，单击镜像名称，在“版本列表”页签，查看新增的版本及相关信息。
  • 方式二：
    1. 单击目标镜像名称，在页面右上角，单击“添加版本”。
    2. 在“添加镜像版本”面板，单击图标，选择目标版本，单击“确定”，按需配置版本描述、架构、类型和规格，单击“确定”。
    3. 在“版本列表”页签，查看新增的版本及相关信息。

编辑已注册镜像

  1. 在“已注册镜像”页签，任选以下方式编辑已注册镜像。
    关于参数的说明，请参见表1。
    • 方式一：
      1. 在目标镜像的“操作”列，单击“编辑”。
      2. 在“编辑镜像”面板，按需配置镜像说明和标签，单击“确定”。
    • 方式二：
      1. 单击目标镜像名称，在页面右上角，单击“编辑”。
      2. 在“编辑镜像”面板，按需配置镜像说明和标签，单击“确定”。
    图6 编辑镜像
  2. 查看编辑后的镜像说明和标签。
    • 查看编辑后的镜像说明：在“已注册镜像”页签，单击目标镜像名称，在“概览信息”页签查看镜像说明。
    • 查看编辑后的标签：在“已注册镜像”页签的“标签”列，鼠标悬浮至图标上，查看编辑后的标签。

基于已注册镜像创建Notebook

  1. 在“已注册镜像”页签，单击目标镜像名称，选择“版本列表”。
  2. 在“版本列表”页签的操作列，单击镜像版本对应的“创建Notebook”。
  3. 在“创建Notebook”页面，配置相关信息并勾选协议，单击“立即创建”。

    关于参数的说明，请参见创建Notebook实例。

新增概览信息

如下图所示，如果您在注册镜像时，未配置镜像说明，“概览信息”页签会显示“暂无概览信息”。您可以参照以下步骤或编辑已注册镜像增加概览信息。

图7 概览信息
  1. 在“已注册镜像”页签，单击目标镜像名称，在“概览信息”页签，单击“填写镜像说明”。
  2. 在“镜像说明”面板，单击“添加文件”，上传.md文件。

    关于.md文件的说明和示例，请参见表1。

镜像同步

从容器镜像服务SWR同步镜像状态。

  1. 在“已注册镜像”页签，单击目标镜像名称。
  2. 在“版本列表”页签的操作列，单击“镜像同步”。

    页面显示“同步状态命令发送成功”，表示镜像同步成功。

    图8 镜像同步

删除镜像版本

删除操作无法恢复，删除后使用该镜像版本的所有实例将重启失败，请谨慎操作。

  1. 在“已注册镜像”页签，单击目标镜像名称。
  2. 在“版本列表”页签的操作列，单击目标版本对应的“删除”。
  3. 在“删除版本”对话框，输入DELETE，单击“确定”。

    仅通过Notebook镜像保存功能注册的镜像版本，支持删除关联的SWR镜像版本。

    图9 删除关联的SWR镜像版本

删除已注册镜像

删除操作无法恢复，删除后使用该镜像的所有实例将重启失败，请谨慎操作。删除镜像操作不会删除关联SWR镜像，仅会解除与SWR镜像的关联关系，SWR镜像本身不受影响。

请任选以下方式删除已注册镜像。

  • 方式一：
    1. 在“已注册镜像”页签的操作列，单击“删除”。
    2. 在“删除镜像”对话框，输入DELETE，单击“确定”。
  • 方式二：
    1. 在“已注册镜像”页签，单击目标镜像名称。
    2. 在页面右上角，单击“删除”，在“删除镜像”对话框，输入DELETE，单击“确定”。