镜像仓库使用说明

共绩算力镜像仓库（平台内置仓库）

适用场景

• 临时测试
• 小规模使用
• 快速部署验证
• 内部研发调试场景

重要说明 镜像仓库账号密码与平台用户账号密码不互通，属于独立认证体系。

---

共绩算力镜像仓库使用指南

登录镜像仓库（凭证登录）

操作流程说明

1. 打开控制台页面 https://console.suanli.cn/serverless/image
2. 点击「凭证」
3. 初始化镜像仓库
4. 按页面指引进行登录（复制命令 → 执行命令 → 输入密码）

凭证的作用说明：

• 身份验证：用于确认用户身份，防止未授权访问私有镜像仓库
• 权限控制：控制用户对镜像的拉取（pull）、推送（push）等操作权限
• 安全通信：保障客户端与仓库之间的数据安全传输

---

Windows 系统登录操作

前提条件：

已安装 Docker Desktop for Windows，并确保 Docker 服务已启动（Docker 图标为运行状态）

步骤一：打开终端 按 Win + S 搜索 PowerShell 或 CMD 右键选择“以管理员身份运行”

步骤二：执行登录命令 （从凭证页面复制命令）

docker login harborpush.suanleme.cn --username=XXX

系统提示输入密码：

Password: （输入仓库密码，输入时无回显，直接输入后回车）

登录成功提示：

Login Succeeded

常见问题处理

• docker command not found 未安装 Docker 或 Docker 未启动 解决：安装 Docker Desktop 并启动服务
• 密码错误或过期 解决：网页端点击“重置密码”后重新登录

---

Mac 系统登录操作

架构说明：

Mac 设备多为 ARM 架构，平台环境为 x86 架构，直接构建的镜像可能无法在平台环境运行，需注意架构兼容问题。

步骤一：打开终端 Command + Space → 搜索“终端” → 打开

步骤二：执行登录命令

docker login harborpush.suanleme.cn --username=XXX

输入密码后回车，成功提示：

Login Succeeded

常见问题处理

• 权限不足

sudo docker login harborpush.suanleme.cn --username=XXX

• Docker 未运行 启动 Docker Desktop for Mac，等待图标变绿

---

密码重置流程

1. 进入镜像仓库控制台
2. 点击「重置密码」
3. 通过邮箱或手机验证
4. 设置新密码
5. 重新执行 docker login

---

镜像打标（Tag）与路径绑定

为什么必须打标签

镜像标签的本质是绑定本地镜像与远程仓库路径。 只有包含完整仓库地址与账户路径的镜像，平台才能识别推送目标。

未打完整路径标签的镜像无法推送到仓库。

---

查看本地镜像

docker images

非 root 用户：

sudo docker images

示例输出：

REPOSITORY    TAG       IMAGE ID       CREATED         SIZE
my-image      latest    a1b2c3d4e5f6   2 hours ago     1.2GB

字段说明：

• REPOSITORY：镜像名称/来源路径
• TAG：版本标签
• IMAGE ID：镜像唯一标识
• CREATED：构建时间
• SIZE：镜像体积

---

添加仓库标签（路径绑定）

命令格式

docker tag <原镜像>:<原标签> harborpush.suanleme.cn/<账户>/<镜像名>:<新标签>

参数说明：

• <原镜像>:<原标签>：本地已有镜像
• <账户>：镜像仓库账号
• <镜像名>：推送后的镜像名称
• <新标签>：版本标识

---

示例操作

账号：huang5876 本地镜像：my-image:latest 目标版本：v1.0

docker tag my-image:latest harborpush.suanleme.cn/huang5876/my-image:v1.0

验证：

docker images

REPOSITORY                            TAG
my-image                              latest
harborpush.suanleme.cn/huang5876/my-image v1.0

---

标签规范建议

• 使用语义化版本：v1.0.0、v1.2.3
• 使用环境标识：dev、test、prod
• 避免使用 latest
• 支持多层级结构：

harborpush.suanleme.cn/<账户>/<项目>/<镜像>:<标签>

示例：

harborpush.suanleme.cn/huang5876/project-a/my-image:v1.0

---

镜像推送流程

docker push harborpush.suanleme.cn/<账户>/<镜像名>:<标签>

示例：

docker push harborpush.suanleme.cn/huang5876/my-image:v1.0

推送过程会显示分层上传进度，完成后可在平台镜像仓库页面查看。

---

最佳实践总结

生产环境规范

• 使用企业版 ACR
• 启用安全扫描与加签
• 启用访问控制
• 禁止使用 latest

结构规范

• 命名空间按团队
• 仓库按项目
• 标签按版本与环境

版本规范

• 语义化版本号
• 明确环境标识
• 不覆盖历史版本

运维规范

• 镜像生命周期管理
• 自动清理策略
• 分环境仓库隔离
• 权限最小化原则