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

镜像注册与管理

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

注册镜像

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

    参数

    说明

    镜像源

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

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

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

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

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

    标签

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

    版本描述

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

    架构

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

    类型

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

    规格

    按需选择目标规格。

    镜像说明

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

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

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

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

添加镜像版本

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

编辑已注册镜像

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

基于已注册镜像创建Notebook

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

    关于参数的说明，请参见创建Notebook实例（新版页面）。

新增概览信息

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

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

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

镜像同步

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

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

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

    图5 镜像同步

删除镜像版本

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

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

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

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

删除已注册镜像

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

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

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

相关文档