本地 Docker 镜像适合开发和测试。需要让同事、服务器或自动化流水线使用时,就要把镜像推送到仓库。阿里云用户通常可以选择容器镜像服务 ACR:先创建命名空间和仓库,再为本地镜像打标签、登录并推送,部署端便能按版本拉取。
下面用一个 Web 应用举例说明完整流程。命令中的仓库地址、命名空间和凭证都需要按阿里云控制台的实际配置替换。
先分清镜像仓库和镜像加速器
镜像仓库负责保存和分发镜像。开发者把构建好的镜像推送到仓库,获得授权的用户或服务器再拉取。阿里云容器镜像服务提供仓库、命名空间和访问控制等功能,可用于个人项目、团队协作和部署流程。产品功能、控制台入口及计费方式可能调整,实际操作时应以阿里云控制台当前说明为准。
镜像加速器的用途不同:它帮助 Docker 访问镜像源,不负责保存你自己的应用镜像。要把业务镜像交给团队或部署服务器使用,需要配置 ACR 仓库地址、命名空间和访问凭证;单独设置加速器并不能完成发布。
创建仓库前准备好这些信息
- 实例和地域:在阿里云控制台进入容器镜像服务,根据使用场景选择实例和地域。个人试用与团队生产环境的配置要求可能不同。
- 命名空间:用于归类镜像,可以使用团队名或项目名。通常需要先创建命名空间,再创建仓库。
- 仓库名称:使用清楚、稳定的英文名称,例如
web-demo,避免使用含义不明的临时名称。 - 访问凭证:推送和拉取私有镜像都需要授权。不要把密码写进代码、镜像或公开文档。
仓库的完整地址应以控制台显示为准。地域、实例类型和访问方式不同,使用的地址也可能不同,因此不要直接复制网上示例里的域名。下文用 <仓库地址>、<命名空间> 等占位符表示需要替换的内容。
将本地 Web 镜像推送到阿里云
假设项目目录中已经准备好 Dockerfile,应用名为 web-demo。在项目目录运行构建命令:
docker build -t web-demo:1.0 .
构建完成后,用 docker images 确认本地镜像已生成。接着为镜像添加仓库地址、命名空间和版本标签,完整名称通常采用“仓库地址/命名空间/仓库名:标签”的格式:
docker tag web-demo:1.0 <仓库地址>/<命名空间>/web-demo:1.0
版本标签要能帮助团队辨认镜像。只用 latest 容易覆盖之前的版本,出现问题时也不方便确认部署内容。像 1.0、提交号或日期这样的标签更容易追溯,适合协作和回滚。
登录仓库:
docker login <仓库地址>
根据提示输入控制台配置或授权后生成的用户名和密码。确认登录成功后,推送镜像:
docker push <仓库地址>/<命名空间>/web-demo:1.0
推送后,到控制台对应的命名空间和仓库中检查镜像版本。如果操作失败,先逐项核对仓库地址、命名空间、仓库名和标签,再确认当前账号是否有推送权限。
在部署服务器上拉取并运行
部署服务器需要能够访问仓库。私有仓库还需要先登录,再拉取指定版本:
docker login <仓库地址>
docker pull <仓库地址>/<命名空间>/web-demo:1.0
拉取成功后,可以根据应用配置启动容器。以下端口映射仅作示例:
docker run -d --name web-demo -p 8080:80 <仓库地址>/<命名空间>/web-demo:1.0
8080:80 表示将服务器的 8080 端口映射到容器的 80 端口。使用前要确认应用实际监听的端口,并检查服务器防火墙和网络策略。生产环境还需配置环境变量、持久化存储、健康检查和日志;镜像能够拉取,并不代表服务已具备上线条件。
常见问题怎么排查
登录失败
登录命令中填写的是控制台提供的仓库地址,不是控制台网页链接。还要检查凭证是否过期、输入时有没有多余空格,以及账号是否有对应实例或仓库的访问权限。有些环境要求使用专门的访问凭证,不要默认尝试日常登录密码。
推送提示无权限或仓库不存在
检查镜像标签里的仓库地址、命名空间和仓库名是否与控制台完全一致,并确认目标仓库已经创建。若账号没有推送权限,也会导致失败。镜像名称写错时,Docker 可能会向非预期的地址推送,因此不要只看命令是否执行过,还要核对控制台中的镜像记录。
服务器拉取超时
检查服务器是否能访问仓库所在地域的地址,再排查 DNS、网络出口和防火墙规则。跨地域或跨网络访问可能影响连通性和速度,可结合部署区域选择合适的仓库和网络方案。
安全发布与日常维护
- 区分开发、测试和生产环境的仓库或标签,发布前核对目标环境,避免误用版本。
- 按最小权限原则分配访问权限。CI/CD 流水线使用专用凭证,不与个人账号共用。
- 不要把登录密码写入 Dockerfile、Git 仓库或构建日志;自动化发布应使用安全的凭证管理功能。
- 定期清理不再使用的镜像版本,同时按团队要求保留发布记录和可用于回滚的版本。
- 生产部署固定使用明确的版本标签。对安全要求较高的场景,还应配合漏洞扫描和发布审批流程。
Docker 阿里云仓库的操作流程可以概括为:创建命名空间和仓库,构建并标记镜像,登录后推送,再由部署端拉取同一版本。开始接入时,不妨先用一个小应用跑通从本地构建到服务器运行的整条链路,再配置团队权限和自动化发布。仓库地址、权限、版本标签和凭证管理都检查到位,后续部署会更容易排错和回滚。