GenStudio LLM API 部分模型价格调整公告GenStudio LLM API 部分模型价格调整公告 ，新价格 2025 年 11 月 1 日生效调价公告
文档中心

Appearance

✨充值控制台

迁移外部镜像至租户镜像仓库 ​

本文描述如何将用户已有镜像或第三方公开镜像迁移到智算云平台的镜像中心。

前提条件 ​

  • 租户镜像仓库：租户已购买预付费资源（包两年/包年/包月/包周/包日）后，或已使用弹性资源创建开发机，可获得私有的租户镜像仓库。
  • 镜像基础组件要求：开发机依赖 sudo、ssh 等基础组件，如果您的自定义镜像中缺乏必要依赖，可能无法用于运行开发机。

镜像基础组件要求 ​

如果您的镜像用于开发机，请在镜像中包含平台要求的必要组件。

以下为 Shell 安装示例：

  • 基于 Debian Bookworm 的自定义镜像，必须安装以下组件：

    shell
    apt update && apt install openssh-server sudo runit runit-systemd -y

  • 基于 Ubuntu 22.04 的自定义镜像，必须安装以下组件：

    shell
    apt update && apt install openssh-server sudo runit runit-systemd -y

  • 基于 Ubuntu 24.04 的自定义镜像，必须安装以下组件：

    shell
    apt update && apt install openssh-server sudo runit runit-helper runit-run -y

如果镜像中缺失上述组件，在启动开发机时平台会尝试安装，但仍可能安装失败导致开发机无法正常启动，或 SSH 远程连接功能受限。以下为推荐的处理方案：

  • 如果仅针对当前开发机作一次性修复，可直接安装基础组件，重启开发机。

  • 推荐永久修复当前自定义镜像，操作方式：

    1. 在镜像中心构建自定义镜像，选择「基于现有镜像」中安装
    2. 在「安装命令」中输入以下安装命令，以 Ubuntu 22.04 为例：
      shell
      DEBIAN_FRONTEND=noninteractive apt-get update && DEBIAN_FRONTEND=noninteractive apt-get install openssh-server sudo runit runit-systemd -y
    3. 重启开发机，选择更新后的新版镜像。

公网推送镜像 ​

AIStudio 平台提供了灵活、便捷的上传镜像功能，用户可以轻松地将本地镜像上传到租户私有镜像仓库，或者直接通过第三方仓库镜像 URL 将镜像导入租户私有镜像仓库。

该方案需要经过公网推送镜像，实际推送速度受网络带宽影响。

直接拉取公网镜像 ​

对于存放在用户自建镜像仓库或第三方镜像仓库的远程镜像，只需填写相关 URL 和凭证信息即可。

警告

无论是自建镜像仓库 URL 或第三方镜像仓库 URL，请确保可从国内公网访问。如有登录认证，请提供正确的访问凭证。

  1. 在 AIStudio 的镜像中心，选择上传镜像，打开上传镜像弹窗。

  2. 在「选择资源池」的下拉列表中，选择一条记录后，表示镜像将上传到该可用区。如果使用该可用区的任何资源池创建开发机、任务、推理服务，均可使用该镜像。

    注意

    如果「选择资源池」的下拉列表有多行记录，每一行为一个可用区的所有资源池。选择一条记录后，表示镜像将上传到该可用区，单次仅能选择一个可用区。

  3. 选择 URL 上传，并填写镜像 URL。如需认证，务必填写凭证信息。

    alt text

从公网推送本地镜像 ​

对于本地镜像，用户需要获取租户私有仓库地址和必要的凭证来推送镜像。

  1. 在 AIStudio 的镜像中心，选择「上传镜像」。

  2. 在选择资源池的下拉列表中，每一行记录为一个可用区的所有资源池。选择一条记录后，表示镜像将上传到该可用区，如果使用该可用区的任何资源池创建开发机、任务、推理服务，均可使用该镜像。

  3. 选择命令行上传，并获取凭证和镜像仓库 URL。按照顺序执行 docker 命令即可。

    alt text

内网推送镜像 ​

该方式需要借助启用 Docker 容器功能的开发机，将用户已有镜像推送到智算云平台的租户镜像仓库。

用户将本地的容器镜像 tar 文件上传到 AIStudio 平台上的开发机。通过简单的 Docker 命令，如 load、tag 和 push，用户能够在开发机内将镜像推送到 AIStudio 提供的 Docker 仓库中。

迁移的主要流程：

  1. 创建开发机，并启用「Docker 容器」功能。
  2. 在开发机上准备用户镜像，可上传镜像文件开发机，或从指定的外部镜像仓库拉取到开发机。
  3. 推送到租户镜像仓库。

该方案需要提前上传容器镜像 tar 文件，但好处是 docker push 发生在集群内网中，无需经过公网，因此速度较快。

Step 0 创建开发机 ​

创建开发机，并打开「Docker 容器」功能。

创建开发机

alt text

如需帮助，参见 Docker 功能。

Step 1 准备待迁移镜像 ​

如果已有镜像 tar 包，可考虑以下步骤本地传输镜像文件至在开发机或共享存储中：

也可考虑直接从外部镜像仓库拉取到开发机，要求外部镜像仓库支持公网访问。

Step 2 推送至租户镜像仓库 ​

登录打开了 Docker 容器功能的开发机（开发机会默认登录您租户的镜像仓库），按照以下步骤操作：

  1. 如果要将 Docker 镜像 tar 包推送到镜像仓库，需要先加载镜像。使用 docker load 命令加载镜像：

    bash
    docker load -i <image_name>.tar

  2. 标记镜像： 镜像需要标记仓库路径（查看镜像仓库地址）和标签，请使用 docker tag：

    格式：

    bash
    # 使用 cr.infini-ai.com 拼接租户 ID 作为 <repository> 字段，该地址指向与开发机同可用区的镜像仓库
docker tag <loaded_image_name>:<version> <repository>/<image_name>:<version>

    示例：

    bash
    # 使用 cr.infini-ai.com 拼接租户 ID 作为私有镜像仓库的地址，该地址指向与开发机同可用区的镜像仓库
docker tag sd-webui:v1.1-1 cr.infini-ai.com/te-d397fngp1xye2h3q/sd-webui:v1.1-1

  3. 推送镜像： 您可以在开启 「Docker 容器」功能的开发机中，检查是否已存在镜像仓库登录凭证。如果已有登录凭证，说明无需再手动执行 docker login，即可直接使用镜像仓库。开发机内已默认登录租户私有镜像仓库。

    shell
    cat /tmp/docker-config/config.json

    推送镜像命令格式：

    bash
    docker push <repository>/<image_name>:<version>

    示例：

    bash
    docker push cr.infini-ai.com/te-d397fngp1xye2h3q/sd-webui:v1.1-1

Step 3 查看结果 ​

构建完成后，您可以访问镜像中心，在自定义镜像标签页中查看您的镜像。

镜像

注意

如果您所属租户在不同可用区均购买了资源，请注意租户在不同可用区的镜像仓库的存储网络相互隔离，暂不支持同步（但共用同一个内网地址）。例如，可用区 A 向 cr.infini-ai.com/te-b914754427352251 推送镜像，平台自动映射到可用区 A 的镜像仓库，可用区 B 无法使用该镜像。