应用打包成容器镜像后,需要有地方存放镜像,并让开发、测试或部署环境能够访问。阿里云容器镜像服务 ACR 可以创建镜像仓库,再配合 Docker 完成登录、推送和拉取。实际操作时,容易出错的地方通常是仓库地址、镜像标签和账号权限;这几项核对清楚,推送流程就比较直接。
创建前先确认这些信息
在阿里云创建镜像仓库时,会接触到实例、命名空间和仓库。实例是镜像服务的管理入口;命名空间用于按团队或项目归类;仓库用来存放某个应用的镜像版本。一个仓库可以有多个标签,例如 v1.0.0 或 2025-03-01,分别对应不同版本。
操作前准备好阿里云账号、本地 Docker 环境和要推送的镜像,并确认账号有管理镜像服务资源的权限。也要先选好地域:通常优先考虑与运行环境相同的地域,或网络连接合适的地域,减少跨地域传输带来的延迟和流量成本。
阿里云创建镜像仓库的步骤
进入容器镜像服务 ACR
登录阿里云控制台,搜索“容器镜像服务 ACR”并进入。控制台菜单可能随产品版本调整,可以从实例列表或镜像仓库相关页面开始。首次使用时,按页面提示开通服务、选择地域,并创建或进入对应实例。
不同实例类型提供的功能和计费方式可能不同。个人测试和企业生产环境的需求不一样,创建前应查看控制台当前展示的功能与费用信息,按实际用途选择。
创建命名空间和仓库
进入实例后,在命名空间管理入口创建一个便于识别的名称,例如团队名或项目名。名称尽量简短、稳定,方便成员协作。多人使用时,可以提前约定命名方式,比如按团队划分,或统一采用“业务线-项目”的格式;命名含糊,后续查仓库和排查镜像来源都会更费时间。
接着进入仓库管理页面创建仓库,填写仓库名称、摘要等信息,并选择代码源或仓库类型。如果准备在本地构建后手动推送,通常选择本地仓库一类的方式即可;如果需要代码提交后自动构建,还要按页面要求配置代码源和构建流程。
仓库访问属性也要按用途设置。私有仓库需要身份认证,适合内部应用和未公开的业务镜像;公开仓库便于他人直接获取,但镜像内容也可能被未授权用户访问。生产环境通常应优先考虑私有仓库,再按需要配置账号权限或访问凭证。确认信息后提交创建。
用 Docker 构建并推送镜像
创建完成后,打开仓库详情,查看控制台给出的访问地址、地域信息和推荐命令。不同实例或地域对应的地址可能不同,执行时要使用自己控制台显示的地址,不能直接套用其他项目的示例。
进入项目目录,先构建本地镜像:
docker build -t web-demo:v1.0.0 .
然后使用仓库访问地址登录。认证时应使用阿里云支持的账号或访问凭证:
docker login <仓库访问地址>
本地镜像名称还需要改成包含仓库地址、命名空间和仓库名的完整标签,之后才能推送:
docker tag web-demo:v1.0.0 <仓库访问地址>/<命名空间>/<仓库名>:v1.0.0
docker push <仓库访问地址>/<命名空间>/<仓库名>:v1.0.0
例如,本地镜像是 web-demo:v1.0.0,命名空间是 team-a,仓库名是 web-demo。把命令中的占位内容替换成控制台提供的实际地址和名称后再执行。推送完成,回到仓库页面检查标签、更新时间和镜像大小,确认上传的是预期版本。
小团队发布网站服务的做法
假设一个小团队要发布内部网站,开发人员在本地构建镜像,测试环境和生产环境都从阿里云拉取。团队可以创建 team-a 命名空间和私有仓库 web-demo,每次发布时用版本号标记镜像,例如 v1.2.0,再构建并推送。
测试环境先拉取指定版本验证,确认无误后,生产环境部署同一版本。比起只使用 latest,明确的版本号更容易追踪变更,出现问题时也便于定位镜像。权限可以按工作需要分配:开发人员负责推送,部署环境使用受控凭证拉取,避免所有成员共用一个长期有效的高权限账号。
推送失败时检查什么
- 登录成功但推送失败:检查镜像完整地址、地域、命名空间和仓库名称,并确认当前账号具有推送权限。
- 仓库页面看不到镜像:确认
docker push已执行成功,再核对查看的地域和仓库是否与推送目标一致。 - 拉取时提示未授权:私有仓库需要有效凭证;运行环境也要有访问仓库的网络条件和相应权限。
- 凭证写进代码或构建文件:不要把密码或长期有效的密钥提交到代码仓库,也不要放进公开文档。使用受控凭证,并定期检查和更新。
- 版本标签不清楚:正式发布尽量使用明确的版本号或提交标识,别只依赖 latest,否则回滚和追溯时不容易确认镜像内容。
完成阿里云创建镜像仓库后,按控制台地址登录,给本地镜像添加完整标签并推送,最后检查仓库中的版本是否正确,就建立了基本的镜像管理流程。后续需要自动构建或接入容器集群时,再根据现有开发和发布流程补充相应配置。