本地将镜像打包推送到阿里云的镜像服务器

一、标准部署流程

1）进入项目目录

先进入有 Dockerfile 的目录：

bash 复制代码

cd /你的项目目录

先确认目录里有 Dockerfile：

bash 复制代码

ls

⸻

2）本地构建镜像

按照你提供的镜像名，先构建本地镜像：

bash 复制代码

docker build -t huoshan-asr-service:latest .

构建完成后检查一下：

bash 复制代码

docker images | grep huoshan-asr-service

如果成功，能看到类似：

bash 复制代码

huoshan-asr-service   latest   xxxxxxxxxxxx   ...

⸻

3）登录阿里云 ACR

为了避免把密码直接写进命令历史，建议用更安全的方式：

bash 复制代码

echo '你的ACR密码' | docker login --username="上海金桥亦法云平台" --password-stdin registry.cn-shanghai.aliyuncs.com

你本次实际操作时，把你的ACR密码换成你自己的密码即可。

不要再把密码明文贴到终端历史、脚本、聊天记录里。

⸻

4）给镜像打远程仓库 tag

使用你这条正确的仓库地址：

bash 复制代码

docker tag huoshan-asr-service:latest registry.cn-shanghai.aliyuncs.com/prod-huoshan-asr-service/python:v1.0.0

可以检查一下：

bash 复制代码

docker images | grep prod-huoshan-asr-service

⸻

5）推送到阿里云 ACR

注意这里也要用单横杠版本：

bash 复制代码

docker push registry.cn-shanghai.aliyuncs.com/prod-huoshan-asr-service/python:v1.0.0

⸻

二、你这次可直接执行的完整命令

把下面按顺序执行即可：

bash 复制代码

cd /你的项目目录

docker build -t huoshan-asr-service:latest .

echo '你的ACR密码' | docker login --username="上海金桥亦法云平台" --password-stdin registry.cn-shanghai.aliyuncs.com

docker tag huoshan-asr-service:latest registry.cn-shanghai.aliyuncs.com/prod-huoshan-asr-service/python:v1.0.0

docker push registry.cn-shanghai.aliyuncs.com/prod-huoshan-asr-service/python:v1.0.0

⸻

三、如果你想一条条验证

可以用这几条辅助检查：

查看本地镜像：

bash 复制代码

docker images

查看登录是否成功：

bash 复制代码

docker login --username="上海金桥亦法云平台" registry.cn-shanghai.aliyuncs.com

查看镜像是否已正确打 tag：

bash 复制代码

docker images | grep registry.cn-shanghai.aliyuncs.com/prod-huoshan-asr-service/python

⸻

四、常见报错排查

docker build 失败

通常是：

• 当前目录没有 Dockerfile

• 依赖文件没复制进去

• 基础镜像拉取失败

• 项目启动命令写错

docker login 失败

通常是：

• 用户名错误

• 密码错误

• 仓库地址错误

• 网络到 registry.cn-shanghai.aliyuncs.com 不通

docker push 失败

通常是：

• tag 的仓库地址和实际 ACR 仓库不一致

• 命名空间或仓库名写错

• 没登录成功

• 没有该仓库的推送权限

denied: requested access to the resource is denied

说明通常是：

• 仓库路径写错

• 命名空间写错

• 当前账号没有 push 权限

⸻

五、更推荐的版本号写法

你现在用的是：

v1.0.0

可以用，但更实用一点的方式是：

bash 复制代码

v1.0.0
v1.0.1
20260317-01
20260317-commitsha

例如：

bash 复制代码

docker tag huoshan-asr-service:latest registry.cn-shanghai.aliyuncs.com/prod-huoshan-asr-service/python:20260317-01
docker push registry.cn-shanghai.aliyuncs.com/prod-huoshan-asr-service/python:20260317-01