当前位置：首页 > news >正文

Docker镜像推送到私有仓库完整指南：从命名规范到AWS ECR实战

news 2026/6/7 12:44:04

镜像构建好了，放在本地只有自己能看见。团队其他人怎么用？部署服务器怎么拉？

你需要一个私有镜像仓库。

今天这篇文章，我们用AWS ECR（Elastic Container Registry）做例子，从创建仓库到推送镜像，把整个流程走一遍。你在任何私有仓库（Nexus、阿里云ACR、华为云SWR）上的操作，原理都是一样的。

一、先搞懂Docker镜像的完整名字

平时我们拉镜像，写的是：

bash

docker pull mongo:4.2

其实这只是简写。完整的名字是：

text

docker.io/library/mongo:4.2

docker.io：仓库地址（Docker Hub）
library/mongo：镜像名
4.2：版本标签

因为Docker默认仓库是Docker Hub，所以可以省略。

私有仓库没有默认值，必须写完整的地址。

二、在AWS ECR创建仓库

AWS ECR的规则比较特殊：一个镜像对应一个仓库。同一个仓库里存的是这个镜像的不同版本（不同标签）。

登录AWS控制台，进入ECR服务，点击“创建仓库”，输入仓库名（比如my-app），其他默认，创建完成。

创建后仓库是空的。

三、推送镜像三步走

第一步：登录

AWS会给你生成一条登录命令，复制执行即可：

bash

aws ecr get-login-password --region us-east-1 | docker login --username AWS --password-stdin <你的AWS账号ID>.dkr.ecr.us-east-1.amazonaws.com

这条命令的本质就是docker login，只是AWS帮你封装好了。

前提：本地已经安装并配置好AWS CLI。

第二步：给本地镜像打标签

本地镜像的名字是my-app:1.0，直接push会推送到Docker Hub。必须改成ECR的完整地址。

bash

docker tag my-app:1.0 <你的AWS账号ID>.dkr.ecr.us-east-1.amazonaws.com/my-app:1.0

docker tag的作用是给镜像创建一个新名字（新标签），指向同一个镜像。不会复制文件，不占额外空间。

第三步：推送

bash

docker push <你的AWS账号ID>.dkr.ecr.us-east-1.amazonaws.com/my-app:1.0

推送时Docker会分层上传，已经存在于仓库的层不会重复上传。

刷新ECR页面，就能看到刚刚推送的镜像了。

四、推送新版本

代码改了，重新构建镜像，换个版本号：

bash

# 构建新版本 docker build -t my-app:1.1 . # 打标签（同一个仓库，换版本号） docker tag my-app:1.1 <AWS账号ID>.dkr.ecr.us-east-1.amazonaws.com/my-app:1.1 # 推送 docker push <AWS账号ID>.dkr.ecr.us-east-1.amazonaws.com/my-app:1.1

同一个仓库里会出现两个版本。ECR单个仓库最多支持1000个版本。