容器服务
>
镜像管理
镜像管理
概述
镜像管理提供创建镜像、版本管理、跨区域同步、导出、分享等功能，支持从 AI 社区、外部仓库、镜像包、Dockerfile 等多种方式构建个人镜像，并在 Notebook、容器实例、模型部署等场景中使用。
一、访问与导航
1.1 登录
使用 SCNet 账号登录控制台。登录地址示例：http://10.0.31.196/ui/login/index.html（以实际部署为准）。
1.2 进入镜像管理
- 登录后进入 控制台。
- 左侧选择 容器服务。
- 展开 镜像管理，点击 我的镜像。
镜像管理相关菜单：
- 我的镜像：管理个人镜像及版本。
- 镜像仓库：提示能力已迁移至 AI 社区，可点击「前往浏览体验」；建议及时迁出或分享原镜像，旧版入口 2026 年 2 月 28 日后停用。
二、镜像来源
「我的镜像」中的镜像主要有以下来源：
| 来源 | 说明 | 创建方式 |
|---|---|---|
| 构建外部镜像 | 从 AI 社区、外部仓库、镜像包或 Dockerfile 导入 | 创建镜像 / 新增版本 |
| 平台内保存 | 运行中容器保存为镜像 | Notebook、推理服务、容器实例中的「保存镜像」 |
| AI 社区克隆 | 从社区镜像库克隆到本区域 | AI 社区 → 克隆到我的镜像 |
2.1 构建平台外部已有镜像
- 进入 我的镜像，点击 创建镜像。
- 填写 基本信息（镜像名称、镜像简介、适配加速卡）与 版本信息（使用区域、版本名称、版本描述、镜像来源等）。
- 点击 创建，在 镜像详情 的 版本 页签中查看构建进度与结果。
页面顶部提示：为保障您上传的镜像可在平台内使用，请按照 构建镜像规则 创建镜像。
2.2 通过平台其他功能模块保存镜像
在平台内，以下模块可将运行中的容器保存为「我的镜像」：
| 模块 | 操作路径 |
|---|---|
| Notebook | 列表页 → 运行中任务 → 更多 → 保存镜像 |
| 模型部署 / 推理服务 | 运行中服务 → 详情 → 实例列表 → 保存镜像 |
| 容器实例 | 运行中实例 → 详情 → 实例列表 → 保存镜像 |
保存时需填写镜像名称、版本名称、使用区域等信息；完成后在 我的镜像 列表中可见。
保存镜像期间，部分场景会限制关机，请待保存完成后再操作。
2.3 从 AI 社区获取镜像
- 进入 AI 社区，选择目标镜像。
- 使用 克隆到我的镜像 或创建镜像时选择 镜像来源 → AI 社区。
- 在 镜像详情 中查看版本在各 使用区域 的同步状态。
三、我的镜像列表
3.1 列表说明
我的镜像 以表格展示，列包括：
| 列名 | 说明 |
|---|---|
| 镜像名称 | 点击可进入 镜像详情 |
| 最新版本 | 该镜像下最近一次更新的版本 tag |
| 适配加速卡 | GPU / 异构加速卡 / 不使用加速卡 |
| 创建时间 / 更新时间 | 镜像创建与最近更新时间 |
| 操作 | 行级操作（如编辑、删除等，以页面实际按钮为准） |
3.2 筛选与搜索
- 适配加速卡：下拉筛选「全部加速卡」「GPU」「异构加速卡」「不使用加速卡」。
- 按镜像名称搜索：输入镜像名称关键字检索。
- 分页：支持 10～100 条/页及页码跳转。
3.3 创建镜像
点击 创建镜像 进入创建页（#/image-management/create）。
基本信息：
| 字段 | 说明 |
|---|---|
| 镜像名称 | 必填。支持 60 位小写字母、数字、点、中划线、下划线；不能以点、中划线开头或结束。创建后不可修改。 |
| 镜像简介 | 选填，最多 300 字。 |
| 适配加速卡 | 必填。可选 GPU、异构加速卡、不使用加速卡（创建后不可修改）。 |
版本信息：
| 字段 | 说明 |
|---|---|
| 使用区域 | 必填。选择加速卡类型匹配的区域；不同区域支持的加速卡类型可能不同（页面会提示，如「当前区域支持加速卡类型：异构加速卡、不使用加速卡」）。 |
| 版本名称 | 必填。支持 60 位字母、数字、点、中划线、下划线；不能以点、中划线开头。示例：latest、v1.0.0。 |
| 版本描述 | 选填，最多 300 字。 |
镜像来源（四选一）：
| 方式 | 说明 |
|---|---|
| AI 社区 | 从社区导入各类镜像（应用镜像、官方基础运行环境等）。可点击「去社区」浏览；需选择 社区镜像。 |
| 外部仓库 | 填写 docker pull 命令，平台拉取公开仓库镜像（不支持私有仓库）。 |
| 镜像包 | 将 .tar / .tar.gz 上传至 文件管理 后选择路径构建。 |
| Dockerfile | 使用 Dockerfile 构建；COPY/ADD 依赖文件请放在用户家目录 dockerFileTemp 下。 |
SSH 服务：
- 选择 已安装 或 未安装。
- 提示：请确保镜像已安装 SSH 登录组件，否则可能无法使用。
开发工具：
- 点击 添加，选择工具（Jupyter、VS Code、RStudio）并填写 软件路径。
- 提示：平台无法主动安装，请确保镜像内已有对应工具，否则构建失败。
环境与标签（选填，便于筛选与展示）：
| 字段 | 说明 |
|---|---|
| 框架 / 版本 | 如 PyTorch、TensorFlow、vLLM 等 |
| Python 版本 | 如 py3.10、py3.11 |
| CUDA 版本 | GPU 场景；国产卡可选用 dtk 等版本 |
| 操作系统 / 版本 | 如 Ubuntu 22.04 |
推荐配置（开关）：
- 为用户推荐保障镜像运行的最优配置。
- 可配置：加速卡型号、最小显存、最小卡数。
部署服务（开关）：
- 开启后，该镜像支持一键部署；需完善启动命令、端口、环境变量等参数。
填写完成后点击 创建；点击 取消 返回列表。
四、镜像详情与版本管理
4.1 进入详情
在 我的镜像 列表中点击 镜像名称，进入 镜像详情（#/image-management/detail/{镜像ID}）。
基础信息区域展示：
- 镜像名称
- 适配加速卡
- 创建时间
- 镜像简介
4.2 页签说明
| 页签 | 说明 |
|---|---|
| 版本 | 管理该镜像下所有版本（默认页签） |
| 镜像介绍 | 编辑镜像的详细说明文档（富文本/Markdown，以页面为准） |
4.3 版本列表
每个版本以卡片形式展示，包含：
- 版本名称（tag）与更新时间
- 版本描述（暂无描述时显示占位文案）
- 框架、Python 版本、操作系统、开发工具、镜像大小
- 使用区域：已同步区域（如「华北二区197【北京】」及完成状态）
- 跨区域同步：将版本同步到其他区域
版本卡片操作菜单（右上角「…」）：
| 操作 | 说明 |
|---|---|
| 编辑 | 修改版本描述、环境标签、开发工具、部署服务等 |
| 导出 | 导出为 tar 包至文件管理指定路径 |
| 分享 | 共享给平台所有人或指定团队 |
| 删除 | 删除该版本（谨慎操作） |
4.4 新增版本
- 在 镜像详情 → 版本 页签点击 新增版本。
- 进入 添加版本 页（
#/image-management/create?imageId=...）。 - 镜像名称、镜像简介、适配加速卡 为只读（继承镜像级配置）。
- 填写 使用区域、版本名称、版本描述、镜像来源 等，与「创建镜像」中版本信息一致。
- 点击 确认 提交构建。
4.5 跨区域同步
- 在目标版本卡片上点击 跨区域同步。
- 选择需要同步到的 目标区域。
- 等待同步完成；可在版本卡片 使用区域 处查看各区域状态。
- 同步失败时可按页面提示 重试（以实际按钮为准）。
五、镜像管理功能汇总
| 功能 | 入口 | 说明 |
|---|---|---|
| 创建镜像 | 我的镜像 → 创建镜像 | 新建镜像及首个版本 |
| 新增版本 | 镜像详情 → 新增版本 | 为已有镜像增加新版本 |
| 编辑 | 版本卡片 → 编辑 | 修改版本元数据、IDE、部署配置等 |
| 导出 | 版本卡片 → 导出 | 导出 tar 至文件管理 |
| 分享 | 版本卡片 → 分享 | 共享给所有人或指定团队 |
| 跨区域同步 | 版本卡片 → 跨区域同步 | 将版本同步到其他区域 |
| 删除 | 版本卡片 → 删除 | 删除版本；删除镜像需在列表或详情中操作 |
| 镜像介绍 | 镜像详情 → 镜像介绍 | 维护镜像说明文档 |
六、镜像使用
6.1 使用前检查
构建或同步成功后，在版本卡片上确认：
- 适配加速卡 与任务资源类型一致
- 开发工具 已配置且路径正确（Notebook / 容器实例按开发工具筛选镜像）
- 使用区域 包含当前任务所在区域
若 IDE 未识别或镜像不可选：
- 参照 构建镜像规则 检查 SSH、SUDO、IDE 安装与启动路径。
- 通过 编辑 更新开发工具信息，或 新增版本 重新构建。
6.2 在 Notebook 中使用
路径：控制台 → 人工智能 → Notebook → 创建 Notebook
- 在 开发镜像 中选择「我的镜像」。
- 列表按所选 开发工具（Jupyter 等）过滤；仅展示已配置且可用的版本。
6.3 在容器实例中使用
路径：控制台 → 容器服务 → 容器实例 → 创建容器
- 在 开发镜像 中选择镜像；选项随 开发工具（Jupyter / VS Code / RStudio）变化。
6.4 在模型部署中使用
- 选择已开启 部署服务 并配置启动参数的镜像版本。
- 可参考版本上的 推荐配置 选择加速卡规格。
七、构建镜像规则（摘要）
详细步骤见官方文档：构建镜像规则。
要点：
- SSH / SUDO：通过 SSH 登录容器时需预装；平台构建时会尝试封装，部分 OS 版本建议采用镜像包方式自行安装。
- 开发工具路径（实例启动时会扫描）：
- Jupyter：
/opt/conda/bin/jupyter - VS Code：
/usr/lib/code-server/bin/code-server - RStudio：
/usr/lib/rstudio-server/bin/rserver
- Jupyter：
- 镜像包：需先
docker load/docker pull→ 安装组件 →docker commit→docker save为 tar 上传。 - 外部仓库：格式
docker pull <name>[:tag]；Docker Hub 可能限流，建议本地打 tar 包上传。 - Dockerfile：依赖文件路径示例
/public/home/${username}/dockerFileTemp。
八、常见问题
Q：创建镜像时「适配加速卡」选错了怎么办？
A：适配加速卡在镜像创建后不可修改，需新建镜像并重新选择。
Q：镜像名称写错了怎么办？
A：镜像名称创建后不可修改，需新建镜像。
Q：为什么在 Notebook 里看不到我的镜像？
A：检查版本是否配置对应 开发工具 及路径、使用区域 是否包含任务区域、构建是否 已完成。
Q：镜像仓库菜单还能用吗？
A：能力已迁移至 AI 社区；控制台「镜像仓库」为迁移提示页，旧入口 2026 年 2 月 28 日 后停用，请及时迁出或分享原镜像。
Q：异构加速卡镜像如何选？
A：创建时选择 异构加速卡，并优先使用 DTK 等相关基础镜像；CUDA 版本字段在 GPU 场景下使用。